Rivalry2

HTML Diff

0 added 0 removed

Original 2026-01-01

Modified 2026-02-26

1 Подавляющее большинство библиотек и проектов существуют не сами по себе. Типовые задачи имеют какие-то общие решения и вынесены в отдельные пакеты (какими-то разработчиками). Благодаря этим пакетам, разработчики экономят время, не делая то, что уже сделано до них. Подобных общих решений сотни тысяч. Вот лишь некоторые примеры:

2 <ul><li>Библиотеки для выполнения HTTP-запросов</li>

3 <li>Библиотеки для парсинга различных форматов - например, XML, JSON, YAML.</li>

4 <li>Библиотеки обработки URL, которые позволяют извлекать из них части и собирать обратно</li>

5 <li>Фейкеры - библиотеки для генерации адресов, имен и других случайных данных</li>

6 <li>Тестовые фреймворки. С их помощью код тестируется в автоматическом режиме (они используются во всех практиках на Хекслете)</li>

7 </ul>Любые из этих пакетов можно установить к себе в проект, используя Composer. Это одно из его главных предназначений.

8 Предположим, что наш пакет зависит от библиотеки<a>illuminate/collections</a>. Эту библиотеку мы будем активно использовать в наших курсах позже.

9 Разберем процесс установки. Для начала нужно понять, под каким именем существует наша библиотека в Packagist. Здесь может быть два варианта:

10 <ul><li>Либо мы уже знаем имя, как в случаеilluminate/collections</li>

11 <li>Либо мы нашли библиотеку на GitHub и хотим выяснить ее имя</li>

12 </ul>Часто имя можно извлечь из строки установки, которая есть в файлеREADME.md:

13 Если ее нет, вы всегда можете узнать имя, открыв файлcomposer.jsonна GitHub и прочитав значение свойстваname:

14 Когда имя найдено, можно приступать к установке пакета. Для этого нужно перейти в директорию с нашим проектом и запустить там следующую команду:

15 Эта команда не только устанавливает зависимость в текущий проект, но и автоматически добавляет его в секциюrequireфайлаcomposer.json. Такая установка является локальной - в команде нет словаglobal. Другими словами, пакет ставится именно в текущий проект. Секцияrequireтеперь выглядит примерно так:

16 Кроме того, Composer создаст файлcomposer.lockв корне проекта. Этот файл должен храниться в репозитории, а его значение мы изучим в следующем уроке.

17 Со временем все больше пакетов добавляется в текущий проект, и размер секцииrequireстановится все больше. В крупных проектах это могут быть сотни зависимостей. Посмотрим на пример, взятый из<a>php-package</a>:

18 У вас может возникнуть вопрос: "А куда помещается код этих пакетов?". Код пакетов, установленных локально, сохраняется в директорииvendor, которую Composer автоматически создает во время установки пакетов. Эта директория находится в корне проекта:

19 Эта директория считается служебной, и программист никогда не работает с ней напрямую. Более того, она должна быть добавлена в.gitignore, потому что нет смысла хранить ее в репозитории. Composer создает ее самостоятельно.

20 Обычные зависимости нужны для работы пакета. Кроме них, существуют еще и специальные зависимости, необходимые только во время разработки. Такое разделение понадобилось в целях оптимизации.

21 Практически любой пакет во время разработки использует тестовый фреймворк, который нужен только для тестирования, а не для работы самого пакета. Поэтому нет смысла тащить его с собой в рабочее окружение. Это негативно влияет на размер пакета и на скорость его загрузки. Такие зависимости устанавливаются с помощью дополнительной опции--dev:

22 В файлеcomposer.jsonони появляются внутри секцииrequire-dev:

23 Теперь самое интересное - как использовать установленные зависимости? В первую очередь, нужно смотреть документацию конкретной библиотеки на GitHub. Обычно там есть примеры или ссылка на описание. Например, в следующих уроках мы будем пользоваться библиотекой<a>illuminate/collections</a>. Она содержит десятки полезных функций для работы со строками. Изучим пример вызова:

24 <h2>Установка с нуля</h2>

25 После того как в проект устанавливаются зависимости, измененные файлы заливаются на GitHub. К ним относится какcomposer.jsonс добавленными в него описаниями зависимостей, так и файлы с исходным кодом, где эти зависимости используются. А вот директорияvendorостается на локальной машине.

26 Представьте, что с вами работает другой разработчик, который клонирует репозиторий и пытается запустить проект локально. Что произойдет? Запуск кода завершится с ошибкой. В проекте используются внешние библиотеки, но их физически нет. Директорияvendorне создана.

27 Чтобы исправить это, сразу после клонирования нужно выполнить установку зависимостей. Для этого в Composer есть еще одна команда -install:

28 Установка пакетов - это<a>идемпотентная</a>операция, ее можно запускать сколько угодно раз без риска что-либо поломать.

29 Теперь самое интересное, как собственно использовать установленные зависимости? Ответ, как обычно находится в документации репозитория на гитхабе того пакета, который вы хотите использовать.

30 Создайте в корне вашего проекта папку src, а внутри нее файл Runner.php. Добавьте следующий код:

31 К сожалению, на текущем этапе, код указанный выше, упадет в любом случае. Для его работы необходимо настроить автозагрузку, но об этом в следующем уроке.

32 Eсли вы склонировали репозиторий с гитхаба, папка vendor будет отсутствовать как и пакеты в ней. Первое, что нужно будет сделать, выполнить команду composer install. Установка пакетов - идемпотентная операция, ее можно запускать сколько угодно раз и все будет хорошо.