Compatibility and migration

The published v1.1.0 tag requires triangle/engine:^8.1. The prepared next major, 2.0.0, requires triangle/engine:^9.0 and targets Engine 9 with Localzet Server 7. PHP 8.1 remains the minimum. These major versions cannot share one Composer dependency graph.

Release 2.0.0 has not been published. Check the package version resolved by your lock file and the repository first.

Application changes

AreaPrevious integration contractEngine 9
ComposerThe package depended on Engine 8Dependency is triangle/engine:^9.0; do not mix it with the previous package in one lock file.
Multipart fileControllers expected a legacy upload object and read from the global requestEngine returns Triangle\Engine\File; the controller validates its type, upload status, and client filename from the current Request.
Form fields and tokenRead through the global request helperToken, file, and URL are read from the injected request object.
Client IPRequired an application helperUses Request::getRequestIp(); forwarding headers are considered only from trusted proxies.
Project registrationEnabled in the template configurationDisabled for new installations (project_registration = false).
ImageMagickTransformation output dimensions were not consistently boundedFrame count, total pixels, and processing resources are limited.

Migration sequence

  1. Move the application to Engine 9 and a compatible Server 7 release.
  2. Update Composer dependencies in a separate branch and inspect the resolved composer.lock.
  3. Review proxy configuration so only trusted peers can supply forwarded client IP headers.
  4. Check the installed project_registration value. Install::install() preserves existing settings, so an old true value remains after upgrade.
  5. Connect the Engine database and storage adapters, add test templates, and run application-level integration requests.

Do not copy dependency versions between old and new applications. The application's Composer lock file is the source of truth for the resolved versions.