Upgrade to PHP 8.5

This document describes how to upgrade PHP to version 8.5. This upgrades the version in Docker environment and composer.json.

1. Check project code for PHP compatibility using PHPCompatibility

To make sure your project is compatible with PHP 8.5, follow the steps:

1. Require the php-compatibility package:

composer require --dev phpcompatibility/php-compatibility --ignore-platform-reqs

2. Configure phpcs to use php-compatibility rules:

vendor/bin/phpcs --config-set installed_paths vendor/phpcompatibility/php-compatibility

3. Execute the php-compatibility sniffer for PHP 8.5:

vendor/bin/phpcs -p src/ --standard=PHPCompatibility  --runtime-set testVersion 8.5

This returns the code that’s not compatible with PHP 8.5.

4. Fix all the discovered incompatibilities.

2. Check and resolve incompatible dependencies

1. Identify any dependencies that are not compatible with PHP 8.5:

composer why-not php 8.5

The command listed dependencies that are not compatible with PHP 8.5, along with the reasons why they can’t be upgraded.

2. Update dependencies. Check if there are newer versions of these dependencies that support PHP 8.5. You can do this by visiting the package’s repository or checking its documentation. If updates are available, update your composer.json file to require these newer versions.

3. Resolve conflicts. If newer versions are not available, you may need to find alternative packages that are compatible with PHP 8.5. Search for alternative packages on Packagist or other package repositories.

Pay particular attention to static analysis and testing tools. Because they run on the same PHP version as your application, an outdated analyzer can fail on a new PHP minor even when your own code is fine.

3. Update composer.json

1. Set the minimum required PHP version to 8.5:

"require": {
  "php": ">=8.5",
}

2. Define PHP 8.5 as the platform version for dependency resolution:

"config": {
  "preferred-install": "dist",
  "platform": {
    "php": "8.5.0"
  },

3. Update dependencies:

composer update

This updates the dependencies to the latest versions that are compatible with PHP 8.5.

4. Update Docker configuration

1. In all deploy.yml files, update the PHP image:

image:
    tag: spryker/php:8.5
    environment:

2. Apply the changes by restarting the application:

docker/sdk boot && docker/sdk up --build

5. Resolve common PHP 8.5 deprecations

The deprecations below are the ones most likely to appear in a Spryker-based project. They are new in PHP 8.5: on PHP 8.3 and 8.4 the same calls emit nothing at all.

Several of them concern calls that stopped having any effect in an earlier release—the notice itself states both dates, for example deprecated since 8.5, as it has no effect since PHP 8.1. Because such a call is already a no-op, removing it changes no behavior, and the fix is valid on PHP 8.3 and 8.4 as well. You can therefore clean these up before switching versions.

Deprecations emit an E_DEPRECATED notice and keep working, so they do not break your application, but they flood your logs and hide real problems.

For the complete list, see Deprecated Features PHP 8.5.

6. Test the upgrade

Thoroughly test your application to identify any issues because of the PHP version upgrade:

• Automated tests: Run unit, integration, and functional tests.
• Manual testing: Test critical application functionality.
• Monitor for deprecations: Check for deprecation notices or warnings that may arise from running on PHP 8.5.