Yii3. Официальный релиз

Это случилось! Yii3 официально выпущен после многих лет интенсивной разработки и полировки.

Yii всегда следовал одним и тем же принципам: быть производительным, гибким, но с хорошими настройками по умолчанию, ориентированным на практику, простым, явным и последовательным. Yii3 — не исключение.

Yii 1.1 и Yii 2.0 — хорошие фреймворки. Yii3 получился ещё лучше и устранил следующие недостатки:

1. Yii 2.0 имел закрытую экосистему. Было не всегда просто настроить сторонние PHP-пакеты, не предназначенные для фреймворка.

2. Некоторая магия и неявность. Нестандартное поведение объектов, введённое в Yii 2.0.

3. Совместимость со стандартами PHP и использование современного PHP отсутствовали из-за ограничений обратной совместимости.

4. Некоторые антипаттерны, такие как сервис локатор, доступный из коробки. Это влияло на общую тестируемость и поддерживаемость проектов в долгосрочной перспективе.

Далее мы кратко рассмотрим основные моменты этого долгожданного релиза. Вы можете ознакомиться с разделом Начало работы, если хотите отложить чтение и сначала попробовать.

Независимые пакеты

По сравнению с Yii 1.1 и Yii 2.0, которые были монолитными фреймворками, Yii3 представляет собой экосистему с более чем 130 официальными пакетами. Эти пакеты могут использоваться как в любом PHP-коде так и как целый фреймворк, относительно похожий на Yii 2.0 или Yii 1.1. Шаблоны приложений очень помогают в этом случае.

Шаблоны приложений

Из коробки доступны три шаблона приложений:

• Web — для классических серверных приложений.

• API — для API.

• Console — для консольных инструментов и фоновых процессов.

В отличие от Yii 2.0, они очень минималистичны, поэтому вы начинаете с базовых вещей, таких как маршрутизация, конфигурация, DI-контейнер и окружение, уже собранных вместе. Дополнительная функциональность, такая как подключение к базе данных, по умолчанию отсутствует в шаблонах. Устанавли��айте только то, что вам нужно — ничего лишнего.

Возможность использовать любые пакеты

Вместо того чтобы сосредоточиться на специфичных для Yii расширениях, как это было в Yii 2.0, мы сделали фреймворк так, чтобы он хорошо работал с любыми PHP-пакетами, доступными на Packagist, будь то PSR-совместимые пакеты, пакеты Symfony или обычный PHP-код. Контейнер способен настроить любой из них.

Yii3 охватывает всю экосистему PHP вместо того, чтобы изобретать велосипед. Он легко интегрируется с любой PHP-библиотекой. Никакого вендор-лока. Никаких проприетарных API. Только современные стандарты PHP, позволяющие вам использовать инновации всей экосистемы.

Первоклассный DI-контейнер

Центральной частью фреймворка является его контейнер внедрения зависимостей. Он объединяет все отдельные пакеты, автоматически разрешая зависимости и помогая получить запрашиваемые классы. Обычное его использование очень простое и явное:

return [
   // Сопоставление интерфейса с классом
   EngineInterface::class => EngineMarkOne::class,
 
   // Детальная конфигурация
   MyServiceInterface::class => [
       'class' => MyService::class,
       '__construct()' => [42],
       'setDiscount()' => [10],
   ],

   // Фабричные замыкания
   'api' => static fn(ApiConfig $config) => new ApiClient($config),
];

// Зависимости автоматически внедряются на основе типизации

final readonly class MyController
{
   public function __construct(
       private CacheInterface $cache
   ) {}
}

Другим преимуществом контейнера является то, что он очень быстр и работает целиком во время выполнения. Ваша конфигурация — это то, что фактически выполняется, поэтому нет никакой магии, и вы даже можете пошагово отлаживать код с помощью XDebug, если это нужно.

Конфигурация

Мы взяли способы настройки из Yii 2.0, похожий на шаблон advanced. В нём есть поддержка несколько окружений, переопределение конфигурации и т.д. Конфигурация в Yii3 очень мощная и может быть настроена для практически любой структуры проекта. По умолчанию шаблоны приложений предоставляют конфигурацию, которая разделена на web (или API) и консоль, а также общую часть. Конфигурация разделена на две основные: конфигурация DI-контейнера, которая сопоставляет настроенные классы с интерфейсами, и параметры, которые используются для настройки этих классов.

'yiisoft/view' => [
    'basePath' => null,
    'parameters' => [
        'assetManager' => Reference::to(AssetManager::class),
        'applicationParams' => Reference::to(ApplicationParams::class),
        'aliases' => Reference::to(Aliases::class),
        'urlGenerator' => Reference::to(UrlGeneratorInterface::class),
        'currentRoute' => Reference::to(CurrentRoute::class),
    ],
],
  
