Child pages
  • MultiPHP Manager for WHM
Skip to end of metadata
Go to start of metadata

This documentation is for cPanel & WHM version 66.  The "RELEASE" version of our documentation can be found in the Version 64 Documentation space.

(Home >> Software >> MultiPHP Manager)

Important:

WHM's MultiPHP Manager interface only appears on systems that run EasyApache 4.

Overview

WHM's MultiPHP Manager interface (Home >> Software >> MultiPHP Manager) allows you to easily manage the PHP and PHP-FPM configurations of your cPanel 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 the 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 possess 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 account's owner's name
  • The PHP version that the domain currently uses, and if the account inherited that setting
  • The domain's PHP-FPM status

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, account owner's 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 parent domain's PHP version, select Inherit. An account set to Inherit with no parent domain uses the system default.
  3. Click Apply. The system changes the selected domain's PHP version.

    Notes:

    When you change the PHP version of a domain with FPM enabled, the system changes the domain's 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 cPanel 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, you must perform the following steps:

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 Install and then click Provision in the new window to install the required PHP-FPM packages. For more information about the EasyApache 4 interface (Home >> Software >> EasyApache 4), read our EasyApache 4 Interface documentation.

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

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 On to activate PHP-FPM or Off to deactivate it.

    Important:

    If you select a domain with the PHP version set to  Inherit , the system will  not  allow you to set PHP-FPM for that domain. You  must  either select a PHP version other than  Inherit or not use PHP-FPM.

  3. Click Apply.

Note:

If you enable FPM on an 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

Note:

Apache limits the performance of PHP-FPM pool options. You must reflect a 1:1 configuration setup between Apache and PHP-FPM. For more information on how to configure Apache and Pool Options, read our Apache vs PHP-FPM Bottleneck with Child Processes documentation.

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

  1. Click Pool Options next to the desired domain that you wish to change. The system will display the following options:

    Pool OptionsDefaultLimit
    Max Children51-10,000
    Process Idle Timeout (s)101-10,000,000
    Max Requests201-10,000,000
  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.  


System PHP-FPM Status

Administrators can turn PHP-FPM on or off for all accounts. 

Turn System PHP-FPM Status on

To set the System PHP-FPM Status to On, perform the following steps:

  1. Log in to WHM as the root user.
  2. Navigate to WHM's MultiPHP Manager (Home >> Software >> MultiPHP Manager) interface.
  3. In the System PHP-FPM section, click the blue Turn On button next to System PHP-FPM Status. The system will display the Convert All Accounts to PHP-FPM button.

  4. To convert all your accounts to PHP-FPM, click the blue Convert All Accounts to PHP-FPM button. The system will display a success message. 

    Notes:

    • If your PHP version does not match the required PHP-FPM installed packages, the system will not allow you to convert all of your accounts to PHP-FPM.
    • You cannot convert all of your accounts to PHP-FPM until you install the appropriate PHP-FPM packages for the specified PHP version.
    • You can enable or disable PHP-FPM for all accounts.
    • When enabled, the system automatically enables PHP-FPM for new accounts, domains, subdomains, and addon domains that you create.

  5. If you wish to see the conversion log, click the link provided in the success message above System PHP-FPM Status. Your status will now display as On and all of your accounts, domains, subdomains, and addon domains will run with PHP-FPM enabled.

Turn System PHP-FPM Status off

To set the System PHP-FPM Status to Off, perform the following steps:

  1. Log in to WHM as the root user.
  2. Navigate to WHM's MultiPHP Manager (Home >> Software >> MultiPHP Manager) interface.
  3. In the System PHP-FPM section, click the blue Turn Off button next to System PHP-FPM Status. Your status will now display as Off and all of your accounts will no longer run with PHP-FPM enabled.

Manage PHP Handlers

Note:

PHP Handlers does not apply to PHP-FPM.

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 that are compatible with your selected version of PHP.

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

  3. Click Apply.

Additional documentation