PHPTime

Расширения Yii 2: где искать и как устанавливать через Composer

Расширения Yii 2 подключают очереди, Redis, загрузку изображений и другие возможности без доработки ядра. Найти пакет проще всего в Packagist или среди репозиториев yiisoft. Перед установкой стоит проверить, какую версию выберет Composer и заработает ли она на вашем сервере.

Где искать расширения Yii 2

Yiigist был специализированным каталогом, который помогал находить пакеты для Yii 1 и Yii 2, опубликованные в Packagist и размещённые на GitHub. Сегодня поиск удобно начинать в Packagist, а оценивать найденный пакет по документации и репозиторию. Для типовых задач сначала смотрите пакеты организации yiisoft.

  • Packagist — поиск по имени пакета или задаче. Попробуйте запросы yii2 queue, yii2 redis, yii2 image. На карточке смотрите стабильные версии, зависимости и пометку об отказе от сопровождения.
  • Репозитории yiisoft — документация, примеры конфигурации и история изменений официальных расширений. Читайте README тега, который планируете установить: документация основной ветки может описывать ещё не выпущенный API.
  • Репозитории сторонних авторов — полезны для виджетов, интеграций и узких задач. Имя пакета и исходный репозиторий сверяйте по карточке Packagist, особенно если есть несколько похожих форков.

У пакетов для Yii 2 часто встречается префикс yii2-, а в метаданных Composer — тип yii2-extension. Это подсказки для поиска. Совместимость подтверждают зависимости конкретного релиза: для расширения, напрямую использующего классы Yii 2, проверьте ограничение на yiisoft/yii2. Библиотеки общего назначения могут работать в Yii 2 и без зависимости от фреймворка.

Как оценить пакет до установки

Сверьте PHP, Yii и окружение

Для проекта на PHP 8.3–8.5 проверяйте именно ту минорную версию, которая используется при развёртывании. У веб-приложения, консольных команд и воркеров могут быть разные PHP и наборы модулей. Требования выбранного тега к php, ext-*, yiisoft/yii2 и остальным библиотекам должны укладываться в возможности каждого процесса, где используется расширение.

Разрешение зависимостей подтверждает совместимость объявленных ограничений. Реальную работу проверьте тестами проекта на целевой версии PHP. Если пакет формально допускает PHP 8.5, но автор тестирует его только на PHP 8.3, прогоните на 8.5 тот сценарий, ради которого его подключаете.

Проверьте сопровождение и объём изменений

  • Посмотрите, есть ли стабильный релиз, инструкция по обновлению и тесты. У простой зрелой библиотеки релизы могут выходить редко. Для пакета, который принимает файлы или обрабатывает авторизацию, особенно важна реакция автора на сообщения об уязвимостях.
  • Прочитайте открытые задачи по вашей версии PHP, Yii и драйверов. Ищите воспроизводимые ошибки и способы их решения.
  • Оцените новые зависимости, лицензию и требования к инфраструктуре. Для очереди может понадобиться отдельный процесс, для Redis — сервер и настройки подключения, для обработки изображений — подходящий модуль PHP.
  • Проверьте, где пакет встраивается в приложение. Консольная команда, компонент и модуль с публичными маршрутами требуют разных проверок перед выпуском.

Если задача сводится к SMTP, запросам к API или обработке изображений, сравните Yii-расширение с универсальной PHP-библиотекой. Пакет для Yii 2 особенно удобен, когда нужны готовые правила валидации, конфигурация компонента, виджет или консольная команда. Универсальную библиотеку проще использовать и в коде, который не зависит от фреймворка.

Как установить расширение через Composer

Запускайте Composer из корня проекта, где лежат composer.json и composer.lock. На примере очереди сначала посмотрите доступные релизы и результат пробного разрешения зависимостей.

Shell
# Показываем версии и сведения о пакете
composer show --all yiisoft/yii2-queue

# Проверяем, что Composer собирается изменить
composer require yiisoft/yii2-queue --dry-run

Если Composer сообщает о конфликте, прочитайте цепочку ограничений в выводе. Для диагностики конкретной версии пригодится composer why-not: передайте имя пакета и номер выбранного релиза. Так можно увидеть, какая зависимость или настройка платформы мешает установке. У проекта с config.platform Composer может подбирать зависимости под заданную версию PHP, которая отличается от версии в текущей консоли.

Shell
# Устанавливаем пакет с ограничением, которое подберёт Composer
composer require yiisoft/yii2-queue

# Смотрим, что изменилось в зависимостях приложения
 git diff -- composer.json composer.lock

# Проверяем требования к реальному PHP и модулям в текущем окружении
composer check-platform-reqs

# Проверяем зависимости по известным уведомлениям безопасности
composer audit

Просмотрите изменения в composer.lock: даже установка одного пакета может затронуть несколько транзитивных зависимостей. Если вы выбрали конкретную ветку релизов, укажите её ограничение при вызове composer require. Параметр --ignore-platform-reqs скрывает несовместимость окружения и может привести к падению уже при запуске.

Зафиксируйте composer.json и composer.lock в репозитории приложения. В среде развёртывания используйте composer install --no-dev, чтобы установить версии из lock-файла. Там же повторите composer check-platform-reqs --no-dev и проверьте PHP веб-процесса, если он отличается от консольного.

Как подключить и проверить расширение

