Configuration Values of PHP-FPM

Overview

This document provides a comprehensive list of PHP-FPM system configuration settings and their default values. It also outlines the process for adding custom settings to your system's PHP-FPM configuration.

Global directives and pool options can be configured via WHM’s MultiPHP Manager interface (WHM » Home » Software » MultiPHP Manager).

Global Directives

The system utilizes template values for default configurations. 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 describes the labels for global directives:

• Key — The entry in the .yaml file.
• Name — The pool name in the /var/cpanel/ApachePHPFPM/system_pool_defaults.yaml configuration file.
• Present if not listed — If set to Yes, the system automatically adds this value to the /var/cpanel/userdata/user/domain.php-fpm.yaml configuration file, where user corresponds to the cPanel username and domain to the specific domain.
• Default — The template value residing in the /var/cpanel/ApachePHPFPM/system.yaml configuration file. For details on creating the /var/cpanel/ApachePHPFPM/system.yaml file, refer to our PHP-FPM implementation documentation.

Pool Name Directives

PHP-FPM pools enable the configuration of different websites and applications to operate under their own user accounts. The following table lists directives that can be configured within the /var/cpanel/ApachePHPFPM/system_pool_defaults.yaml file. For more information on creating this file, please refer to our PHP-FPM implementation documentation.

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

Adding an Unknown Value to a Configuration

You can add a value that the system does not currently provide as a default by using 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.

For more information, refer to our How to Manage Your php.ini Directives with PHP-FPM documentation.