Composer — это инструмент управления зависимостями для PHP, используемый для управления библиотеками, необходимыми проекту, и их версиями.

Composer определяет зависимости через файл composer.json и автоматически обрабатывает установку и обновления.

По умолчанию Composer не устанавливается глобально, а устанавливается в определённый каталог данного проекта (например, vendor).

Composer требует PHP 5.3.2+ или более поздней версии, и openssl должен быть включён.

Composer может работать на платформах Windows, Linux и OSX.

Основные возможности

  1. Управление зависимостями: Автоматическая установка и управление библиотеками, необходимыми проекту.

  2. Автозагрузка: Генерация файлов автозагрузки для упрощения загрузки классов.

  3. Управление версиями: Поддерживает семантическое версионирование для обеспечения совместимости зависимых библиотек.

  4. Поддержка скриптов: Позволяет запускать пользовательские скрипты при определённых событиях (например, установка или обновление).

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"
    }
}