PHP Versions

PHP Versions

The platform supports several PHP engine releases. You can select the required version while creating an environment and switch an existing PHP layer to another supported version through container redeployment.

In this article

Supported PHP Versions

PHP 8.1PHP 8.1.33
PHP 8.2PHP 8.2.31
PHP 8.3PHP 8.3.31
PHP 8.4PHP 8.4.22
PHP 8.5PHP 8.5.7
i

Versions are updated regularly

The current platform release list is maintained in the Software Stack Versions document, which is updated weekly. Check it before creating or redeploying a production environment.

Select PHP for a New Environment

1

Open the environment wizard

Click New Environment in the top dashboard panel.

Open the New Environment wizard
Open the Environment Wizard from the dashboard.
2

Select the PHP stack

Open the PHP tab, choose the preferred application server, and select the required PHP engine version from the second drop-down list.

Select a PHP engine version in the topology wizard
Choose the PHP application server and required engine version.
3

Complete the environment settings

Specify resource limits, select the preferred region, enter an environment name or keep the generated one, and click Create.

Change PHP in an Existing Environment

1

Open container redeployment

Click the Redeploy containers icon beside the PHP application-server layer.

PHP container redeploy button
Start redeployment from the PHP application-server layer.
2

Select the target engine version

Choose the required PHP release from the Tag list in the redeployment window.

3

Confirm redeployment

Click Redeploy to apply the selected PHP version.

Select a PHP version during container redeployment
Choose the required PHP tag and confirm the redeployment.
✓

Check application compatibility

Before switching PHP in production, confirm that the application, extensions, Composer dependencies, framework, and startup configuration support the selected version.

Expected Result

A new PHP environment is created with the selected engine version, or an existing PHP application-server layer is redeployed to the selected supported PHP tag.

Important Notes

  • The exact supported patch versions can change through regular platform updates.
  • Back up production applications and configuration before changing the PHP version.
  • Redeployment can temporarily interrupt a single-node application.
  • Review PHP extensions and modules after changing major PHP versions.
  • Check application and server logs after redeployment.
  • The source documentation notes that moving to PHP 7 from older versions may require manual activation of modules that became dynamic.

Common Issues and Solutions

Required PHP version is unavailableCheck the Software Stack Versions document and the hosting provider’s current stack availability.
Application fails after redeploymentReview framework compatibility, Composer requirements, extensions, deprecated functions, and PHP logs.
PHP module is missingCheck whether the module must be enabled manually for the selected PHP version.
Redeploy action is unavailableConfirm that no other environment operation is currently running.
Application is temporarily unavailableUse a scaled environment and sequential management where supported to reduce downtime.

What’s Next?