Yii3. _

Разрабатывается сообществом

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

Вклад сообщества очень приветствуется. Мы стараемся обрабатывать его как можно скорее, проводя code review и предоставляя обратную связь, доводя код до соответствия общему качеству фреймворка.

Со временем активные участники присоединяются к нашей команде.

Дружелюбное и полезное сообщество — одна из наших целей.

17 лет опыта

Yii3 — это опыт, накопленный, с 2008 года, когда была выпущена первая версия Yii.

• Лучшие идеи и принципы Yii 1.1 и Yii 2.0, воплощенные в современных решениях.
• Надёжный фундамент, который будет работать десятилетиями.
• Возможность быстро создавать прототипы и превращать их в стабильные поддерживаемые продукты.

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

Yii3 предоставляет проверенные шаблоны приложений для различных типов проектов: традиционных веб-приложений, REST API сервисов и консольных утилит. Установите и запустите их не тратя время на настройку инфраструктуры.

Доступные шаблоны:

• Веб-приложение — полнофункциональный шаблон с роутингом, представлениями и ассетами.
• API-приложение — оптимизировано для REST/JSON API с аутентификацией.
• Консольное приложение — CLI-инструменты и фоновые воркеры.

Установите любой шаблон мгновенно:

composer create-project yiisoft/app my-project
cd my-project
make up  # Окружение Docker запускается сразу

Возможности «из коробки»:

• Docker-окружение с веб-сервером Caddy.
• Раздельные точки входа для веба и консоли.
• Организованная структура.
• Настроенный роутинг, middleware и DI-контейнер.
• Управление ассетами и инструменты сборки.
• Конфигурация на основе окружения (dev/test/prod).
• Наборы тестов PHPUnit и Codeception.

Шаблоны следуют современным лучшим практикам и методологии 12-факторного приложения. Вы можете свободно настраивать всё под свои нужды.

Явный DI-контейнер

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

Конфигурация проста и поддерживает различные стили объявления:

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
    ) {}
}

Никаких антипаттернов Service Locator, никаких скрытых зависимостей — только чистый, тестируемый код с явными контрактами.

Мощный DBAL

Yii3 предоставляет надежный уровень работы с базами данных, включающий удобный построитель запросов, реализацию паттерна Active Record и комплексное управление схемами. Работайте напрямую с запросами для производительности или используйте Active Record для удобства.

Неизменяемый (immutable) построитель запросов предлагает выразительные и типизированные операции с БД:

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

Команды предоставляют чистый API для манипуляции данными, включая upsert, пакетные операции и транзакции. Active Record обеспечивает возможности ORM с отношениями, жадной загрузкой и автоматической валидацией. Миграции позволяют версионировать схему данных.

Множество СУБД поддерживаются из коробки. Опционально можно интегрировать Cycle ORM или Doctrine для сложных случаев.

Богатая экосистема пакетов

Yii3 предоставляет комплексную экосистему готовых к использованию пакетов, покрывающих практически любые потребности веб-приложения. Все пакеты следуют единым стандартам качества с полным покрытием тестами и соблюдением PSR.

• Базы данных и хранение — поддержка множества БД с построителем запросов и ORM, миграции схем, пулы соединений и управление транзакциями.
• Кэширование — гибкий уровень кэширования с адаптерами для популярных хранилищ, включая память, распределенные кэши и файлы.
• Безопасность и контроль доступа — полноценные системы аутентификации и авторизации с RBAC, управлением правами и безопасной обработкой паролей.
• Валидация — мощный фреймворк валидации с обширным набором встроенных правил, пользовательскими валидаторами и условной валидацией.
• Гидрация — наполнение объектов данными (hydration) для преобразования массивов в типизированные объекты и наоборот, обеспечивая безопасность типов.
• Рендеринг представлений — поддержка различных шаблонизаторов, макеты (layouts), частичные представления (partials), система виджетов и управление ассетами.
• Обработка данных — форматирование данных, пагинация, сортировка и абстракции провайдеров данных для единообразной работы с разными источниками.
• Утилиты — инструменты для работы с массивами, строками, файлами, JSON, генерации HTML и сетевых операций.

