1. cPanel & WHM Documentation
  2. WHM
  3. Software
  4. MultiPHP Manager for WHM — User Domain Settings
whmui phphandlers php fpm

MultiPHP Manager for WHM — User Domain Settings

Valid for versions 98 through the latest version

Version:

98

Last modified: 2025 March 5

Looking for this interface?
Note:

Your hosting provider can enable or disable this interface for resellers in WHM's Edit Reseller Nameservers and Privileges interface (WHM >> Home >> Resellers >> Edit Reseller Nameservers and Privileges).

Overview

The User Domain Settings tab of WHM’s MultiPHP Manager interface (WHM » Home » Software » MultiPHP Manager) contains options to configure user-specific PHP-FPM settings.

The Domain table

The table displays the following information about each domain on your server:

  • Domain — The domain’s name.
  • Account — The account’s name.
  • PHP Version — The PHP version the domain uses, and whether it inherits that PHP version.
  • PHP-FPM — The domain’s PHP-FPM status.

To view more information about each domain, click the arrow (>) next to the domain’s name. You can select a new PHP version, set a domain to Inherit, or set the domain’s PHP-FPM status to Enabled or Disabled.

To change multiple domains at the same time, select the checkbox next to the domains that you wish to modify and then select one of the following actions:

  • Set PHP Version — Select the PHP version that you wish to assign to the selected domains in the menu.
  • Set Inherit — Click this button to set all selected domains to inherit their PHP version.
  • Disable PHP-FPM — Click this button to disable PHP-FPM for the selected domains.

Set a domain’s PHP version

To set a domain’s PHP version, select the PHP version that you wish to use from the menu next to that domain.

When you change a domain’s PHP version, any domain that inherits its PHP version from that domain will also change its PHP version. For more information about inheriting PHP versions, read our PHP Inheritance documentation.

To set a domain to inherit its PHP version, perform the following steps:

  1. Click the Inherit checkbox in the PHP Version column next to the domain’s name.
  2. Click Apply to accept the change.
  3. The system will display Inherit and the inherited PHP version, and will change the PHP-FPM column to Unavailable for that domain.

To set a domain to not inherit its PHP version, perform the following steps:

  1. Click the Inherit checkbox in the PHP Version column next to the domain’s name.
  2. Select the PHP version that you want the domain to use from the menu.
  3. Click Apply to accept the change.
  4. The system will display the assigned PHP version and allow you to select the domain’s PHP-FPM status.

Set a domain’s PHP-FPM status

To enable or disable PHP-FPM for a domain, set the toggle to either Enabled or Disabled.

To disable PHP-FPM for multiple domains, select the domains that you wish to disable, then click Disable PHP-FPM.

You cannot modify a domain’s PHP-FPM settings if its PHP version is set to Inherit or if PHP-FPM is not available for its PHP version.

PHP-FPM Settings

To configure the domain’s PHP-FPM settings, click PHP-FPM Settings. A new interface will appear.

Note:

This option only appears if you set a domain’s PHP-FPM status to Enabled.

To display more information about each setting, click Show Help Text.

When you finish configuring your PHP-FPM settings, you can select the following options:

  • Update — Use this option to save your settings.
  • Validate Settings — Use this option to ensure that your PHP-FPM settings are valid.
  • Reset Settings — Use this option to reset your changes to their saved values.

Click Go Back to User Domain Settings to exit the interface.

For more information about PHP-FPM, read our PHP-FPM documentation.

PHP-FPM Pool options

The PHP-FPM Pool options section allows you to set automated pools (workers) for your domain.

You can set the following options in this section:

Setting Definition Default value
Max Requests The maximum number of requests a process can serve before it spawns a new process. You must choose an integer between 1 and 10000000. 20
Max Children The maximum number of PHP-FPM processes the server will spawn. You must choose an integer between 1 and 10000. 5
Process Idle Timeout The amount of time, in seconds, that a process can be idle before the system kills it. You must choose an integer between 1 and 10000000. 10

PHP-FPM INI Settings

The PHP-FPM INI Settings section allows you to configure the available php.ini directives for the domain. You can also toggle a user’s ability to override the system’s directive settings. You can set the following settings:

  • Treat URLS as files (allow_url_fopen) — Users can treat URLs as files.
  • Log errors (log_errors) — Users can log errors.
  • Recognize code between tags as PHP source (short_open_tag) — The system can recognize code between the <? and ?> tags as a PHP source.
  • Error log — The location of the domain’s error log.
  • Disable Functions — The PHP functions to disable.
  • Error Reporting — The error reporting level for the domain.

Select the Block domain from changing the setting checkbox next to each option to prevent the PHP application from overriding your selection. When you select this checkbox, the system sets the directive with php_admin_value. If you do not select this option, it uses php_value.

To manually configure additional php.ini directives, read our How to Manage Your php.ini Directives with PHP-FPM documentation. For a complete list of PHP-FPM user pool directives, read our Configuration Values of PHP-FPM documentation.