Configuration Values of PHP-FPM

Overview

This document lists the PHP-FPM system’s configuration settings and their default values. This document also explains how to add additional settings to your system’s PHP-FPM configuration.

You can configure some of the global directives and pool options through WHM’s MultiPHP Manager interface (WHM » Home » Software » MultiPHP Manager).

Global directives

cPanel & WHM uses template values for defaults. For example, when the [% ea_php_version %] template value appears in the .yaml file, the system replaces this value with the desired PHP version. The following list outlines the global directives labels:

• Key — The entry in the .yaml file.
• Name — The pool name in the /var/cpanel/ApachePHPFPM/system_pool_defaults.yaml configuration file.
  More:

  For more information about pool names, read our PHP-FPM Domain Pools documentation.
• Present if not listed — When you set this value to Yes, the system adds the value to the /var/cpanel/userdata/user/domain.php-fpm.yaml configuration file, where user represents the cPanel user’s name and domain represents the domain.
• Default — The template value that resides in the /var/cpanel/ApachePHPFPM/system.yaml configuration file. For more information about creating the /var/cpanel/ApachePHPFPM/system.yaml file, read our PHP-FPM implementation documentation.

Pool name directives

PHP-FPM pools allow you to configure different websites and applications to run under their own user. The following table lists directives that you can configure in the /var/cpanel/ApachePHPFPM/system_pool_defaults.yaml file. For more information about creating the /var/cpanel/ApachePHPFPM/system_pool_defaults.yaml file, read our PHP-FPM implementation documentation.

Add a value to a configuration

A complete configuration directive line would resemble the following example:

php_value_open_basedir: { name: 'php_value[open_basedir]', value: "[% documentroot %]" }

This example contains the following values:

• php_value_open_basedir represents the Key entry.
• The Key entry must only contain letters, numbers, and underscores.
• php_value[openbasedir] represents the pool name.
• documentroot represents the configuration value.

Add an unknown value to a configuration

You can add a value that cPanel & WHM does not currently provide as a default with a YAML map.

To create a YAML map, add a line to the configuration file that resembles the following example:

php_admin_value_ldap_max_links: { name: 'php_admin_value[ldap.max_links]', value: -1 }

This example contains the following values:

• php_admin_value_ldap_max_links represents the Key entry.
• The Key entry must only contain letters, numbers, and underscores.
• php_admin_value[ldap.max_links] represents the pool name.
• -1 represents the configuration value.

1
2

find /home -type f -name '.htaccess' -exec grep -Hrn 'php_value' '{}' \;
find /home -type f -name '.htaccess' -exec grep -Hrn 'php_flag' '{}' \;