---

Last modified: February 12, 2024

Overview

This interface allows you to easily manage the PHP and PHP FastCGI Process Manager (PHP-FPM) configurations of your system and your cPanel accounts.

System Settings tab

In this tab, you can configure your system-level default PHP settings.

PHP Version

To set the system’s default version of PHP, select your desired PHP version in the menu.

If you select a deprecated version of PHP, the system will display a warning message. Click Apply Deprecated Version to continue.

This setting determines the version of PHP assigned to any new account that you create. Changing this setting does not alter any account’s PHP version, unless it is set to inherit its PHP version from the system.

PHP-FPM

To set whether the system uses PHP-FPM by default, set the toggle to either Enabled or Disabled. Changing this setting does not alter any existing account’s PHP-FPM settings.

To configure your system’s PHP-FPM settings, click Manage Settings. The System PHP-FPM Settings interface will appear.

Enable PHP-FPM for all domains

If PHP-FPM is not enabled on your system, set the toggle to Enabled to enable it.

If your system possesses enough memory, the interface prompts you to choose if you want to enable PHP-FPM for all domains when you set the toggle. To continue, click Enable. The system will enable PHP on all domains on the system. Click conversion log to view the conversion process.

If PHP-FPM is already enabled on your system, click the Enable On All Domains button. The system will either enable PHP-FPM on all domains, or display a warning message if your system does not possess enough memory.

For more information, read our PHP FastCGI Process Manager - PHP-FPM documentation.

System PHP-FPM Settings

In this interface, you can configure the system’s PHP-FPM settings. It contains two sections: PHP-FPM Pool options and PHP-FPM INI Settings.

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

When you finish configuring your PHP-FPM settings, you can select from 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 System 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 system.

You can set the following options in this section:

• 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. This value defaults to 20.
• Max Children — The maximum number of PHP-FPM processes the server will spawn. You must choose an integer between 1 and 10000. This value defaults to 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. This value defaults to 10.

PHP-FPM INI Settings

The PHP-FPM INI Settings section allows you to configure the available php.ini directives for the server. You can also set a user’s ability to override the system’s directive settings. You can manage 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.
• Disable Functions — The PHP functions to disable.
• Error Reporting — The error reporting level.

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 so 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.

PHP Handlers

The PHP Handlers section allows you to set the PHP handler for each version of PHP installed on your server.

To change a PHP version’s handler, select the handler that you wish to use in the menu next to the PHP version.

User Domain Settings tab

In this tab, you can set your user-specific PHP settings.

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.

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:

• 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. This value defaults to 20.
• Max Children — The maximum number of PHP-FPM processes the server will spawn. You must choose an integer between 1 and 10000. This value defaults to 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. This value defaults to 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.