Page tree
Skip to end of metadata
Go to start of metadata

For cPanel & WHM version 60

 (Home >> Software  >> MultiPHP Manager)

Important:

cPanel's MultiPHP Manager interface is only available on systems that run EasyApache 4.

Overview

cPanel's MultiPHP Manager interface allows you to easily manage the PHP and PHP-FPM configurations of your accounts. In this interface, you can manage the PHP version, PHP-FPM setting, or pool option of any virtual host that you own. You can also set a different PHP version, PHP-FPM or pool options setting for each virtual host. 

  • The system PHP version refers to version of PHP that functions as the global default for all accounts. Only the system administrator can set the system PHP version. Any primary domain that is set to Inherit uses the system PHP Version. For more information, read our PHP Inheritance documentation. 
  • PHP FastCGI Process Manager (PHP-FPM) is an alternative PHP module that allows a website to handle strenuous loads on sites. PHP-FPM maintains pools (workers available to respond to PHP requests) to accomplish this. These pools of workers allow the website to handle more requests than it normally could.
  • The Pool Options feature allows you to set automated pools (workers) for your server. This enables your system to run faster and smoother with more processes.

List of domains

In EasyApache 4, each domain or virtual host can use any currently-installed PHP version or currently-installed PHP-FPM setting. 

The list of domains displays the following information:

  • The name of the domain.
  • The domain's account name.
  • The PHP version that the domain currently uses.
  • A PHP-FPM enabled () or disabled (×) indicator.

Note:

Parked domains represent aliases for a primary domain. The system does not list parked domains.

Use the Search text box to search for specific domains. You can search by domain name, account name, current PHP version of the domain, or the current PHP-FPM setting of the domain. Results update automatically as you type.

In This Document

Related Documentation

There is no content with the specified labels

For Hosting Providers

Set a domain's PHP version

To change an account's PHP version, perform the following steps:

  1. Select the checkbox for the domain that you wish to change.
  2. Select the desired version of PHP from the PHP Version menu. To always use the system default, select Inherit.
  3. Click Apply. The system will change the selected domain's PHP version.

    Notes:

    • The system displays a PHP-FPM enabled () or disabled (×) indicator in the PHP-FPM column for each domain. System administrators can enable or disable PHP-FPM through WHM's MultiPHP Manager  interface (Home >> Software >> MultiPHP Manager).

    • When you change the PHP version of your domain and FPM is enabled, the system changes your FPM version to match the PHP version. If FPM is not enabled on your domain, the system changes the PHP and FPM versions separately.

Warning:

Incorrect ownership of an .htaccess  file may cause failures when you change an account's PHP version. Your cPanel account must own the .htaccess file, and that file must use 644 permissions.

Set a domain's PHP-FPM setting

Note:

The system may display the following message:

PHP-FPM option is not available because you do not have all required packages installed.

Please use the link below to go to Easy Apache 4 and install these packages before utilizing the PHP-FPM functionality.

  • ea-php54-php-fpm
  • ea-php55-php-fpm
  • ea-php56-php-fpm
  • ea-apache24-mod_proxy_fcgi

This message indicates that your system does not contain one or more of the required PHP-FPM packages. Click Go to EasyApache 4 to install the required PHP-FPM packages. For additional information about the EasyApache 4 interface, read our EasyApache 4 Interface documentation. 

To enable or disable an account's PHP-FPM setting, perform the following steps:

  1. Select the checkbox next to the domain that you wish to change.
  2. Select the desired PHP-FPM setting from the PHP-FPM menu. To always use the system default, select Inherit.

    Note:

    If you set your PHP version to Inherit, the system will not allow you to set PHP-FPM. You must select a PHP version other than Inherit.

  3. Select On to activate PHP-FPM or Off to deactivate it.
  4. Click Apply.

To select all of an account's PHP-FPM settings, perform the following steps:

  1. Select the checkbox to the left of Domain. This selects all of the domain's accounts in the list.
  2. Select On to activate PHP-FPM for all selected domains or Off to deactivate it.
  3. Click Apply.

    Note:

    If you enable FPM on a cPanel account's primary domain and then change that domain's name, the system will disable FPM for that new domain. You must reenable FPM on the new domain if you wish to use FPM for the new domain.

Set a domain's pool options

To set a domain's pool options, perform the following steps:

  1. Click Pool Options next to your desired domain. The system will display the following options and their defaults and limits:

    Pool OptionsDefaultLimit
    Max Children51-10,000
    Process Idle Timeout (s)101-10,000,000
    Max Requests201-10,000,000

    Remember:

    If you set your PHP version to Inherit, the system will not allow you to set PHP-FPM or pool options. You must select a PHP version other than Inherit and set PHP-FPM to On to access pool options.

  2. Enter your desired options for Max ChildrenProcess Idle Timeout (s), and Max Requests

  3. Click Save. The system will display the following success message: Successfully applied PHP-FPM Pool options to the selected domain.