Повторное представление Composer — краеугольный камень современных приложений PHP

При запуске команды composer отображается информационная страница:

Некоторые из наиболее полезных команд Composer:

• composer help <command> — покажет страницу справки для данной команды.
• composer self update — обновляет композитор до последней доступной версии.
• composer search — поиск пакетов.
• composer status — показывает список зависимостей, которые были изменены локально. Если мы установим что-либо из источника (используя --prefer-source ), мы получим клон этого пакета в папке /vendor . Если мы сделаем некоторые изменения в этом пакете, команда composer status покажет нам git-статус для этих изменений.
• composer diagnose — диагностирует систему на наличие распространенных ошибок. Это особенно полезно для отладки, так как проверяет такие вещи, как подключение к Packagist, свободное место на диске и настройки git.

Мы сосредоточим наше внимание на composer init , composer create-project и composer require .

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

Для управления зависимостями в проекте Composer использует файл json . Этот файл описывает все зависимости, а также содержит некоторые метаданные.

В этом примере мы создадим новый проект PHP, в котором нам понадобится PHPUnit для нашего модульного тестирования. Есть несколько способов использовать Composer для управления этой зависимостью.

• composer init запустит мастер. Мастер проведет нас через генерацию нашего файла composer.json .
• composer search phpunit будет искать все доступные пакеты, phpunit ключевое слово phpunit . После того, как мы выбрали нужный пакет, мы можем использовать composer require <package> . Эта команда не только создаст файл composer.json , но и загрузит все указанные зависимости.
• Вручную напишите файл composer.json (не рекомендуется — легко поддается синтаксису и не дает очевидных преимуществ). Вот пример:

 { "require": { "phpunit/phpunit": "^4.8" } } 

• Ключ require переводит объекты, которые отображают имена пакетов (например, phpunit/phpunit ), в ограничения версии (например, 4.8 ). Composer использует эту информацию для поиска нужного набора файлов в «репозиториях» пакетов, которые вы регистрируете с помощью ключа repositories (подробнее здесь ) или в Packagist , репозитории пакетов по умолчанию, о котором мы поговорим чуть позже.

Если вы использовали composer init или ручной метод, вам нужно запустить composer install . Это загрузит все зависимости, необходимые для пакетов, описанных в файле composer.json .

Обратите внимание, что написание файла вручную и последующая composer install — это то же самое, что и запуск composer require <package> .

Использование подхода composer require <package> является рекомендуемым лучшим методом.

При первом запуске команды composer install загружаются зависимости и их установленные версии регистрируются в файле composer.lock . В следующий раз, когда кто-то запустит composer install в проекте, он не получит последние доступные версии пакетов, а те, которые зарегистрированы в файле composer.lock . Таким образом, Composer гарантирует, что ваш проект не сломается из-за неожиданных изменений кода в более новых версиях пакетов.

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

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

Если по какой-либо причине мы хотим придерживаться определенной версии, то мы должны упомянуть соответствующую версию в файле composer.json . Например:

  { "require": { "phpunit/phpunit": "4.8" } } 

Но что, если мы хотим обновить наши зависимости до последних версий?

 <?php // autoload.php @generated by Composer require_once __DIR__ . '/composer/autoload_real.php'; return ComposerAutoloaderInit7a731d2067108a4739c3dd65be722f17::getLoader(); 

 require __DIR__ . '/vendor/autoload.php'; 

 { "autoload": { "psr-4": {"Foo\\": "src/"} } } 

 composer config minimum-stability dev 

 composer global require phpunit/phpunit 

 <?php namespace Converter; class Converter { public function convertToCm($value) { return $value * 0.3937; } public function convertToInch($value) { return $value * 2.54; } } 

 { "name": "dailymatters/inch-conv", "description": "Inch To Cm converter", "type": "library", "license": "creative commons", "authors": [ { "name": "DailyMatters", "email": "[email protected]" } ], "minimum-stability": "dev", "require": {}, "autoload": { "psr-0": { "Converter": "src/" } } } 

 <?php require_once '/vendor/autoload.php'; use Converter\Converter; $conv = new Converter; $result = $conv->convertToCm(1); echo $result; $result = $conv->convertToInch(1); echo $result;