Совместимость и переход

Основная версия Engine определяет поддерживаемую основную версию Localzet Server и контракты глобальных helpers. Устанавливайте согласованный набор компонентов.

Triangle EngineLocalzet ServerСовместимость
9.0.07.1+Текущая версия; поддерживаемая связка для новых приложений
8.1.114.xПредыдущая версия; используйте только в приложениях, которые остаются на Server 4

Релизы: Engine 9.0.0, Engine HTTP 3.0.0, Engine WS 2.0.0.

Что изменилось

ОбластьEngine 8.1.11 + Server 4Engine 9.0.0 + Server 7.1
ComposerПакет Engine требует localzet/server версии 4Engine требует localzet/server версии 7.1 или новее в рамках 7.x
PHPТребования зафиксированы старым манифестом Engine 8PHP 8.1+, ext-intl и ext-json
Глобальный response()В зависимости от порядка загрузки мог разрешаться в helper EngineHelper Server возвращает HTTP Response
Глобальный json()Возвращал JSON-строкуHelper Server создаёт JSON Response
Глобальный redirect()Helper Engine мог конфликтовать с уже загруженной функциейHelper Server создаёт Response и удаляет CR/LF из Location
Helpers EngineИмена пересекались с глобальными функциямиДля контракта Engine используйте triangle_response(), triangle_json() и triangle_redirect()
Контекст обработчикаВыбор ключа зависел от event loop class Server 4Активный PHP Fiber используется для изоляции interleaved обработчиков

responseJson() вызывает JSON-кодировщик Engine напрямую: объект Server Response не передаётся туда, где ожидается строка тела. Перед обновлением найдите вызовы response(), json() и redirect() и проверьте требуемый ими тип результата.

Переход на Engine 9

  1. В тестовой ветке обновите Server до версии 7.1 и Engine до 9.
  2. Если приложению нужен HTTP, установите Engine HTTP версии 3; для WebSocket установите Engine WS версии 2. Эти адаптеры нельзя устанавливать вместе.
  3. Обновите Router и Middleware до версии 2; Composer разрешит их транзитивно.
  4. Выполните composer update и проверьте composer.lock, затем запустите тесты приложения.
  5. Проверьте запуск, обработку ошибок, cleanup Context, TLS, таймеры, пользовательские процессы и сетевые интеграции.
  6. Переключайте production только после прохождения CI и интеграционных проверок самого приложения.
composer require localzet/server:^7.1 triangle/engine:^9.0
composer show triangle/engine
composer show localzet/server
composer check-platform-reqs

Engine 8.1.11 не поддерживает Server 7. Engine 9 не предназначен для Server 4. Не обновляйте только один пакет, оставляя другой на несовместимой основной версии.

English

See the English compatibility and migration table.