Composer — это инструмент управления зависимостями для PHP, используемый для управления библиотеками, необходимыми проекту, и их версиями.
Composer определяет зависимости через файл composer.json и автоматически обрабатывает установку и обновления.
По умолчанию Composer не устанавливается глобально, а устанавливается в определённый каталог данного проекта (например, vendor).
Composer требует PHP 5.3.2+ или более поздней версии, и openssl должен быть включён.
Composer может работать на платформах Windows, Linux и OSX.

Основные возможности
Управление зависимостями: Автоматическая установка и управление библиотеками, необходимыми проекту.
Автозагрузка: Генерация файлов автозагрузки для упрощения загрузки классов.
Управление версиями: Поддерживает семантическое версионирование для обеспечения совместимости зависимых библиотек.
Поддержка скриптов: Позволяет запускать пользовательские скрипты при определённых событиях (например, установка или обновление).
Composer генерирует файл vendor/autoload.php. Просто подключите его в проекте, чтобы автоматически загружать классы:
require 'vendor/autoload.php';
Установка Composer
Платформа Windows
В Windows нам просто нужно скачатьComposer-Setup.exeи затем установить его шаг за шагом.
Обратите внимание, что нужно включить конфигурацию openssl. Откройте php.ini в каталоге php, иextension=php_openssl.dllПросто удалите точку с запятой перед ним.

После успешной установки мы можем ввести следующую команду в командной строке (cmd):composer --versionчтобы проверить, успешно ли прошла установка:

