PHPTime

Yii 2: от публичного превью до современной разработки

Первое публичное превью Yii 2 появилось после двух лет разработки и сразу дало понять: обратной совместимости с веткой 1.x не будет. Сегодня Yii 2 — стабильный фреймворк с долгим циклом поддержки, который уверенно работает на PHP 8.3–8.5. Разберём, что изменила новая архитектура и как начать проект на актуальной версии.

От анонса к стабильному релизу

Когда вышло первое публичное превью Yii 2, разработчики прямо предупреждали: не используйте этот код в продакшене. Это был срез архитектурных экспериментов, которые велись больше двух лет. Основной посыл — отказ от обратной совместимости с Yii 1.x ради более чистого ядра и современных возможностей PHP.

Что изменилось на уровне архитектуры:

  • Пространства имён вместо длинных префиксованных классов. Класс CDbCommand превратился в yii\db\Command.
  • Внедрение зависимостей через контейнер — до Yii 2 приходилось создавать объекты вручную почти везде.
  • Подключение Composer как основного способа установки и автозагрузки вместо собственного загрузчика.
  • События и поведения переписаны на трейты, что убрало часть ограничений одиночного наследования.
  • Query Builder и ActiveRecord разделены: построение запросов больше не привязано жёстко к моделям.

Превью позволило сообществу протестировать подходы, которые позже оформились в стабильную ветку 2.0. С тех пор ядро не менялось радикально, но обрастало улучшениями без ломки API.

Что дала новая архитектура

Главное отличие от ветки 1.x — компонентная структура. Каждый элемент фреймворка: кэш, логгер, база данных, сессии — оформлен как сменный компонент, который конфигурируется через единый механизм. Это позволило легко подменять реализации без правки кода приложения.

Ключевые усиления:

  • Активная запись использует статичные методы для построения запросов, а не магию с find(), возвращавшую разные типы в зависимости от контекста.
  • RBAC получил полноценную реализацию с хранением ролей и разрешений в БД или файле, а не только программным способом.
  • Валидация построена на сценариях и правилах, которые легко расширять своими классами.
  • Отображение и обработка ошибок настраиваются централизованно, включая JSON-ответы для API.

Современная ветка 2.0.x поддерживает PHP 8.3–8.5, включая строгую типизацию. Если вы начинаете проект сегодня, объявляйте declare(strict_types=1) во всех классах и методах — это убирает неявные приведения типов, которые были нормой для Yii 1.x.

Запуск проекта сегодня

Создание нового приложения на Yii 2 — одна команда. Composer сам развернёт структуру, подключит зависимости и сгенерирует базовые конфиги.

Shell
composer create-project --prefer-dist yiisoft/yii2-app-basic my-project
cd my-project
php yii serve

Флаг --prefer-dist скачивает готовый архив вместо клонирования репозитория — это быстрее и надёжнее для старта. После запуска встроенного сервера приложение доступно на localhost:8080.

Базовая структура:

  • config/ — конфигурация приложения и веб-окружения;
  • controllers/ — классы контроллеров;
  • models/ — модели и ActiveRecord-сущности;
  • views/ — шаблоны;
  • web/ — корень веб-сервера, входной скрипт index.php;
  • vendor/ — зависимости Composer.

Строгая типизация и PHP 8.3–8.5

Yii 2 не обязывает использовать строгую типизацию, но на PHP 8.3 и выше это стандарт ответственного кода. Правило простое: каждый файл с классами начинается с declare(strict_types=1);.

PHP
price * (1 + $taxRate);
    }

    public function setTitle(string $title): void
    {
        $this->title = trim($title);
    }
}

Современные возможности PHP, которые работают с Yii 2 без ограничений: readonly-свойства, перечисления, атрибуты, match, union-типы и DTO-классы для входных данных. Не нужно тянуть старые паттерны из эпохи PHP 5 — фреймворк не мешает писать на актуальном языке.

