X
X

Select Your Currency

₺ Türk Lirası $ US Dollar
X
X

Select Your Currency

₺ Türk Lirası $ US Dollar

How to Safely Change the PHP Version on a cPanel Server

HomepageArticlesTechnical GuidesHow to Safely Change the PHP Versio...

To safely change the PHP version on a cPanel server, first record the site’s current version, the applications and plugins it uses, and the option for reverting the change. Then, in cPanel, select only the relevant domain and move to a newer supported version, repeat the same operation that previously failed, and review any new error record created after the change. If the problem persists, return to the previous version; do not change the PHP setting for all accounts at once.

Define access and compatibility limits before changing the cPanel server PHP version

This procedure assumes that you have cPanel access for the relevant site. If you are a system administrator managing PHP versions for multiple accounts, settings in WHM or the server management layer may also apply. On a shared hosting account, the available PHP versions and some extensions are limited to the options provided by the host. If you cannot see a version in the list, do not try to force it by editing files.

Before making the change, note the domain’s current PHP version and selected extensions in cPanel. Also record the information shown in the application’s administration panel and the plugins it uses, and, where possible, make or record a database and file backup. If the problem appears on only one site, changing only that domain is safer. If multiple sites depend on the same version, first identify the sites that could be affected; changing a shared setting may create new errors in other applications.

Change the PHP version on a cPanel server in a controlled manner

  1. Record the current state: Open cPanel’s screen related to the PHP version or domain configuration. In some panels, this section appears as MultiPHP Manager. Note the domain, current version, and selected PHP extensions. This record provides the basic information needed to revert the change if the result is unexpected.
  2. Verify the application’s requirements: Check the version supported by the content management system, theme, and plugins in their own current documentation or administration screens. If the application depends on an older extension, the newest version may not automatically be suitable. If the application supports the newer version but the current version is no longer maintained, consider the newer supported option; if the support information is unclear, do not test it directly on the production site.
  3. Select only the target domain: In the PHP version screen, select the relevant domain, choose a supported target version, and save it. If the same screen includes extension selection, retain the current extensions and make only the change that is genuinely necessary. If the panel shows the new version after saving, the basic configuration has been applied; this does not yet prove that the application is fully compatible.
  4. Run the same operation again: Open the same URL that produced the error before the change, or repeat the same form submission, administrative operation, or file upload. Note the result and the time. If the operation is fixed, check the cPanel error logs to see whether a new PHP error was recorded after that time. If the problem continues, assess the application’s error screen, the domain-specific error log, and, where possible, the administrative information showing the PHP version together.
  5. Make a targeted correction based on the finding: If the new record shows an incompatibility in a specific plugin or theme file, address that component first through its own update or disable tool; do not delete files or broaden all permissions. If the record indicates a memory, timeout, or upload-size limit, this belongs to a different group of settings; repeatedly changing the PHP version will not solve it. If the resource and permission limits cannot be changed within the cPanel account, check the provider’s policy for the relevant limits.

How should you interpret the result, and when should you revert?

If the site opens on the new PHP version and the same operation no longer produces a new error, the change has produced an acceptable result. However, the home page opening alone is not enough; also check the critical functions appropriate to your application, such as login, the contact form, the payment flow, or file uploads. If the home page works while a particular administration screen is broken, this points more to an incompatibility in the relevant code or extension than to a general server failure.

Suppose a store application produces a plugin error in its administration panel on the older PHP version, while the application documentation supports a newer version. After moving to the newer version, the store page opens, but a new error record appears showing the payment plugin’s file. In this situation, checking the plugin’s compatible version first is the better choice instead of reverting all PHP settings. By contrast, if the entire site stops opening after the same operation and the new record shows a general incompatibility during application startup, return to the older PHP version you recorded and then plan the upgrade in a separate test environment.

If a rollback is necessary, select only the same domain on the PHP version screen and reapply the value you recorded at the beginning. Then try the first URL that produced the error again and, this time, inspect the new log entries recorded after the rollback time. If the site is restored, keep the previous version temporarily; if the problem continues, check whether the rollback was applied and whether another configuration change occurred at the same time. Changing multiple settings simultaneously makes it harder to determine which change caused the result.

Safe next step when cPanel access is insufficient

If the target PHP version is not available in the panel, you do not have permission to add extensions, or the change would affect multiple accounts, intervention by the server administrator may be necessary. In that case, share the error time, domain, current and target versions, the operation you repeated, and the specific file or error line shown in the new log; do not send passwords, API keys, or personal data. If you want to review options for moving to an environment that requires more detailed administrative access for the application, you can also consider the Turkey VDS server plans page.

The next safe step is to prepare a short rollback plan using the current settings you recorded first and change the PHP version on only one cPanel domain. This lets you separate the compatibility finding from the configuration of the other sites.


Top