Каждый пакет имеет независимую версию, тщательно задокументирован и доступен в Packagist. Устанавливайте только то, что вам нужно.

Worker Mode

Традиционный PHP инициализирует фреймворк при каждом запросе, потребляя много ресурсов. Yii3 поддерживает режим работы с циклом событий (event loop), где воркеры обрабатывают множество запросов без повторной инициализации, что резко повышает производительность.

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

Совместимость с RoadRunner, Swoole и FrankenPHP из коробки.

Современный PHP

Yii3 полностью использует возможности современного PHP, поддерживая версии с 8.2 по 8.5 и активно применяя современные языковые конструкции для более чистого, безопасного и поддерживаемого кода.

Readonly-классы и property promotion в конструкторе избавляют от шаблонного кода:

final readonly class UserService
{
    public function __construct(
        private UserRepository $users,
        private LoggerInterface $logger,
        private CacheInterface $cache,
    ) {}
 
    public function findByEmail(string $email): ?User
    {
        return $this->cache->getOrSet(
            "user:$email",
            fn() => $this->users->findByEmail($email)
        );
    }
}

Строгие объявления типов по всему фреймворку позволяют отлавливать ошибки на этапе компиляции. Атрибуты обеспечивают функциональность на основе метаданных. Генераторы оптимизируют использование памяти для больших наборов данных. Именованные аргументы улучшают читаемость конфигурации.

Кодовая база демонстрирует лучшие практики современного PHP, служа эталоном для написания современных и безопасных приложений.

Стандарты PSR

Yii3 активно использует интерфейсы PSR, что позволяет вам переиспользовать наработки PHP-сообщества и даже заменять реализации ядра при необходимости. Фреймворк обеспечивает гибкость без привязки к конкретному вендору.

Например, обработка HTTP использует PSR-7 (запросы/ответы) и PSR-15 (middleware):

use Psr\Http\Message\ResponseInterface;
use Psr\Http\Message\ServerRequestInterface;
 
final readonly class PostAction
{
    public function view(ServerRequestInterface $request): ResponseInterface
    {
        $response = $this->responseFactory->createResponse();
        $response->getBody()->write('Превед!');
        return $response;
    }
}

Логирование следует PSR-3, кэширование реализует PSR-16, а внедрение зависимостей — PSR-11. Это означает, что вы можете легко подключить Monolog для логов, любой PSR-16 адаптер кэша или интегрировать стороннее PSR-15 middleware без лишних усилий.

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

Открытая экосистема PHP

Yii3 использует всю экосистему PHP вместо того, чтобы «изобретать велосипед». Построенный на стандартах PSR и Composer, фреймворк плавно интегрируется с любой PHP-библиотекой, не навязывая закрытых решений.

Используйте любые Composer-пакеты:

composer require monolog/monolog
composer require league/flysystem
composer require symfony/mailer

Все пакеты работают сразу благодаря автозагрузке PSR и внедрению зависимостей. Нужен Monolog для логов? Doctrine как ORM? Компоненты Symfony? Просто установите и используйте их.

Заменяйте реализации ядра: благодаря интерфейсам PSR вы можете менять встроенные компоненты на альтернативные. Используйте Twig вместо стандартного шаблонизатора, Redis вместо файлового кэша или любую реализацию PSR-3 логгера.

Создавайте и делитесь пакетами: создавайте переиспользуемые компоненты как Composer-пакеты и публикуйте их в Packagist. Фреймворк не ограничивает вас проприетарными форматами — ваш код остается переносимым между проектами.

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

Проверенное качество

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

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

Комплексные юнит-тесты покрывают все компоненты системы, гарантируя, что обновления и изменения не нарушат существующую функциональность. Изменения проверяются автоматически перед выпуском.

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

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