Новости Yii 2021, выпуск 3

Привет, сообщество!

Это в очередной раз Александр и новости про PHP фреймворк Yii. Выпусков не было довольно долго, но это не потому, что ничего не происходит, а как раз наоборот: происходит всё и сразу. Над Yii3 работать всё приятней так как пакеты стабилизируются, а фреймворк становится более полным.

Фонд

Мы поучаствовали в эксперименте FundOSS по усилению финансирования OpenSource. Всего нас поддержали 49 человек на $813. FundOSS добавили до $3295 (минус комиссия Stripe). Это довольно хорошая сумма, которая позволит нам какое-то время выделять больше времени на развитие фреймворка. Спасибо, FundOSS, OpenCollective и, конечно, тем, кто нас поддерживает. Хочется, чтобы подобные эксперименты проводились почаще.

Сообщество

• Мы запустили пред-релизную поддержку компаний через Telegram.

• Канал IRC переместился в libera.

• Был запущен экспериментальный канал #yii3chronicles в Telegram. Там мы рассказываем о том, что происходит прямо сейчас.

Дизайн и сайт

В прошлый раз я упомянул что компания awesomic пригласила нас использовать сервис бесплатно в качестве благодарности за Yii 2. С тех пор мы кое-чего успели. На странице "official logos and design" главного сайта можно найти логотипы, favicon-ы, общие гайдлайны и стандарт для диаграмм.

Также прямо на главную страницу добавлена ссылка "Looking for Yii 3 progress?". Надеюсь, это ещё немного разогреет интерес к Yii3 и выльется в прирост issue и pull request.

​ Yii 1

Был выпущен Yii 1.1.24. Поддержка первой ветки фреймворка продлена до 31.12.2023.

​ Yii 2

Готов большой набор обновлений:

• Yii 2.0.43.

• Auth client 2.2.11.

• Bootstrap 2.0.11.

• Debug 2.1.18.

• ElasticSearch 2.1.2.

• Gii 2.2.3.

• HTTP Client 2.0.14.

• MongoDB 2.1.12.

• Smarty 2.0.10.

• Шаблоны приложений обновлены до Bootstrap 4.

• Релизнуто расширение для Bootstrap 5.

• Образы Docker обновлены до XDebug 3.

В пакете для генерации документации по API выявлены серьёзные проблемы с PHP 8. Мы работаем над этим. А пока используйте для генерации документации PHP 7.

​ Yii 3

​ Релизы пакетов:

• Yii event.

• Error handler.

• Assets.

• Rate limiter.

• Data response.

• View.

• Yii view.

• View Twig renderer.

• Mailer и адаптер для SwiftMailer.

• Email log target.

• Cookies 1.2.0.

• Translator 1.0.0 и связанные пакеты.

• Rate limiter 2.0.0.

• Mutex и адаптеры 1.0.0.

Я решил пока не заносить в список патч-релизы и не создавать на сайте новости про них. Это отнимает время, а контент там получается не сильно интересный.

Немного пакетов убили:

• yiisoft/serializer.

• yiisoft/container-proxy.

• yiisoft/yii-debug-frontend (смотрите далее в секции "Debugger").

Сейчас главный фокус команды — yiisoft/factory и yiisoft/di. Они блокируют 11 и 31 релиз других пакетов соответственно.

Инфраструктура

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

Yii Config теперь требует Composer 2. Первая версия Composer не видит свежие пакеты на packagist и не позволяет поставить Yii 3.

Yii development tool

В процессе разработки встречаются разные неудобства при использовании инструментария разработки, которые мы исправляем:

• Была добавлена команда list, которая показывает активные пакеты.

• Симлинки больше не создаются для неактивных пакетов.

• Пакеты обрабатываются в алфавитном порядке.

• Стало возможно работать с любыми пакетами, а не только с пакетами yiisoft.

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

Мы переименовали "yii-demo" в просто "demo". На данный момент набор приложений и демо получается следующий:

• yiisoft/demo - Классическая демка. HTML генерируется сервером.

• yiisoft/demo-api - Демка REST API.

• yiisoft/app - Шаблон приложения с классической генерацией HTML.

• yiisoft/app-api - Шаблон приложения с REST API.

Минимальная версия PHP для всех шаблонов и демо поднята до PHP 8.0. Пакеты в этом плане остались без изменений и требуют 7.4+ так как могут использоваться отдельно.

Добавлена возможность прописывать бутстрап в config/bootstrap.php, config/bootstrap-web.php и config/bootstrap-console.php. Туда можно добавлять такие callable, как function (ContainerInterface $container): void. Они запустятся на старте приложения.

Добавлена команда composer run serve. Делает то же, что и ./yii serve.

В общем несколько упростилась структура директорий. Мы работаем над тем, чтобы сделать её ещё проще.

DI и Factory

Как DI, так и factory сейчас блокируют релизы остальных пакетов, так что мы занимается, прежде всего, ими. Делается много рефакторинга и доработок:

• Оба пакета стали более строгими. Добавили валидацию в режиме разработки, убрали много способов задавать defintion-ы.

• Сообщения об ошибках стали более информативными.

• Сильно улучшили покрытие кода тестами.

Контейнер:

• Удалили контекстный контейнер и delegate lookup. Они дублировали функции композитного контейнера.

• Сделали сервис-провайдеры вместо предыдущих провайдеров (DeferredServiceProvider и ServiceProvider). Они навеяны container-interop, но не полностью повторяют его потому как в черновике стандарта были проблемы.

• Внутренний формат хранения definition-ов переделан для удобной отладки.

• Добавлены ReferencesArray и DynamicReferencesArray. Это позволило немного упростить конфиги.

Фабрика:

• В Factory::create() остался только один аргумент, definition класса, который необходимо создать.

• Фабрика больше не реализует PSR ContainerInterface. Factory::get() и Factory::has() были удалены.

• Добавлено определение циклических ссылок.

Очереди

• Упростили конфигурацию для простых случаев. Достаточно настроить брокер AMQP, а остальное заработает само.

• Стало удобней настраивать каналы.

• Адаптер AMQP теперь делает ack обработанным сообщениям.

HTML

Готовим 2.0.0. Будут новые теги, оптимизация генерируемого HTML и улучшение API.

Middleware dispatcher

Пакет практически готов к релизу. Мы ещё проверяем альтернативные идеи по его дизайну, но и текущий почти идеален.

• Пакет обзавёлся инструкциями в readme.

• Сильно повышена производительность. Middleware создаются только когда необходимо и кэшируются в памяти, что особо актуально для RoadRunner и Swoole.

Валидатор

Синтаксис валидаторов изменён:

// до
(new Number())->integer()->min(44);

// после
Number::rule()->integer()->min(44);

Yii Sentry

Создан пакет интеграции с Sentry. Sentry - сервис агрегации логов. Позволяет эффективно мониторить логи с продакшна. Поддерживаются и веб, и консоль.

Виджеты

• Теперь используем friendly exception-ы.

• Обновлена документация как у widget, так и у Yii widgets.

• Все виджеты Yii стали иммутабельными.

• Улучшено покрытие тестами и общее качество.

• Сильно почистили виджеты Bulma.

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

• Friendly exception-ы теперь выглядят приятней.

• Мы решили поддерживать markdown и описать это в интерфейсах.

• Исключения в консоли теперь нормально пишутся в лог.

Конфиги

• Добавлена поддержка окружений.

• Улучшено отслеживание конфигов при добавлении и удалении пакетов. Хэши хранятся в файле dist.lock.

• Обновлена документация.

Дебаггер

После того, как мы убили версию под Angular получился следующий набор пакетов:

• yiisoft/yii-debug собирает отладочную информацию из вашего приложения.

• yiisoft/yii-debug-api раздаёт собранное через REST API.

• yiisoft/yii-debug-viewer - новый клиент, который можно использовать и как подключаемый модуль и как отдельное приложение. Добавлять свои панель сильно проще, чем в версии под Angular. По сложности сравнимо с Yii2.

Viewer добавлен в шаблоны приложений и демо и доступен как http://127.0.0.1:8080/debug/viewer, где 127.0.0.1:8080 - ваши локальные хост и порт.

Роутер

Были проведены как внутренний рефакторинг, так и изменения во внешнем API.

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

• Пользователю видно сильно меньше внутренностей.

• Текущий роут доступен через отдельный сервис Yiisoft\Router\CurrentRoute.

• Добавлена возможность задавать хост для группы через Group::host().

• Добавлена возможность задавать префикс для имени роута для всей группы Group::namePrefix().

​ Новая и обновлённая документация

• 020 - Package release criteria.

• 021 - Changelog and upgrade.

Также полностью обновлено руководство и README большинства пакетов.

​ Почитать и посмотреть

• Introduction to the MVC programming paradigm through Yii2.

• Real World Benchmark PHP Routing.

• More Real World PHP Routing Benchmarks.

• Benchmark PHP Routing with Yii 2 results. We use FastRoute in Yii3.

• A demo of Temporal + Yii3.

• C4, Diagrams as Code & Architectural Joy.

• Tactician got Yii support.

• NoColor — validate the architecture of your PHP project.

• Composer sunsetting the PHP Version Stats Blog Series and Yii2 stats.

• Don't test constructors.

• PHP-FPM tuning: Using "pm static" for max performance.

• Microservice Architecture.

• Xdebug 3 videos.

• samdark reviewing Yii issues.

​ Спасибо!

Хочу сказать спасибо всем спонсорам и разработчикам, благодаря которым стала возможна разработка Yii 3. Вместе у нас всё получится!

• CraftCMS - Отличная OpenSource CMS на Yii2.

• Onetwist Software - Услуги качественной разработки приложений.

• SkillShare - Обучение новым навыкам.

• Betteridge - Ювелирные изделия.

• dmstr - Облачные решения на основе Docker.

• HumHub - OpenSource решения для общения команды.

• JetBrains - Отличные инструменты для разработки.

• Skin.Club - Рынок скинов для CS:GO.

• EFKO Group - фудтех, производство продуктов питания, и венчурные инвестиции. С недавнего времени ещё и ЭФКО Цифровые Решения, отдельная растущая сервисная IT-компания, которая планирует заниматься не только внутренними проектами ЭФКО.

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

​ Отдельное спасибо тем, кто помог Yii 3 кодом:

• Evgeniy Zyubin.

• Sergei Predvoditelev.

• yiiliveext.

• Wilmer Arambula.

• Rustam Mamadaminov.

• Dmitry Derepko.

• Mehdi Achour

• Valerii Gorbachev.

• Viktor Babanov.

• Anton Samoylenko.

• Toir Tuychiev.

• Alexander Nekrasov.

• Tarek K. Ajaj.

• Leonid Chernenko.

• Maksym Storchak.

• Aleksei Gagarin.

• Alexey Kopytko.

• Andrii Vasyliev.

• Razon Yang.

• Somogyi Márton.

• mj4444.

• Dmitry Egorov.

• Mister 42.

• ditibal.

• Igbanam Ogbuluijah.

• Julian Schmidt.

• kafkiansky.

• Alexey Chernousov.

• Carsten Brandt.

• Roman Tsurkanu.

• Marko Kaznovac.

• Andrey Skugarev.

• Tobias Munk.