Конфигурация без устаревших подходов

В Yii 2 нет единого сервис-провайдера — конфигурация задаётся массивами. Это просто, но требует аккуратности: опечатка в ключе не вызовет ошибку, а компонент просто не создастся. Для типизированного доступа к контейнеру используйте Yii::$app->get() с указанием ожидаемого класса.

PHP
 [
        'db' => [
            'class' => Connection::class,
            'dsn' => 'mysql:host=127.0.0.1;dbname=shop',
            'username' => getenv('DB_USER'),
            'password' => getenv('DB_PASSWORD'),
            'charset' => 'utf8mb4',
        ],
    ],
];

// Инициализация приложения
$app = new yii\web\Application($config);

// Строгий доступ к компоненту
$db = $app->get('db');
if (!$db instanceof Connection) {
    throw new LogicException('Компонент db настроен неверно');
}

Подключение выполнено через DSN с драйвером PDO — это стандарт. Функции mysql_* остались в прошлом, их заменяют PDO и mysqli. То же касается ereg и create_function: вместо них preg_match и анонимные функции.

Статус Yii 3

Yii 3 — не обновление ветки 2.0, а переосмысление фреймворка как набора независимых пакетов. Разработка идёт публично, но стабильный релиз для широкого продакшена пока не заменил Yii 2. Основные отличия:

  • Каждый компонент — отдельный Composer-пакет, включаемый по необходимости.
  • Строгая типизация и PSR-совместимость на уровне ядра: PSR-7, PSR-11, PSR-15.
  • Отказ от глобального объекта Yii::$app в пользу внедрения зависимостей.
  • Цикл разработки дольше привычного: задача не «выпустить новую мажорную версию», а пересобрать экосистему.

Для рабочих проектов в 2026 году Yii 2 остаётся прагматичным выбором: стабильная ветка 2.0.x поддерживается, сообщество активно, документация на русском языке полная. Изучив Yii 2, переход к Yii 3 в будущем будет проще — идеи DI, событий и middleware уже знакомы.

Чек-лист старта на Yii 2

  • Убедитесь, что Composer установлен и работает с PHP 8.3 или новее.
  • Создайте проект через composer create-project yiisoft/yii2-app-basic.
  • Настройте подключение к БД в config/db.php, заменив устаревший формат DSN на PDO.
  • Добавьте declare(strict_types=1); в классы с бизнес-логикой.
  • Вынесите секреты в переменные окружения, не храните пароли в Git.
  • Проверьте, что web/ — единственная публичная директория для веб-сервера.
  • Подключите миграции через php yii migrate, а не правьте схему БД вручную.

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

Yii 2 всё ещё актуален в 2026 году?

Да, ветка 2.0.x поддерживается и работает на PHP 8.3–8.5. Для коммерческих и корпоративных проектов это стабильный выбор с полной документацией и активным сообществом.

Чем Yii 2 отличается от Yii 1.x?

Yii 2 построен на пространствах имён, Composer и внедрении зависимостей. Обратной совместимости с веткой 1.x нет, но новая архитектура чище и гибче для современных задач.

Как начать проект на Yii 2?

Выполните composer create-project yiisoft/yii2-app-basic my-project, затем настройте конфигурацию БД и запустите встроенный сервер командой php yii serve.

Что со строгой типизацией в Yii 2?

Фреймворк не требует её, но на PHP 8.3 и новее рекомендуется добавлять declare(strict_types=1) в каждый класс с бизнес-логикой. Никаких конфликтов с Yii 2 это не вызывает.

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

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

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

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

7 мин

Yii 2 сегодня: установка, PHP 8.x и выбор фреймворка

Как установить Yii 2 на PHP 8.3–8.5, выбрать шаблон Basic или Advanced, проверить зависимости и решить, когда перейти на Yii 3 или Laravel.

6 мин

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

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

7 мин

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

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

7 мин