Child pages
  • PHP-FPM Code and FileSystem Layout for EasyApache 4
For cPanel & WHM version 70

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 6 Next »


This document explains the following information about the PHP FastCGI Process Manager (PHP-FPM) daemon:

  • The PHP-FPM filesystem layout.
  • How the system implements PHP-FPM on your system.

PHP-FPM provides an alternative FastCGI daemon for PHP that allows a website to handle significant loads. It allows a host to set specific amounts of resources to process a domain's requests via workers available to respond to PHP requests (pools). These pools allow a website to process more requests.

PHP-FPM functions more quickly than traditional CGI-based methods, such as SUPHP, for multi-user PHP environments. It does not overload a system's memory with PHP requests from Apache processes, such as the ruid2+php-dso process. PHP-FPM only executes PHP requests, which enables it to service content quicker than other methods.

PHP-FPM implementation

The Cpanel::PHPFPM (Cpanel/ module is the basis of EasyApache support with PHP-FPM. The module's built-in defaults generate configuration files that provide fully functional PHP-FPM pools for a domain.

The system uses the following configuration files:

  • /var/cpanel/ApachePHPFPM/system.yaml
  • /var/cpanel/ApachePHPFPM/system_pool_defaults.yaml

Each file contains different directives from the built-in values.


Exercise extreme caution when you manually edit .yaml files. Incorrect syntax in these files will cause services to fail. We strongly recommend that you create a backup of your system before you manually edit .yaml files.


  • The system does not require these files to run because the built-in defaults enable the PHP-FPM to run sufficiently. 
  • Only include the differences in directives within these files.

The following example displays the system.yaml file's contents:

daemonize: yes

This example only uses a different value than the built-in default for the daemonize setting. The system-pool-defaults.yaml file also performs this action, but applies the value to each pool that you create. Each domain in the system requires that you create one pool. Some fields use unacceptable characters such as quotation marks (""), periods (.), angle brakcets ([]), and parenthesis (()) for internal reasons, but you must substitute them with an underscore (_). 

The table below contains examples of unacceptable value names:

Old NameNew Name

The filesystem configuration files

The system stores the configuration files that control PHP-FPM in the following files:

/opt/cpanel/ea-php54/root/etc/php-fpm.conf This file contains the system configurations of PHP-FPM.
/opt/cpanel/ea-php54/root/etc/php-fpm.d/[domain].conf This file changes your domain to the domain setting of the website that you use. For example, the cptest1.tld.conf domain.

The .yaml files within the /var/cpanel directories generate these two files.


  • Do not edit these configuration files manually.
  • The system repeats these configuration files for each version that you select.
  • The /opt/cpanel/ea-php54/root/etc/php-fpm.d/[domain].conf file displays ea-php54 or php54 as its version.
  • You must change ea-php54 to the version that your system currently runs. For example, if your system runs on PHP version 5.5 or 5.6, change ea-php54 to ea-php55 or ea-php56.

Required files

Use the following required files only if you wish to run PHP-FPM:


This file controls a specific domain's pool.

The file uses the built-in default values and the system_pool_defaults values to generate the [domain].conf file.

Optional files

Use the following optional files only if you wish to change the default parameters:


This file contains system-level settings.

The system also uses this file to generate the /opt/cpanel/ea-php5?/root/etc/php-fpm.conf file, where the ? character indicates that the system uses this file to generate the PHP versions in the php-fpm.conf file.


The system uses this file to generate each domain's pool and configure each user's pool.


If you edit a user's pool in WHM's MultiPHP Manager for WHM interface (WHM >> Home >> Software >> MultiPHP Manager), the system no longer applies the system default settings to that user.


All domain pools use these defaults unless a .yaml file overrides them.

Restore PHP to your system

The system cannot remove configurations or other related files when you manually remove RPMs. If you manually remove RPMs, you could remove dependencies that your hosted websites require. 


We do not recommend that you perform yum remove operations with any ea-php RPMs. If you remove PHP from your system while any of your hosted websites still use it, those websites will display errors. In addition, Apache could fail to display the website entirely. Before you perform a yum remove operation, confirm that none of your hosted websites use the PHP version that you wish to remove with WHM's MultiPHP Manager interface (WHM >> Home >> Software >> MultiPHP Manager).

To restore PHP versions to your system, run the following commands:

ea_install_profile --install /etc/cpanel/ea4/profiles/cpanel/default.json
/usr/local/cpanel/scripts/restartsrv apache_php_fpm


If the above commands fail, contact your system administrator.

Additional documentation



  • No labels