Yii 2 сегодня: установка, PHP 8.x и выбор фреймворка
Yii 2 остаётся рабочим выбором для развития приложений, в которых уже используются его Active Record, формы и виджеты. Для нового проекта выбор зависит от требований к архитектуре, компетенций команды и срока сопровождения. Разберём, как запустить Yii 2 на PHP 8.x и проверить, подходит ли он под вашу задачу.
Что дал стабильный релиз Yii 2
Со стабильным релизом Yii 2 разработчики получили MVC-фреймворк с установкой через Composer, пространствами имён, Active Record, валидацией моделей и генератором Gii. Из этих компонентов можно было быстро собрать приложение с формами, административным интерфейсом и доступом к базе. Шаблоны Basic и Advanced решали отдельную задачу: задавали структуру проекта и точки входа.
Эта модель по-прежнему удобна для прикладных систем с большим количеством CRUD-операций. При сопровождении проекта важнее всего знать, какая версия фреймворка зафиксирована в composer.lock, какие расширения используются и какие версии PHP реально проходят тесты.
Yii 2 и PHP 8.3–8.5
На конец 2026 года PHP 8.3, 8.4 и 8.5 получают обновления безопасности. PHP 8.3 находится на этапе security-only, а PHP 8.4 и 8.5 ещё получают исправления обычных ошибок. Для нового развёртывания разумно рассматривать PHP 8.4 или 8.5 с учётом ограничений зависимостей и возможностей хостинга.
Совместимость проекта складывается из требований самого yiisoft/yii2, расширений Yii, транзитивных библиотек и модулей PHP. Старый lock-файл может удерживать пакет, который запрещает PHP 8.5, даже если более свежая версия этого пакета уже подходит. Проверить блокирующие зависимости можно до смены среды. В примере 8.5.0 обозначает проверяемую версию. Для развёртывания подставьте фактическую версию PHP на сервере.
# Показываем пакеты, которые блокируют выбранную версию PHP.
composer prohibits php 8.5.0
# Выполняем под целевым PHP после установки зависимостей.
composer check-platform-reqsПроверка Composer покрывает объявленные требования пакетов. Дополнительно прогоните тесты и проверьте журналы на E_DEPRECATED: например, при переходе на PHP 8.4 могут проявиться неявно nullable-параметры в старых библиотеках. Сверьте версии и расширения PHP у веб-процесса, консольных команд и воркеров. Драйвер PDO выбирайте под свою СУБД, например pdo_mysql для MySQL.
Как установить Yii 2 через Composer
Для примеров ниже нужны PHP выбранной версии и Composer. Каждый шаблон устанавливается в отдельный каталог. Для первого запуска достаточно Basic.
Шаблон Basic
# Создаём приложение и запускаем локальный сервер.
composer create-project --prefer-dist yiisoft/yii2-app-basic yii-basic
cd yii-basic
php yii serve --port=8080Порт 8080 предназначен для локальной разработки. В рабочей среде направьте веб-сервер в каталог web/ и настройте передачу прикладных маршрутов в web/index.php. Параметры базы задаются через config/db.php. Для переноса между средами удобно читать реквизиты подключения из переменных окружения. Убедитесь, что request.cookieValidationKey задан уникальным секретом для среды.
Шаблон Advanced
# Создаём проект и подготавливаем локальную конфигурацию.
composer create-project --prefer-dist yiisoft/yii2-app-advanced yii-advanced
cd yii-advanced
php init --env=Development
# После настройки базы в common/config/main-local.php
# применяем миграции к базе разработки.
php yii migrateКоманда init создаёт файлы окружения, включая локальную конфигурацию. Для рабочего развёртывания используйте окружение Production, передайте секреты средствами инфраструктуры и настройте отдельный корень для каждой веб-точки входа: frontend/web/ и backend/web/. Отключите отладку и Gii в публичной среде.
Чем отличаются Basic и Advanced
| Что сравниваем | Basic | Advanced |
|---|---|---|
| Веб-приложения | Одна точка входа в web/ | Раздельные frontend/ и backend/ |
| Код и конфигурация | controllers/, models/, views/, config/ | Своя структура у каждого приложения, общие модели и настройки в common/ |
| Консоль | Точка входа yii, команды в commands/ | Точка входа yii, отдельное приложение в console/ |
| Типичный проект | Внутренний кабинет, небольшой сервис, API с одной точкой входа | Публичный сайт и отдельная админка с общей предметной областью |
Если админка использует общую конфигурацию и развёртывается вместе с сайтом, в Basic её можно оформить модулем. Advanced имеет смысл, когда нужны отдельный домен, собственная конфигурация или отдельные правила доступа для административного приложения. Два веб-корня упрощают настройку таких границ. Права доступа всё равно задаются в приложении и на веб-сервере.
Как писать современный PHP внутри Yii 2
Типизируйте новый прикладной код, особенно сервисы, объекты передачи данных и методы, которые команда контролирует целиком. declare(strict_types=1) действует на уровне файла и влияет на передачу скалярных аргументов из этого файла. Значения из форм и query string нужно валидировать на входе и приводить к нужным типам перед передачей в сервис. Для методов, которые переопределяют API Yii, сохраняйте совместимость сигнатур с родительскими классами.
Например, в Basic можно сохранить следующий сервис в services/ArticleLinks.php. Явный параметр маршрута id и типизированный аргумент упрощают чтение вызовов из контроллера. Маршрут article/view предполагает, что соответствующий контроллер и экшен уже созданы.
<?php
declare(strict_types=1);
namespace app\services;
use yii\helpers\Url;
final class ArticleLinks
{
public function view(int $id): string
{
// Yii сформирует путь по правилам маршрутизации приложения.
return Url::to(['/article/view', 'id' => $id]);
}
}В Active Record свойства колонок доступны через механизмы Yii. Добавляйте нативные типы в DTO и сервисы. Объявление одноимённого публичного свойства у Active Record может перехватить доступ к атрибуту и нарушить чтение или запись данных. Для запросов используйте Active Record, Query Builder или параметры команд Yii. Для HTML, который вручную выводится в представлении, экранируйте пользовательские значения через yii\helpers\Html::encode().
Когда выбрать Yii 2, Yii 3 или Laravel
- Yii 2 подходит для развития действующего приложения и для нового проекта, если команда уже уверенно работает с Yii, располагает нужными компонентами и проверила их на целевой версии PHP. Типичный пример — кабинет с формами, фильтрами и списками, который расширяет существующую систему.
- Yii 3 стоит рассматривать для нового приложения, если нужны независимые пакеты, внедрение зависимостей и HTTP-слой на PSR-интерфейсах. Оцените наличие конкретных компонентов, нужных проекту, на небольшом прототипе. Переход с Yii 2 затрагивает загрузку приложения, конфигурацию и веб-слой, поэтому его стоит оценивать как миграцию.
- Laravel подходит для нового продукта, которому нужны типовые решения для очередей, планировщика, уведомлений и фоновых задач. Его легче внедрить, если у команды уже есть опыт работы с Eloquent, Artisan и эксплуатацией воркеров.
Для существующего приложения сначала оцените стоимость обновления PHP и зависимостей в рамках Yii 2. Если решение о миграции принято, выделяйте самостоятельные сценарии, например обработку заказов или отдельный кабинет. Для первого переноса выберите сценарий, который можно развернуть и проверить отдельно.
Чек-лист перед запуском Yii 2
- Выберите PHP 8.4 или 8.5 для новой среды. Прогоните приложение на точной версии PHP, которая будет обслуживать запросы и фоновые команды.
- Выберите Basic для одной веб-точки входа или Advanced для отдельных приложений. Направьте веб-сервер в соответствующие каталоги
web/. - Зафиксируйте
composer.lockв репозитории. Для рабочего развёртывания используйтеcomposer install --no-dev --optimize-autoloaderи проверьте требования платформы. - Передайте секреты через окружение, отключите отладку и проверьте права на каталоги
runtime/иweb/assets/у каждого веб-приложения. - Примените миграции в тестовой среде. Проверьте вход, формы, операции с базой и консольные команды. Для нового проекта сравните этот же набор сценариев с Yii 3 или Laravel, если они входят в список кандидатов.
Частые вопросы
Работает ли Yii 2 на PHP 8.5?
Современные выпуски Yii 2 можно использовать на PHP 8.5 при совместимом наборе зависимостей. Для конкретного приложения проверьте ограничения из composer.lock, выполните composer check-platform-reqs под целевым PHP и прогоните тесты.
Какой шаблон Yii 2 выбрать для сайта с админкой?
Basic подойдёт, если админку удобно сделать модулем внутри одного веб-приложения. Advanced удобнее для отдельных frontend и backend с собственными точками входа и общей предметной логикой.
Можно ли перейти с Yii 2 на Yii 3 через обновление Composer?
Переход требует адаптации загрузки приложения, конфигурации, контроллеров и интеграций. На чистый PHP-код с явными зависимостями обычно приходится меньше изменений, поэтому его удобно выделять до переноса веб-слоя.