Composer: как установить и подключить библиотеку

Composer — менеджер пакетов для PHP: он скачивает готовые библиотеки, следит за их версиями и подключает их к проекту одной строкой. Библиотеки берутся из каталога Packagist.

Установка

PHP должен быть установлен заранее — урок Что такое PHP и как его запустить. Дальше способ зависит от системы.

sudo apt install composer
composer --version

Проверка — composer --version: команда выводит номер версии Composer. Composer работает в папке проекта и прав root не требует.

Добавить библиотеку

Перейдите в папку проекта и выполните composer require с именем пакета. Например, библиотека для записи журнала Monolog (вместо ~/my-site — папка вашего проекта):

cd ~/my-site
composer require monolog/monolog

Composer создаст:

• composer.json — список нужных пакетов и их версий;
• composer.lock — точные версии, которые поставлены;
• папку vendor — сами библиотеки и файл автозагрузки.

Подключать библиотеки по отдельности не нужно — достаточно одного файла vendor/autoload.php:

<?php
use Monolog\Logger;
use Monolog\Handler\StreamHandler;

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

$log = new Logger('app');
$log->pushHandler(new StreamHandler(__DIR__ . '/app.log'));
$log->info('Сайт запущен');

Monolog\Logger — полное имя класса: Monolog — пространство имён (приставка библиотеки, чтобы её классы не путались с чужими), Logger — сам класс. use даёт классу короткое имя: дальше в файле можно писать Logger вместо Monolog\Logger.

Главные команды

Автозагрузка своих классов

Composer умеет подключать и ваши классы. Допишите в composer.json раздел autoload — по правилу PSR-4 (общепринятое правило: имя класса соответствует пути к файлу):

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

Если в файле уже есть другие разделы (require), добавьте autoload рядом с ними через запятую. Затем выполните composer dump-autoload. Теперь класс App\Models\User ищется в файле src/Models/User.php, и require для него писать не нужно. Файл начинается со строки namespace App\Models;, класс называется так же, как файл.

Git и сервер

• В репозиторий кладут composer.json и composer.lock, а папку vendor — нет: добавьте её в .gitignore.
• На сервере после выкладки выполните composer install --no-dev — поставятся ровно те версии, что проверены у вас, без пакетов для разработки.

Частые ошибки

• composer: command not found или «не распознано как имя командлета» — Composer не установлен или терминал открыт до установки.
• Your requirements could not be resolved — пакету нужна другая версия PHP или расширение (ext-mbstring, ext-curl). В сообщении написано, чего не хватает: поставьте расширение или подходящую версию пакета.
• Class "…" not found — не подключён vendor/autoload.php, опечатка в use или после правки autoload не выполнен composer dump-autoload.