Composer и Laravel: эффективная работа с библиотеками и инструментами

Расширенные примеры работы с Composer в Laravel

Пример 1. Создание пакета с Artisan командой и автоматической регистрацией

Допустим, создается пакет mycompany/artisan-commands, который добавляет Artisan команду для очистки логов. Внутри пакета создаётся класс команды:

// src/Console/ClearLogs.php
namespace Mycompany\ArtisanCommands\Console;

use Illuminate\Console\Command;

class ClearLogs extends Command
{
    protected $signature = 'logs:clear';
    protected $description = 'Clear all logs in storage/logs';

    public function handle()
    {
        array_map('unlink', glob(storage_path('logs/*.log')));
        $this->info('Logs cleared!');
    }
}

В сервис-провайдере регистрируется команда:

// src/ArtisanCommandsServiceProvider.php
namespace Mycompany\ArtisanCommands;

use Illuminate\Support\ServiceProvider;
use Mycompany\ArtisanCommands\Console\ClearLogs;

class ArtisanCommandsServiceProvider extends ServiceProvider
{
    public function boot()
    {
        if ($this->app->runningInConsole()) {
            $this->commands([
                ClearLogs::class,
            ]);
        }
    }
}

После подключения пакета (аналогично варианту из основной статьи) команда php artisan logs:clear становится доступной. Результат выполнения:

$ php artisan logs:clear
Logs cleared!

Пример 2. Использование composer scripts для автоматизации действий после установки пакета

Composer позволяет выполнять скрипты при различных событиях. Например, в корневом composer.json Laravel проекта можно задать скрипт, который после установки пакета mycompany/mypackage выполняет миграции:

"scripts": {
    "post-install-cmd": [
        "@php artisan migrate --force"
    ],
    "post-update-cmd": [
        "@php artisan optimize"
    ]
}

При выполнении composer install после обновления пакетов автоматически запускаются миграции и оптимизация. Результат в консоли:

> @php artisan migrate --force
Migration table created successfully.
Migrating: 2014_10_12_000000_create_users_table
Migrated:  2014_10_12_000000_create_users_table (0.02 seconds)
...

Пример 3. Настройка Satis для создания приватного репозитория

Satis - инструмент для создания собственного статического репозитория пакетов. Сначала устанавливается глобально:

composer global require composer/satis

Создаётся конфигурационный файл satis.json:

{
    "name": "mycompany/satis",
    "homepage": "https://packages.mycompany.com",
    "repositories": [
        {"type": "vcs", "url": "git@github.com:mycompany/private-package.git"},
        {"type": "vcs", "url": "git@github.com:mycompany/another-package.git"}
    ],
    "require": {
        "mycompany/private-package": "*",
        "mycompany/another-package": "*"
    },
    "require-dependencies": true,
    "archive": {
        "directory": "dist",
        "format": "tar"
    }
}

Затем запускается построение:

php satis build satis.json build/

В папке build/ появляются HTML-страницы, JSON-индекс и архивы пакетов. Чтобы подключить этот репозиторий в Laravel проекте, в composer.json добавляется:

"repositories": [
    {"type": "composer", "url": "https://packages.mycompany.com"}
]

После этого любая команда composer require mycompany/private-package будет искать пакет в Satis.

Пример 4. Анализ зависимостей с помощью composer why и why-not

Иногда непонятно, почему пакет установлен или почему не удаётся установить определённую версию. Команда composer why vendor/package показывает, какие пакеты требуют данный пакет:

composer why guzzlehttp/guzzle

Пример вывода:

guzzlehttp/guzzle 7.8.1 requires guzzlehttp/guzzle (self.version)
laravel/framework 10.48.4 requires guzzlehttp/guzzle (^7.0)
mycompany/mypackage dev-main requires guzzlehttp/guzzle (^7.5)

Команда composer why-not vendor/package desired-version поясняет, почему не может быть установлена указанная версия:

composer why-not monolog/monolog 2.9.0

Результат:

monolog/monolog 2.9.0 conflicts with laravel/framework (10.48.4 requires monolog/monolog ^2.0.0)

Такой анализ помогает точно определить источник конфликтов и принять решение о версионировании.