Далее мы можем переключиться на полное зеркало Alibaba Cloud Composer:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
Отмена конфигурации:
composer config -g --unset repos.packagist
Конфигурация проекта
Изменяет только конфигурацию текущего проекта; только текущий проект может использовать этот адрес зеркала:
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
Отмена конфигурации:
composer config --unset repos.packagist
Отладка
Добавление -vvv к команде composer выводит подробную информацию. Команда выглядит так:
composer -vvv require alibabacloud/sdk
Возникли проблемы?
1. Рекомендуется сначала обновить версию Composer до последней:
composer self-update
2. Запустите диагностическую команду:
composer diagnose
3. Очистите кэш:
composer clear
4. Если проект ранее был установлен из других источников, необходимо обновить файл composer.lock, выполнив команду:
composer update --lock
5. Повторите попытку ещё раз
Платформа Linux
В Linux можно использовать следующие команды для установки:
# php -r "copy('https://install.phpcomposer.com/installer', 'composer-setup.php');"
# php composer-setup.php
All settings correct for using Composer
Downloading...
Composer (version 1.6.5) successfully installed to: /root/composer.phar
Use it: php composer.phar
Переместите composer.phar так, чтобы composer можно было вызывать глобально:
# mv composer.phar /usr/local/bin/composer
Переключитесь на отечественное зеркало:
# composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
Обновите composer:
# composer selfupdate
Система Mac OS
В Mac OS можно использовать следующие команды для установки:
$ curl -sS https://getcomposer.org/installer | php $ sudo mv composer.phar /usr/local/bin/composer $ composer --version Composer version 1.7.2 2018-08-16 16:57:12
Переключитесь на отечественное зеркало:
$ composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
Обновите composer:
$ composer selfupdate
Использование Composer
Чтобы использовать Composer, сначала нужно создать файл composer.json в каталоге проекта. Этот файл описывает зависимости проекта.
Формат файла следующий:
{
"require": {
"monolog/monolog": "1.2.*"
}
}
Приведённый выше файл указывает, что нам нужно загрузить любую версию monolog, начиная с 1.2.
Далее просто выполните следующую команду, чтобы установить пакеты зависимостей:
composer install
команда require
Помимо использования команды install, мы также можем использовать команду require, чтобы быстро установить зависимость, не добавляя вручную информацию о зависимости в composer.json:
$ composer require monolog/monolog
Composer сначала подберёт подходящую версию, затем обновит файл composer.json, добавит соответствующую информацию о пакете monolog/monolog в раздел require, скачает и установит связанные зависимости, и наконец обновит файл composer.lock и сгенерирует файл автозагрузки PHP.
команда update
Команда update используется для обновления всех пакетов в проекте или отдельных пакетов:
# 更新所有依赖 $ composer update # 更新指定的包 $ composer update monolog/monolog # 更新指定的多个包 $ composer update monolog/monolog symfony/dependency-injection # 还可以通过通配符匹配包 $ composer update monolog/monolog symfony/*
Обратите внимание, что версии, до которых можно обновить пакет, ограничены ограничениями версий; пакет не будет обновлён за пределы диапазона, разрешённого ограничениями. Например, если ограничение версии для пакета в composer.json — ^1.10, а последняя версия — 2.0, то команда update не может обновить пакет до 2.0; она может обновить только до версии 1.x. Об ограничениях версий см. введение далее.
команда remove
Команда remove используется для удаления пакета и его зависимостей (при условии, что зависимости не используются другими пакетами). Если зависимость используется другим пакетом, её нельзя удалить:
$ composer remove monolog/monolog Loading composer repositories with package information Updating dependencies (including require-dev) Package operations: 0 installs, 0 updates, 2 removals - Removing psr/log (1.0.2) - Removing monolog/monolog (1.23.0) Generating autoload files
команда search
Команда search позволяет искать пакеты:
$ composer search monolog
Эта команда выводит пакет и его описание. Если вы хотите выводить только имя пакета, можно использовать параметр--only-name:
$ composer search --only-name monolog
команда show
Команда show может вывести информацию о пакетах, используемых текущим проектом:
# 列出所有已经安装的包 $ composer show # 可以通过通配符进行筛选 $ composer show monolog/* # 显示具体某个包的信息 $ composer show monolog/monolog
Основные ограничения
Точная версия
Мы можем указать Composer точную версию для установки, например: 1.0.2, указав версию 1.0.2.
Диапазон
Используйте операторы сравнения, чтобы указать диапазон пакета. К этим операторам относятся:>,>=,<,<=,!=。
Можно определить несколько диапазонов. Используйте пробелы или запятые , для логического И, и двойные вертикальные черты || для логического ИЛИ. Приоритет И выше, чем ИЛИ. Пример:
- >=1.0
- >=1.0 <2.0
- >=1.0 <1.1 || >=1.2
Мы также можем использовать дефис-чтобы указать диапазон версий.
Левая часть дефиса указывает>=версию. Если версия справа не является полным номером версии, она будет дополнена с помощью подстановочных знаков. Например1.0 - 2.0эквивалентно>=1.0.0 <2.1(2.0эквивалентно2.0.*), и1.0.0 - 2.1.0эквивалентно>=1.0.0 <=2.1.0。
Подстановочный знак
Вы можете использовать подстановочные знаки для задания версий.1.0.*эквивалентно>=1.0 <1.1。
Пример:1.0.*
Тильда ~
Давайте сначала объясним использование оператора ~ на следующем примере:~1.2эквивалентно>=1.2 <2.0.0, и~1.2.3эквивалентно>=1.2.3 <1.3.0. Для проектов, использующихSemantic Versioningв качестве стандарта версионирования, этот метод ограничения версий очень практичен. Например~1.2определяет минимальную минорную версию, и вы можете без проблем обновиться до любой версии ниже 2.0, потому что согласноSemantic Versioningопределению версии, обновления минорной версии не должны иметь проблем с совместимостью. Проще говоря,~определяет минимальную версию и позволяет обновлять последнюю цифру номера версии (если вы не поняли, посмотрите предыдущие примеры ещё раз).
Пример:~1.2
Обратите внимание, что если ~ действует на номер мажорной версии, например
~1, согласно вышесказанному, Composer мог бы устанавливать мажорные версии после версии 1, но на самом деле~1рассматривается как~1.0, поэтому можно увеличивать только минорные версии, а не мажорную.
Каретка ^
^Поведение оператора тесно связано сSemantic Versioning. Это позволяет обновлять версии до безопасных версий. Например,^1.2.3эквивалентно>=1.2.3 <2.0.0, потому что версии до 2.0 не должны иметь проблем совместимости. Для версий до 1.0 это ограничение также учитывает безопасность, например^0.3рассматривается как>=0.3.0 <0.4.0.
Пример:^1.2.3
Стабильность версии
Если вы явно не указываете стабильность версии, Composer внутренне по умолчанию будет использовать-devили-stable. Например:
| Ограничение | Внутреннее ограничение |
|---|---|
1.2.3 |
=1.2.3.0-stable |
>1.2 |
>1.2.0.0-stable |
>=1.2 |
>=1.2.0.0-dev |
>=1.2-stable |
>=1.2.0.0-stable |
<1.3 |
<1.3.0.0-dev |
<=1.3 |
<=1.3.0.0-stable |
1 - 2 |
>=1.0.0.0-dev <3.0.0.0-dev |
~1.3 |
>=1.3.0.0-dev <2.0.0.0-dev |
1.4.* |
>=1.4.0.0-dev <1.5.0.0-dev |
1.0 - 2.0Если вы хотите указать, что принимаются только стабильные версии, вы можете добавить суффикс после версии-stable。
minimum-stabilityЭлемент конфигурации определяет поведение по умолчанию для выбора стабильности, когда пакет выбирает версию. По умолчаниюstable. Его значения следующие (отсортированы по стабильности):dev,alpha,beta,RCиstableПомимо изменения этой конфигурации для изменения поведения по умолчанию, мы также можемфлаг стабильности(например@stableи@dev), чтобы установить версию с другой стабильностью по сравнению с конфигурацией по умолчанию. Например:
{
"require": {
"monolog/monolog": "1.0.*@beta",
"acme/foo": "@dev"
}
}