⚡️ #yiisoftRouter

Готовим Yii Router к релизу: подняли уровень psalm до 1 (PR) и удалили интерфейсы CurrentRouteInterface.php, GroupInterface, RouteInterface, RouteParametersInterface (PR).

Удалённые интерфейсы вводились для разделения контекстов использования (конфигурирование и получение данных), но практика показала, что это было неудачное решение (типизация по факту некорректная + интерфейсы вводят в заблуждение). Но, чтобы всё-таки повысить удобство публичного API, мы объединили методы, которые требуются только внутри пакета, и пометили их как @internal:

• в классе Route методы getDispatcherWithMiddlewares(), getName(), getMethods(), getPattern(), getHost(), isOverride(), getDefaults(), hasMiddlewares(), getDispatcherWithMiddlewares() объединены в один getData();

• в классе Group методы getCorsMiddleware(), hasCorsMiddleware(), getMiddlewareDefinitions(), getItems(), getPrefix(), getNamePrefix(), getHost() объединены в один getData();

• в классе CurrentRoute методы setRoute() и setArguments() объединены в один setRouteWithArguments();

• метод CurrentRoute::setUri() также помечен как @internal.

—————

⚡️ #yiisoftRouterFastroute #yiisoftRequestModel #yiisoftYiiDebugApi #yiisoftYiiDataview #yiisoftDocs #yiisoftDemo #yiisoftApp #yiisoftDemoApi

Соответствующие изменения были внесены в документацию (PR), приложения и пакеты:

- Yii Router FastRoute Adapter (PR),
- Yii Request Model (PR, PR),
- Yii Debug API (PR),
- Yii Data Widgets (PR),
- Шаблон веб-приложения (PR),
- Демо веб-приложения (PR),
- Демо API-приложения (PR).

⚡️ #yiisoftDocs

В документации добавили секцию о предзагрузке скриптов в разделе «Настройка производительности» (PR).

⚡️ #yiisoftDocs

В разделе «Стиль кода» документации добавили соглашение об именовании коллекций: классы, интерфейсы, трейты и переменные, являющиеся коллекцией, должны оканчиваться на Collection (PR).

⚡️ #yiisoftDocs

В документацию добавили соглашение о поддерживаемых версиях PHP (PR).

Версии PHP, поддерживаемые пакетами и шаблонами приложений, зависят от жизненного цикла версий PHP.

• Версии пакетов с активной поддержкой ДОЛЖНЫ поддерживать все версии PHP, которые находятся в стадии активной поддержки.

• У пакетов и шаблонов приложений ДОЛЖНЫ быть версии получающие исправления ошибок и проблем безопасности, поддерживающие версии PHP, которые находятся в стадии поддержки безопасности.

• Пакеты и шаблоны приложений МОГУТ иметь поддерживаемые версии, которые работают с неподдерживаемыми версиями PHP.

• Поднятие минимальной версии PHP в пакете или шаблоне приложения считается минорным изменением.

• Исключение: пакеты и шаблоны приложений МОГУТ не поддерживать PHP 7.4.

⚡️ #yiisoftDocs

В документации зафиксировали соглашение об использовании атрибутов PhpStorm (PR).

Атрибуты PhpStorm МОГУТ использоваться в коде, но пакет jetbrains/phpstorm-attributes ДОЛЖЕН быть добавлен как dev-зависимость.

⚡️ #yiisoftDocs

В документации актуализировали примеры кода в статье о доверенных запросах (PR).

⚡️ #yiisoftDocs

В документации добавили новое соглашение: в composer.json в качестве логического оператора ИЛИ в диапазонах версий должна использоваться одиночная вертикальная черта | (PR).

⚡️ #yiisoftDocs

Во внтуренней документации добавили новое соглашение по логу изменений: теперь имена авторов будут указываться с @ и, соответственно, на GitHub будут отображаться ссылками на профиль (PR).

⚡️ #yiisoftDocs

В документации добавили инструкцию по релизу пакетов (PR).

🔥 #Новости #yiisoftDemo #yiisoftDemoApi #yiisoftDocs #yiisoftPackageTemplate #yiisoftYiiDevTool

Часть пакетов была помечена как "внутренние" и теперь не учитывается на странице с текущим состоянием разработки пакетов Yii3.

Пакеты, к которым был добавлен тег internal:
- Демо веб-приложения,
- Демо API-приложения,
- Документация,
- Yii Package Template,
- Yii Development Tool.

⚡️ #yiisoftDocs

В документации добавили соглашение о стиле кода для методов, вызываемых «цепочкой» (commit).

⚡️ #yiisoftDocs

В документации актуализировали ссылки в кодексе поведения (PR).

⚡️ #yiisoftDocs

В документации актуализировали ссылки на yiiframework.com (PR).

⚡️ #yiisoftDocs

В документации актуализировали ссылки на внешние ресурсы (PR).

⚡️ #yiisoftDocs

В документации актуализировали ссылки на внешние ресурсы (PR).

⚡️ #yiisoftDocs

В документации исправили битые ссылки на страницы OWASP Foundation (PR).

⚡️ #yiisoftDocs

В документации добавили ссылку на англоязычный телеграм Yii3 (PR).

⚡️ #yiisoftDocs

В документации добавили соглашение об использовании верблюжьей (camelCase) нотации для имён классов, методов, переменных и т. д. (PR).

⚡️ #yiisoftDocs

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

Exception: PHP 7.4 MIGHT not be considered.