PHP version readiness check issues

This article talks about the solutions for the PHP version issues you might face when installing/upgrading Adobe Commerce on-premises using the Web Setup Wizard.

Affected products and versions

• Adobe Commerce on-premises 2.2.x, 2.3.x
• Magento Open Source 2.2.x, 2.3.x

Unsupported PHP version

Issue

The check fails because you are using an unsupported PHP version.

Solution

To solve this issue, use one of the supported versions listed in our developer documentation 2.3.x System Requirements and 2.2.x System Requirements.

PHP readiness check does not display

Issue

The PHP readiness check doesn’t display the PHP version as the following figure shows.

Solution

This is a symptom of incorrect cron job setup. For more information, see Set up cron jobs in our developer documentation.

Incorrect PHP version

Issue

The check reports the incorrect PHP version. Typically, this happens only to advanced users who have multiple PHP versions installed. In some cases, the readiness check fails; in other cases, it might pass.

If the PHP version reported by the readiness check is incorrect, it’s the result of a mismatch of PHP versions between the PHP CLI and the web server plug-in. Adobe Commerce requires you to use one version of PHP for both the CLI (which runs cron) and the web server (which runs the Commerce Admin, Component Manager, and System Upgrade).

Solution

We assume that if you have this issue, you’re an advanced user who has likely installed multiple versions of PHP on your system.

To resolve the issue, try the following:

• Restart your web server or php-fm.
• Check the $PATH environment variable for multiple paths to PHP.
• Use the which php command to locate the first PHP executable in your path; if it’s not correct, remove it or create a symlink to the correct PHP version.
• Use a phpinfo.php page to collect more information.
• Make sure you’re running a supported PHP version according to our system requirements, in our developer documentation:
  • Adobe Commerce 2.3.x System Requirements
  • Adobe Commerce 2.2.x System Requirements
• Set the same PHP settings for both the PHP command line and the PHP web server plug-in as discussed in PHP configuration options in our developer documentation.