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

For cPanel & WHM version 60


(Home >> Software >> MultiPHP Manager)

Important:

WHM's MultiPHP Manager interface only appears 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.
  • MultiPHP user's PHP-FPM setting does not transfer. For more information on how to correct this, read our PHP-FPM documentation.

MultiPHP Manager

Select a tab to view more information about that section of the MultiPHP Manager interface.

System PHP version

The System PHP Version functions as the global default for all accounts. When you create a new account, the account uses this version of PHP by default. Any primary domain that is set to Inherit uses the System PHP Version.  For more information, read our PHP Inheritance documentation. 

To change the system default PHP, perform the following steps:

  1. Click Edit in the System PHP Version section.
  2. Select your desired PHP version from the menu.
  3. Click Apply

Remember:

If you change the system default PHP version, the PHP version of any primary domain that is set to Inherit also changes.

Note:

To remove the CloudLinux™ promotions, log into your Manage2 account, navigate to the Update Company Information section, and select the Disabled button next to the Purchase CloudLinux Url or email address option. You can only disable this option if you have a Partner account.

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/disabled indicator ( or ×)

Note:

Parked domains represent aliases for a primary domain. The system does not list these in the user interface.

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.

Set a domain's PHP version

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

  1. Select the checkbox next to the domain that you wish to change.
  2. Select the desired version of PHP in the PHP Version menu. If you want the account to always use the system default, select Inherit.
  3. Click Apply. The system changes the selected domain's PHP version.

    Notes:

    • The system displays a  or an × under the PHP-FPM column next to your domain. The ✓ indicates that PHP-FPM is enabled on that domain and an × indicates that it is disabled. You can enable or disable PHP-FPM on your domains 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 that of the PHP version selected. 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. The user account must own the .htaccess file that you want to change, and that file must use 644 permissions.

Set a domain's PHP-FPM setting

Before you can set the PHP-FPM setting for a domain, perform the following steps to ensure that your system contains the necessary packages:

Step one: Install required PHP-FPM packages

The system may display the following message:

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

Step two: Set the PHP-FPM setting for your domain

To turn on or off 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 setting of PHP-FPM in the PHP-FPM menu. If you want the account 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 re-enable 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. Click Save. The system will display the following success message: Successfully applied PHP-FPM Pool options to the selected domain. 

Manage PHP Handlers

In EasyApache 4, each PHP version can use its own PHP handler.

The list of PHP versions shows:

  • An installed PHP version
  • The PHP handler that version of PHP uses

To change the handler that a PHP version uses, perform the following steps:

  1. Click Edit next to the version of PHP whose handler you wish to change.
  2. Select the PHP handler from the menu.

    Notes:

    • The menu only shows the PHP handlers compatible with your selected version of PHP.

    • You can only use the DSO handler with one version of PHP.

  3. Click Apply.

Additional documentation

There is no content with the specified labels

There is no content with the specified labels

There is no content with the specified labels