'yiisoft/yii-view-renderer' => [
    'viewPath' => null,
    'layout' => '@src/Web/Shared/Layout/Main/layout.php',
    'injections' => [
        Reference::to(CsrfViewInjection::class),
    ],
],

Безопасность

Как и в Yii 1.1 и Yii 2.0, мы серьёзно относимся к безопасности. Мы оценивали риски при реализации каждого пакета, будь то слой представления или абстракция базы данных.

Что у нас есть:

• Абстракция контроля доступа

• RBAC для контроля доступа

• JWT-аутентификация

• Абстракция пользователя для приложений

• Middleware для обработки цепочек прокси и заголовков

• Клиент для аутентификации через внешние сервисы

Также есть помощники для общих действий, связанных с безопасностью, таких как пакет защиты от CSRF.

В документации есть специальная страница про безопасность. На уровне проекта есть процессы реагирования на проблемы.

Базы данных

В Yii 2.0 реализован замечательный слой абстракции базы данных. Сначала мы извлекли его в отдельный пакет, а затем переосмыслили и улучшили. В результате получился yiisoft/db, который предоставляет доступ к базе данных, управление схемой и мощный построитель запросов. Дополнительные инструменты и хранилища, такие как миграции, кэширование в базе и т.д., были реализованы поверх DB. Также поверх была сделана более явная, но не менее удобная реализация Active Record.

$posts = $connection
   ->select(['id', 'title', 'created_at'])
   ->from('{{%posts}}')
   ->where(['status' => 'published'])
   ->andWhere(['>', 'views', 1000])
   ->orderBy(['created_at' => SORT_DESC])
   ->limit(10)
   ->all();

Помимо нашего собственного слоя базы данных, вы можете использовать Cycle ORM или Doctrine, делать запросы с помощью PDO или нативных драйверов. Используйте то, что вы предпочитаете. Yii3 не заставляет вас придерживаться какой-то одной реализации.

Абстракция данных

Мощная абстракция данных yiisoft/data и виджеты для неё, такие как grid view, идеально подходят для создания мощных универсальных админок. Абстракция включает форматирование данных, постраничную разбивку, сортировку и возможность использовать любой источник данных с любым представлением и наоборот.

Кэширование

Кэширование стало ещё более продвинутым, чем в Yii 2.0. Во-первых, из коробки есть защита от cache stampede. Во-вторых, драйверы кэша совместимы с PSR-16. Это означает, что вы можете использовать любую реализацию PSR-16 для очень специфичного хранилища, и она будет работать сразу.

Следующие бэкенды уже реализованы нашей командой:

• APCu

• DB

• Files

• Memcached

• Redis

Стандарты прежде всего

Подобно кэшированию, фреймворк использует интерфейсы PSR для многих компонентов:

• Логирование. Вы можете либо использовать логгер Yii, либо заменить его на что-то типа Monolog, если предпочитаете его.

• Middleware. Можете использовать любые решения из Packagist, такие как обработка CORS, без каких-либо изменений в коде.

• Абстракция запроса-ответа, которая даёт оптимальное тестирование и режим worker.

• Даже DI-контейнер может быть либо заменён, либо объединён с другим PSR-совместимым контейнером.

Архитектура, ориентированная на стандарты, гарантирует, что ваш код менее зависим от реализации и у вас есть возможность использовать самые современные PHP пакеты.

Режим Worker

В традиционных PHP-серверах инициализация фреймворка и подключение к базе данных выполняются для каждого запроса, что не очень хорошо для производительности. Yii3 может работать в режиме worker вместе с RoadRunner, Swoole или FrankenPHP. В этом режиме он инициализируется один раз, а затем обслуживает множество циклов запрос-ответ, что даёт значительное сокращение времени отклика.

Хотя этот режим замечательно работает, состояние у нас общее между несколькими циклами запрос-ответ, поэтому разработчики должны позаботиться об его изоляции (или вообще не хранить его) и потенциальных утечках памяти. Yii3 очень помогает в этом: все пакеты были разработаны либо без использования какого-либо состояния, либо с правильным сбросом его при каждом начале запроса.

Всё для классических веб-приложений

Не каждый проект должен быть API с клиентом, поэтому всё для классических серверных веб-приложений также доступно: виджеты, представления с поддержкой шаблонизаторов, таких как Twig, формы, управление ассетами, HTML-хелпер и т.д.

Кроме того, есть готовые к использованию виджеты для Bootstrap 5 и Bulma.

Набор инструментов для создания API

Yii3 предоставляет множество инструментов, которые помогают создавать API:

• Data response, который заботится о представлении данных.

• Поддержка Swagger.

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

HTTP-слой и сеть

Yii3 работает со слоем HTTP на более низком уровне, чем предыдущие версии фреймворка, и при этом следует интерфейсам PSR. Поверх этих относительно низкоуровневых интерфейсов есть удобные абстракции:

• HTTP хелпер, который задаёт коды ответа и многое другое

• Cookies

• Download Response Factory для отправки файлов из приложения