Установленный пакет доступен через автозагрузчик Composer. Дальнейшие шаги зависят от расширения: настройка компонента, подключение модуля, запуск миграций или добавление консольного процесса. Например, файловый драйвер yii2-queue позволяет проверить работу очереди в локальном окружении без отдельного сервера Redis.

В консольной конфигурации подключите следующий компонент. Если файл уже содержит bootstrap и components, добавьте записи в существующие массивы.

PHP
<?php

declare(strict_types=1);

use yii\queue\file\Queue;

return [
    // Регистрируем консольные команды очереди.
    'bootstrap' => ['queue'],
    'components' => [
        'queue' => [
            'class' => Queue::class,
            // Каталог должен быть доступен на запись.
            'path' => '@runtime/queue',
        ],
    ],
];

Если задачи ставит веб-приложение, вынесите описание компонента в общую конфигурацию или добавьте такой же компонент в веб-конфигурацию. Проверьте, что веб-процесс и консоль разрешают путь к одному и тому же каталогу: в шаблоне Advanced их @runtime могут различаться. При раздельных контейнерах файловому драйверу понадобится общий том.

Shell
# Проверяем, что консоль увидела команды расширения
php yii help queue

# Обрабатываем задачи, которые уже лежат в очереди
php yii queue/run

Для сквозной проверки поставьте тестовую задачу тем же способом, каким её будет ставить приложение. После запуска команды проверьте ожидаемый результат задачи. Так можно заметить расхождение путей, проблемы с правами или ошибку загрузки класса задания, даже если сама команда зарегистрировалась.

Популярные расширения Yii 2 по задачам

ПакетЗадачаЧто учесть при подключении
yiisoft/yii2-queueФоновые заданияВыберите драйвер и способ запуска обработчика. Задание, которое может выполниться повторно, должно переносить повторный запуск.
yiisoft/yii2-redisКеш, сессии и работа с RedisПроверьте доступность сервера Redis, параметры подключения и префиксы ключей для разных приложений.
yiisoft/yii2-symfonymailerОтправка писем через Symfony MailerЗадайте транспорт. При переходе со старого почтового компонента проверьте HTML-письмо, вложение и работу доставки через очередь, если она используется.
yiisoft/yii2-imagineМиниатюры, обрезка и преобразование изображенийПроверьте доступный драйвер и поддержку форматов в серверной сборке PHP.
yiisoft/yii2-debugПанель отладки запросов, SQL и логовУстановите с --dev и подключайте модуль только в средах разработки с ограниченным доступом.
yiisoft/yii2-giiГенерация моделей, CRUD и другого шаблонного кодаУстановите с --dev. Проверьте сгенерированные модели и контроллеры перед коммитом.

Для виджетов сначала уточните версию Bootstrap в проекте. Например, yiisoft/yii2-bootstrap5 рассчитан на Bootstrap 5. Если приложение использует другую ветку, подключение второго набора статических ресурсов может сломать стили и поведение компонентов.

Чек-лист перед подключением расширения

  1. Найдите пакет в Packagist и откройте документацию выбранного стабильного релиза.
  2. Сверьте требования к Yii, PHP, модулям и внешним сервисам с целевым окружением.
  3. Выполните composer require с --dry-run. После установки просмотрите изменения в lock-файле и запустите composer audit.
  4. Добавьте конфигурацию и проверьте один реальный сценарий от начала до результата: письмо дошло, задача обработалась или миниатюра создалась.
  5. Зафиксируйте оба файла Composer, установите зависимости из lock-файла при развёртывании и проверьте требования к платформе на целевом сервере.

Частые вопросы

Где искать расширения для Yii 2 вместо Yiigist?

Начните с Packagist, где можно искать пакеты по названию и назначению. Для официальных расширений смотрите репозитории организации yiisoft, а инструкцию по установке и конфигурации читайте для выбранного тега.

Можно ли установить расширение для Yii 1 в проект Yii 2?

Обычно требуется версия расширения, портированная на Yii 2, или другой пакет для той же задачи. Если нужная функциональность реализована независимой PHP-библиотекой, её можно подключить напрямую и настроить интеграцию с приложением.

Как проверить совместимость расширения с PHP 8.5?

Проверьте требования конкретного релиза и выполните пробную установку через Composer с платформой, соответствующей целевому окружению. Затем запустите composer check-platform-reqs и тест нужного сценария на реальном PHP 8.5.

Справка по теме

Ещё в разделе «Yii»

Система онлайн-бронирования на PHP: от модели данных до защиты от двойных записей

Проектируем модуль онлайн-бронирования на PHP 8.3+: схема хранения слотов, конкурентный доступ, часовые пояса и подтверждение заявок без гонок данных.

10 мин

Как создать своё правило валидации в Yii

Как написать собственное правило валидации в Yii 2 на PHP 8.3–8.5, подключить его в rules(), переиспользовать в моделях и добавить проверку в ActiveForm.

7 мин

Поведение и события в Yii 2

Как подписываться на события и вызывать их в Yii 2, подключать поведения к компонентам и использовать события ActiveRecord в приложениях на PHP 8.3–8.5.

8 мин

Иерархический RBAC в Yii: как работает проверка доступа

Как устроен иерархический RBAC в Yii и Yii 2: куда направлять связи, как checkAccess и can обходят граф и как разрешить автору править свои записи.

8 мин