How to Switch PHP Versions in cPanel: A Complete Technical Guide

by

Choosing the right PHP version for your website is one of the most impactful performance and security decisions you can make. cPanel makes switching between PHP versions straightforward, but understanding when and why to upgrade — and how to handle compatibility issues — requires more than just clicking a dropdown menu. Whether you are running a legacy WordPress site on PHP 7.4 or deploying a modern Laravel application that needs PHP 8.3, this guide covers every step of the process from start to finish.

Why PHP Version Matters for Your cPanel Hosting

Each major PHP release introduces performance improvements, new features, and critical security patches. The PHP development team releases active support for each major version for approximately two years, followed by one year of security-only fixes. After that, the version reaches end-of-life (EOL) and receives no further updates.

Running an EOL PHP version exposes your site to unpatched vulnerabilities. For example, PHP 7.4 reached end-of-life in November 2022, meaning any security flaw discovered after that date remains unfixed. At the same time, newer PHP versions are significantly faster. Benchmarks consistently show PHP 8.x outperforming PHP 7.x by 20 to 40 percent in request throughput, which translates directly to faster page loads and better user experience.

PHP Version Support Status (as of 2026)

  • PHP 8.3 — Active support, recommended for new projects
  • PHP 8.2 — Active support, strong compatibility with most CMS platforms
  • PHP 8.1 — Security-only support, still viable for older applications
  • PHP 8.0 — End of life, upgrade recommended
  • PHP 7.4 — End of life, upgrade strongly recommended

How to Check Your Current PHP Version in cPanel

Before making any changes, verify which PHP version your account is currently using. cPanel provides several ways to do this.

Method 1: Check via cPanel Dashboard

  1. Log in to your cPanel account
  2. Scroll to the Software section
  3. Look for the Select PHP Version icon (sometimes labeled MultiPHP Manager) and click it
  4. A page opens displaying your current PHP version at the top, along with a dropdown menu of available versions

Method 2: Create a PHP Info File

  1. Open cPanel’s File Manager and navigate to public_html
  2. Create a new file named phpinfo.php
  3. Add the following code: <?php phpinfo(); ?>
  4. Visit https://yoursite.com/phpinfo.php in your browser
  5. Delete the file after checking — leaving it exposed is a security risk

Step-by-Step: Switching PHP Versions Using MultiPHP Manager

cPanel’s MultiPHP Manager (or Select PHP Version) is the primary interface for changing PHP versions. It uses PHP-FPM (FastCGI Process Manager) by default on modern cPanel installations, which provides better performance and isolation than older CGI or mod_php setups.

  1. Open Select PHP Version: From your cPanel dashboard, navigate to Software → Select PHP Version
  2. Choose your version: Use the dropdown at the top of the page to select your desired PHP version (e.g., 8.3)
  3. Review extensions: The page lists available PHP extensions. Checked extensions are enabled; unchecked ones are disabled. Common extensions like mysqli, curl, gd, mbstring, and xml are typically required by WordPress and other popular CMS platforms
  4. Update all extensions that were enabled on your previous version — extension availability varies between PHP versions
  5. Click Apply or Save at the bottom of the page
  6. Verify the change: Visit your site or check via the phpinfo file you created earlier to confirm the new version is active

Testing Compatibility Before Switching PHP Versions

Switching PHP versions blindly can break your site. Deprecated functions, removed features, and stricter error handling in newer PHP versions can cause fatal errors. Follow this checklist before making the switch.

Pre-Switch Compatibility Checklist

  • Check your CMS requirements: Visit the official documentation for WordPress, Joomla, Drupal, or your framework to see which PHP versions they support
  • Review plugin and theme compatibility: Log in to your CMS admin panel and check for any compatibility warnings. Outdated plugins are the most common cause of PHP version-related breakage
  • Enable error logging: Before switching, add this line to your wp-config.php (for WordPress) or equivalent config file: define('WP_DEBUG', true);. This ensures you can identify errors after the switch
  • Test on a staging environment: If your host provides staging via WP Toolkit or a separate subdomain, switch PHP on the staging copy first
  • Test critical workflows: Check forms, login, checkout (if ecommerce), file uploads, and any custom functionality after the switch

Fixing Common Compatibility Issues

If your site breaks after switching PHP versions, the most common culprits are:

  • Deprecated function calls: Replace removed functions like mysql_* with mysqli_* or PDO equivalents
  • Extension mismatches: Return to Select PHP Version and ensure all required extensions are checked
  • opcache issues: Clear your PHP opcache by restarting PHP-FPM or waiting a few minutes for the cache to expire. cPanel’s Select PHP Version interface has a Reset Opcache button in some versions

Setting Different PHP Versions Per Domain or Subdomain

One of cPanel’s most useful features is the ability to run different PHP versions for different domains within the same account. This is handled through the MultiPHP Manager interface.

  1. Navigate to Software → MultiPHP Manager in cPanel
  2. The interface displays a table of all domains and subdomains on your account
  3. Select the checkbox next to the domain you want to change
  4. Choose the desired PHP version from the dropdown at the bottom of the table
  5. Click Apply to apply the change only to the selected domain(s)

This per-domain flexibility is invaluable when you are migrating a client site to a newer PHP version while keeping other sites on their current, tested configuration. You can progressively upgrade sites one at a time rather than risking a full account-wide change.

Configuring PHP-FPM Settings for Performance

After switching PHP versions, you may want to tune PHP-FPM settings for optimal performance. cPanel provides access to these settings through the Select PHP Version → Switch to PHP-FPM interface or the PHP-FPM Settings link within the same section.

Key settings to consider:

pm.max_children = 10
pm.start_servers = 3
pm.min_spare_servers = 2
pm.max_spare_servers = 5
pm.max_requests = 500

  • pm.max_children: The maximum number of child processes. Set this based on your hosting plan’s memory limit. A safe formula is memory_limit / average_process_memory
  • pm.start_servers: The number of child processes created on startup
  • pm.max_requests: The number of requests each child process handles before respawning. Setting this to 500 helps prevent memory leaks from accumulating

You can also configure per-domain PHP-FPM pools from this interface, giving you fine-grained control over how each site consumes server resources.

Key Takeaways

  • Always run a supported PHP version. Older versions quickly become security liabilities with no patches available for newly discovered vulnerabilities
  • Use cPanel’s Select PHP Version tool to switch site-wide, or MultiPHP Manager for per-domain control
  • Test compatibility before switching — enable error logging and check plugin/theme compatibility first
  • Each PHP version has different available extensions; ensure critical extensions like mysqli and curl are enabled after switching
  • Use a staging environment when possible to validate the switch on a non-production copy of your site
  • Tune PHP-FPM settings after switching to maximize performance within your hosting plan’s resource limits