Change the PHP version of a site

If you need assistance updating your site to support modern versions of PHP, DreamHost's Professional Services may be able to assist you in updating your code.


As DreamPress is a service managed by DreamHost, the minimum supported PHP version cannot be lowered. However, a DreamPress staging website can be used to test higher versions of PHP, and publish those changes to your live DreamPress site. View the following article for more details:

DreamHost offers several versions of PHP. When you add a site, there is an option to choose which version you'd like to use, but you can also change this version at any time in the panel.

Changing the PHP version

Your domain must be Fully Hosted on a server to change the PHP version. 'DNS Only,' Parked, and Redirect domains do not have PHP options.

To change the PHP version on any of your domains/subdomains within the panel:

  1. Navigate to the Manage Websites page.
  2. Click the Manage button to open the Domain Settings page, which allows you to adjust various settings for your site.
    • If in Grid view, click the Manage button at the bottom of the website box.
    • If in List view, click the Manage button at the far right of your domain name.
    Change PHP version
  3. Under the PHP section, click the Modify icon.
    Change PHP version
  4. Choose a version of PHP from the dropdown menu.

    Two options appear allowing you to choose what happens if the upgrade fails. The option Revert to previous PHP version is recommended as this will allow you to resolve any issues later without causing site errors.

    Change PHP version
  5. Click the Change PHP Version button.

The following error message appears if your website's code is not compatible with the new PHP version you have selected.

PHP 8 incompatible

If you selected Revert to previous PHP version, the PHP version is not changed. You could then use the following article to locate and update the incompatible code before attempting to change the PHP version again.

Changing the PHP version on your site using an .htaccess file

Be cautious when using this method over long periods of time. If you use .htaccess to force a version that has reached its End of Life, your site may experience issues when that version is removed from the server.

Aside from changing the settings in the DreamHost panel, you can also change the PHP settings using an .htaccess file.

View the following articles for instructions on how to create or edit your .htaccess file:

Simply add the following two lines in your .htaccess file which forces PHP to use PHP 8.2:

AddHandler fcgid-script .php 
FCGIWrapper "/dh/cgi-system/php82.cgi" .php

If this causes any problems, then remove the lines to switch back to your previous settings.

Making this change also adjusts the PHP version displayed in your panel on the Manage Websites page. However, it may take up to 24hrs for it to update.

See also

Did this article answer your questions?

Article last updated PST.

Still not finding what you're looking for?