PHP Upgrade Guide

From WHMCS Documentation

Use this guide to upgrade the PHP version that you use to run WHMCS. WHMCS 8.0 and higher requires PHP 7.2 or later, so upgrading to PHP 7.2 or later is required in order to upgrade to WHMCS 8.0. You won't see WHMCS 8.0 in the Automatic Updater if you do not run PHP 7.2 or PHP 7.3.

While WHMCS 7.10 and earlier don't support it, we recommend upgrading to PHP 7.4 after you successfully upgrade to WHMCS 8.0. For more about the upgrade process, see Updating.

  • For steps to migrate to previous PHP versions, see the PHP 7 Migration Guide.
  • For a full index of PHP compatibility by WHMCS version, see the PHP Compatibility Guide.

Before you upgrade

Before you upgrade PHP, we recommend that you:

  • If you upgraded PHP, make sure that IonCube Loader 10.1 is still properly installed.
  • Run the PHP Version Compatibility Utility at Utilities > System to locate any ionCube-encoded files that won't work with a higher version.
  • Ensure the compatibility of any custom or third-party code by checking the relevant listings in the WHMCS Marketplace.

Upgrade using cPanel's MultiPHP

If you use cPanel and EasyApache 4 to host your WHMCS installation, you can use MultiPHP Manager and MultiPHP INI Editor to change your PHP version.

Other Control Panels
For other control panels or systems, consult the vendors' documentation.

To upgrade PHP on cPanel:

  1. Log in to your cPanel account.
  2. Go to Software >> MultiPHP Manager.
  3. Check the box for the domain for your WHMCS installation.
  4. Select PHP 7.2 or 7.3 from PHP Version in the top-right corner of the page.
  5. Click Apply.
  6. Go to Software >> MultiPHP INI Editor.
  7. Click Editor.
  8. Select your domain from Select a location. A php.ini file (or a blank file if you don't have a php.ini file yet) will appear.
  9. Add these lines to the file:
    php_admin_flag[allow_url_fopen] = 1
    php_admin_flag[memory_limit] = 128M
  10. Click Save.
  11. Log in to your WHMCS installation to ensure that there aren't any errors.

You're now ready to upgrade to WHMCS 8.0.

Errors

After you upgrade, the following errors could indicate an incompatibility with the new PHP version:

  • A 500 internal server error
  • A blank page
  • An oops error page

See our PHP Troubleshooting Guide for steps to debug and resolve these issues. For an immediate solution, reverting to the previously-installed PHP version should allow you to keep using WHMCS.