PHP upgrade failure troubleshooting

Overview

When upgrading the PHP version of your website in the panel, you may see an Unsuccessful message. This article offers you a few troubleshooting tools to help determine where the error is coming from.

WordPress sites

wp-cli is a command line tool that allows you to run WordPress commands from your server. The following command will test all installed WordPress items with PHP 8.0 and above to see if they are compatible.

  1. Log into your server via SSH.
  2. Make sure you're in your website directory.
  3. Run the following command.
    [server]$ wp php-compat --php_version=8.0 

This command may take a few minutes to finish.

Replace 8.0 with a different PHP version you'd like to test.

All other PHP-based sites

If there is an index.php file in the domain directory, run the following command to test the site on PHP 8.0:

  1. Log into your server via SSH.
  2. Make sure you're in your website directory.
  3. Run the following command.
    [server]$ /dh/cgi-system/php80.cgi index.php

Replace 8.0 with a different PHP version you'd like to test.

You can also test other .php files using this same command. Most often, this will output errors pointing to the exact file with outdated code.

Check PHP and error log

PHP log

You can manually enable PHP error logging on your PHP website to catch any errors that may not be recorded by default.

Error log

You should also check your website's general error log for additional errors.

Check if your software is compatible with PHP 8

If your website is using CMS software, check its version to see if it is compatible with PHP 8. If not, it may need to be manually upgraded.

Concrete CMS - (formerly Concrete5)

Version 9 is compatible with PHP 8

Joomla

Version 4+ is compatible with PHP 8

MediaWiki

Versions 1.39 is compatible with PHP 8

phpBB

Versions 3.3.10 is compatible with PHP 8

You can locate the version in your admin area. It is also located in a file located at:

example.com/phpbb/docs/CHANGELOG.html

ZenCart

Version 1.5.7 compatible with PHP 8

Contact Professional Services for help

If your website is using old software, or if it was built a long time ago, this may be a great time to update and redesign the entire site or even create a new one. DreamHost's Professional Services may also be able to help with this.

See also

Did this article answer your questions?

Article last updated PST.

Still not finding what you're looking for?