Кроме того, есть сетевые утилиты для работы с IP-протоколом.

Пользовательский ввод и валидатор

В Yii3 есть мощный валидатор на атрибутах, возможность заполнять формы данными из HTTP (input-http) или откуда-либо ещё, инструменты для работы с формами и многое другое.

<?php

declare(strict_types=1);

namespace App\Web\Echo;

use Yiisoft\FormModel\FormModel;
use Yiisoft\Validator\Label;
use Yiisoft\Validator\Rule\Length;

final class Form extends FormModel
{
    #[Label('Сообщение')]
    #[Length(min: 2)]
    public string $message = '';
}

Хелперы

Доступны различные хелперы для упрощения общих задач программирования.

• Arrays

• Files

• JSON

• Strings

• VarDumper

Интернационализация

Поскольку сообщество фреймворка Yii и члены основной команды не из какой-то одной страны, а со всего мира, мы серьёзно относимся к интернационализации и очень хорошо её понимаем.

Из коробки Yii3 имеет:

• Перевод сообщений с форматированием ICU на базе intl.

• Поддержка на уровне представления.

• Поддержка в роутере.

Тестирование

Правильная инверсия зависимостей упрощает юнит-тестирование кода, созданного с помощью Yii3. Следование PSR для запроса и ответа позволяет выполнять API-тестирование без фактического запуска HTTP-сервера.

Чтобы ещё больше упростить тестирование, набор специфичных для тестирования реализаций PSR предоставляется yiisoft/test-support.

Обработка ошибок

Мы ценим время разработчиков. Поэтому уделяем внимание сообщениям об ошибках и странице ошибок. Вы никогда не увидите просто "Error". Сообщения предоставляют контекст. Кроме того, мы сделали ещё лучше придумав «дружественные исключения». В режиме разработки они отображаются информационным блоком, который объясняет, почему произошла ошибка и как её, вероятно, исправить. В будущем мы попытаемся предоставить кнопку, которая автоматически попытается применить исправление.

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

Сам обработчик, yiisoft/error-handler, ещё интереснее, чем в Yii2. Он обрабатывает ошибки нехватки памяти и фатальные ошибки, может сопоставлять определённые типы исключений с пользовательскими исключениями, отвечать в различных форматах и т.д.

Кроме того, есть пакет для интеграции с Sentry.

Документация

Доступны:

• Полное руководство — основное описание использования фреймворка в целом.

• Кулинарная книга сообщества — как сделать что-то с Yii3.

• API-документация для всех пакетов — весь публичный API красиво отрендерен для просмотра

• Readme и документация отдельных пакетов — объясняет, как использовать каждый отдельный пакет

Исключительные стандарты качества

Yii3 поддерживает исключительные стандарты качества кода во всех пакетах. Каждая строка проходит строгую проверку через несколько уровней автоматизированного тестирования и анализа.

Для всех пакетов у нас есть почти 100% покрытие тестами, строгие типы Psalm/PhpStan и близкий к 100% MSI. Каждое изменение кода проходит публичный code review. Все эти меры обеспечивают исключительно стабильную и предсказуемую основу для ваших проектов.

Предсказуемые релизы

Политика релизов — SemVer. Каждый пакет версионируется независимо. Патч-версии никогда ничего не ломают, исправляя ошибки. Минорная версия вводит улучшения и функции, но остаётся совместимой. Мажорная версия вводит несовместимые изменения, требующие обновления кода.

И многое другое

Есть ещё много всяких функций. Менее интересных, но очень важных:

• Алиасы

• События

• Профайлер

• Проверка требований

• Отсылка почты

• Консоль

• Блокировки Mutex с различными бэкендами

Вероятно, мы забыли упомянуть некоторые части фреймворка. Очень уж их много. Исследуйте их самостоятельно и пишите в комментах.

Полезные ресурсы

Ниже приведены некоторые полезные ссылки:

• Посмотрите красивый лендинг здесь.

• Руководство находится здесь. Мы рекомендуем начать с «начало работы».

• API-документация также доступна.

• Пакеты Yii3. Не забудьте поставить им звёзды!

• Группа в Telegram.

• Сайт проекта Yii

• Группа Yii в Facebook

• Каналы Yii в X

• Группа Yii в LinkedIn

Спасибо!

Спасибо за вашу поддержку и терпение! Мы сделали это вместе. Все члены основной команды, участники сообщества и спонсоры.

Мы совершенно уверены, что кодовая база Yii3 будет хорошо служить нам как минимум в течение следующих 10 лет или даже больше.

Планы на будущее:

1. Улучшения руководства и недостающие части.

2. Больше релизов пакетов для обогащения экосистемы и инструментария. Очереди, панель отладки и Gii уже хорошо работают, но мы всё ещё полируем их.

3. Чтение отзывов, исправления и улучшения.

4. Улучшения веб-сайта.

С Новым годом! Наслаждайтесь!