Основы работы с composer’ом

Composer — это менеджер зависимостей для PHP. Он предназначен для автоматического управления сторонними библиотеками вашего приложения. Это означает, что все операции по загрузке, удалению и проверке совместимости указанных вами библиотек выполняются им самостоятельно. Со стороны разработчика требуется только указать какие библиотеки необходимо скачать в файле composer.json и ввести команду обновления пакетов.

Установка

Перейдите в корневую директорию:

cd ~

Скачайте установщик composer’a:

curl -sS https://getcomposer.org/installer -o composer-setup.php

Для проверки корректности установщика зайдите на страницу Composer Public Keys / Checksums и скопируйте оттуда ключ «Installer Checksum (SHA-384)» в переменную HASH.

HASH=СКОПИРОВАННЫЙ_КЛЮЧ

После копирования ключа необходимо осуществить его проверку:

php -r "if (hash_file('SHA384', 'composer-setup.php') === '$HASH') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"

Если установщик корректен, то его можно использовать без опасений. Для глобальной установки достаточно выполнить команду:

sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer

Для локальной установки укажите свою директорию в параметре «install-dir». На этом установка закончена. Теперь при вызове Composer’a будет появляться приветственный экран. Файл-установщик composer’a больше не нужен и его можно удалить:

php -r "unlink ('composer-setup.php');"

Не забывайте время от времени обновлять Composer командой «composer self-update».

Использование

Создание файла конфигурации:

composer init

Добавление пакетов в composer.json:

composer require
composer require "vendor/package:2.*"
composer require "vendor/package:2.*" vendor/package2:dev-master

Удаление пакетов из composer.json:

composer remove vendor/package
composer remove vendor/package vendor/package2

Установка всех пакетов:

composer install

Composer установит все библиотеки из composer.json в директорию vendor. Если в проекте существует файл composer.lock, то версии для установки будут взяты из него.

Обновление всех пакетов:

composer update

Composer установит самые новые доступные и совместимые с другими версии библиотек, после чего запишет их версии в composer.lock. Файл composer.lock желательно сохранять для всех участников команды разработки, т.е. записывать в git для поддержания однородности окружения.

Обновление отдельных пакетов:

composer update vendor/package:2.0.1
composer update vendor/package1:2.0.1 vendor/package2:3.0.*

Список возможных настроек:

composer config --list

Очистка кеша пакетов:

composer clear-cache

Вывод всех установленных пакетов:

composer show

Обновление автозагрузчика:

composer dump-autoload

Полезные ссылки

• GetComposer.org
• Packagist.org
• GetComposer.org/doc/03-cli.md