PHPTime

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 на сервере.

Shell
# Показываем пакеты, которые блокируют выбранную версию 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

Shell
# Создаём приложение и запускаем локальный сервер.
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

Shell
# Создаём проект и подготавливаем локальную конфигурацию.
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

Что сравниваемBasicAdvanced
Веб-приложенияОдна точка входа в 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
<?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

  1. Выберите PHP 8.4 или 8.5 для новой среды. Прогоните приложение на точной версии PHP, которая будет обслуживать запросы и фоновые команды.
  2. Выберите Basic для одной веб-точки входа или Advanced для отдельных приложений. Направьте веб-сервер в соответствующие каталоги web/.
  3. Зафиксируйте composer.lock в репозитории. Для рабочего развёртывания используйте composer install --no-dev --optimize-autoloader и проверьте требования платформы.
  4. Передайте секреты через окружение, отключите отладку и проверьте права на каталоги runtime/ и web/assets/ у каждого веб-приложения.
  5. Примените миграции в тестовой среде. Проверьте вход, формы, операции с базой и консольные команды. Для нового проекта сравните этот же набор сценариев с 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-код с явными зависимостями обычно приходится меньше изменений, поэтому его удобно выделять до переноса веб-слоя.

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

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

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

Где искать расширения Yii 2, как проверить совместимость с PHP 8.3–8.5 и выбрать пакет. Установка через Composer, настройка и примеры популярных расширений.

7 мин

Миграция с Yii 1.1 на Yii 2: как перенести действующий проект

Как перенести проект с Yii 1.1 на Yii 2: пространства имён, ActiveRecord, формы, виджеты и конфигурация. План миграции с тестами и откатом.

7 мин

Как настроить автодополнение scope-методов ActiveRecord в Yii2

Настройте автодополнение scope-методов Yii2 в PhpStorm: создайте класс ActiveQuery, типизируйте find() и используйте фильтры в связях hasOne и hasMany.

7 мин

Yii 1.1.14 и хеширование паролей в PHP: от CPasswordHelper к Yii 2

Что Yii 1.1.14 изменил в работе с паролями и кешем. Как проверять bcrypt-хеши, мигрировать на password_hash или Yii 2 и настроить отдельный кеш в Redis.

7 мин