{"id":802,"date":"2021-07-23T12:38:31","date_gmt":"2021-07-23T12:38:31","guid":{"rendered":"https:\/\/ssdsunucum.com\/blog\/php-fpm-code-and-filesystem-layout-for-easyapache-4\/"},"modified":"2021-07-23T12:38:31","modified_gmt":"2021-07-23T12:38:31","slug":"php-fpm-code-and-filesystem-layout-for-easyapache-4","status":"publish","type":"post","link":"https:\/\/ssdsunucum.com\/blog\/php-fpm-code-and-filesystem-layout-for-easyapache-4\/","title":{"rendered":"PHP-FPM Code and FileSystem Layout for EasyApache 4"},"content":{"rendered":"<\/p>\n
\n
<\/div>\n
\n

Overview<\/h2>\n

This document explains the following information about the PHP FastCGI Process Manager (PHP-FPM) daemon:<\/p>\n

    \n
  • The PHP-FPM filesystem layout.<\/li>\n
  • How the system implements PHP-FPM on your system.<\/li>\n<\/ul>\n

    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\u2019s requests via workers available to respond to PHP requests (pools). These pools allow a website to process more requests.<\/p>\n

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

    \n
    Warning:<\/div>\n
    \n We strongly<\/strong> recommend that you only activate Apache PHP-FPM if your server has at least 2 GB of RAM available, or at least 30 MB of RAM per domain. If you enable PHP-FPM on a server with less than the required RAM, your server may experience severe performance issues.\n <\/div>\n<\/div>\n

    PHP-FPM implementation<\/h2>\n

    The Cpanel::PHPFPM (Cpanel\/PHPFPM.pm)<\/code> module provides the basis of EasyApache support with PHP-FPM. The module\u2019s built-in defaults generate configuration files that provide fully functional PHP-FPM pools for a domain.<\/p>\n

    The system uses the following configuration files:<\/p>\n

      \n
    • \/var\/cpanel\/ApachePHPFPM\/system.yaml<\/code><\/li>\n
    • \/var\/cpanel\/ApachePHPFPM\/system_pool_defaults.yaml<\/code><\/li>\n<\/ul>\n

      You will need to create these two files manually. To do this, perform the following steps:<\/p>\n

        \n
      1. \n

        Create the \/var\/cpanel\/ApachePHPFPM\/<\/code> directory. <\/p>\n

        \n
        mkdir -<\/span>p \/var\/c<\/span>panel\/ApachePHPFPM\/<\/span><\/code><\/pre>\n<\/div>\n<\/li>\n
      2. \n
        Create the two files. <\/p>\n
        \n
        \n\n\n
        \n
        1\n<\/span>2\n<\/span><\/code><\/pre>\n<\/td>\n
        		\n
        touch<\/span> \/<\/span>var<\/span>\/<\/span>cpanel<\/span>\/<\/span>ApachePHPFPM<\/span>\/<\/span>system<\/span>.yaml<\/span>\ntouch<\/span> \/<\/span>var<\/span>\/<\/span>cpanel<\/span>\/<\/span>ApachePHPFPM<\/span>\/<\/span>system_pool_defaults<\/span>.yaml<\/span><\/code><\/pre>\n<\/td>\n<\/tr>\n<\/table>\n<\/div>\n<\/div>\n<\/li>\n<\/ol>\n
        File contents<\/h3>\n
        Each file contains different directives from the built-in values.<\/p>\n
        \n
        Note:<\/div>\n
        \n
          \n
        • The system does not<\/strong> require these files to run because the built-in defaults enable the PHP-FPM to run sufficiently.<\/li>\n
        • Only<\/strong> include the differences in directives within these files.<\/li>\n<\/ul><\/div>\n<\/div>\n
          The following example displays the system.yaml<\/code> file\u2019s contents:<\/p>\n
          \n
          \n\n\n
          \n
          1\n<\/span>2\n<\/span><\/code><\/pre>\n<\/td>\n
          		\n
          ---<\/span>\ndaemonize<\/span>: yes<\/span><\/code><\/pre>\n<\/td>\n<\/tr>\n<\/table>\n<\/div>\n<\/div>\n
          \n
          Note:<\/div>\n
          \n
            \n
          • This example only<\/strong> uses a different value than the built-in default for the daemonize<\/code> setting.<\/li>\n
          • The system-pool-defaults.yaml<\/code> file applies the value to each pool that you create.<\/li>\n
          • Each domain in the system requires that you create one pool.<\/li>\n
          • Replace any unacceptable characters such as .[]()<\/code> with an underscore _<\/code>.<\/li>\n<\/ul><\/div>\n<\/div>\n
            The table below contains examples of unacceptable value names.<\/p>\n\n\n\n\n\n\n
            Old Name<\/th>\nNew Name<\/th>\n<\/tr>\n<\/thead>\n
            syslog.facility<\/code><\/td>\nsyslog_facility<\/code><\/td>\n<\/tr>\n
            php_admin_value[disable_functions]<\/code><\/td>\nphp_admin_value_disable_functions<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
            \n
            Note:<\/div>\n
            \n
            If you prepend any PHP settings with the disable functions<\/code> or disable_classes<\/code> flags, the system will append the new php.ini<\/code> value to the previous one in the user\u2019s .htaccess<\/code> files. For more information, read securephp.net\u2019s FastCGI Process Manager (FPM) documentation.<\/p>\n<\/p><\/div>\n<\/div>\n
            The filesystem configuration files<\/h2>\n
            The system stores the configuration files that control PHP-FPM in the following files:<\/p>\n
              \n
            • \/opt\/cpanel\/ea-php54\/root\/etc\/php-fpm.conf<\/code>\u2014 This file contains the system configurations of PHP-FPM.<\/li>\n
            • \/opt\/cpanel\/ea-php54\/root\/etc\/php-fpm.d\/[domain].conf<\/code> \u2014 This file changes your domain to the domain setting of the website that you use. For example, the cptest1.tld.conf<\/code> domain.<\/li>\n<\/ul>\n
              The .yaml<\/code> files within the \/var\/cpanel<\/code> directories generate these two files.<\/p>\n
              \n
              Note:<\/div>\n
              \n
                \n
              • Do not<\/strong> edit these configuration files manually.<\/li>\n
              • The system duplicates these configuration files for each version that you select.<\/li>\n
              • The \/opt\/cpanel\/ea-php54\/root\/etc\/php-fpm.d\/[domain].conf<\/code> file displays ea-php54<\/code> or php54<\/code> as its version.<\/li>\n
              • You must<\/strong> change ea-php54<\/code> to the version on which your system currently runs. For example, if your system runs on PHP version 5.5 or 5.6, change ea-php54<\/code> to ea-php55<\/code> or ea-php56<\/code>.<\/li>\n<\/ul><\/div>\n<\/div>\n
                Required files<\/h3>\n
                \n
                Note:<\/div>\n
                \n
                Use the required file \/var\/cpanel\/userdata\/[user]\/[domain].php-fpm.yaml<\/code> only<\/strong> if you wish to run PHP-FPM.<\/p>\n<\/p><\/div>\n<\/div>\n
                  \n
                • \/var\/cpanel\/userdata\/[user]\/[domain].php-fpm.yaml<\/code> \u2014 This file controls a specific domain\u2019s pool. The system uses the built-in default values and system_pool_defaults<\/code> values to generate the [domain].conf<\/code> file.<\/li>\n<\/ul>\n
                  Optional files<\/h3>\n
                  \n
                  Note:<\/div>\n
                  \n
                  Use the following optional files only<\/strong> if you wish to change the default parameters. All<\/strong> domain pools use these defaults unless a .yaml<\/code> file overrides them.<\/p>\n<\/p><\/div>\n<\/div>\n
                    \n
                  • \/var\/cpanel\/ApachePHPFPM\/system.yaml<\/code> \u2014 This file contains system level settings. The system also uses this file to generate the \/opt\/cpanel\/ea-php5?\/root\/etc\/php-fpm.conf<\/code> file, where the ?<\/code> indicates that the system uses this file to generate all of the PHP versions in the php-fpm.conf<\/code> file.<\/li>\n
                  • \/var\/cpanel\/ApachePHPFPM\/system_pool_defaults.yaml<\/code> \u2014 The system uses this file to generate each domain\u2019s pool and configure each user\u2019s pool.\n
                    \n
                    Important:<\/div>\n
                    \n
                    If you edit a user\u2019s pool in WHM\u2019s MultiPHP Manager<\/em> interface (WHM >> Home >> Software >> MultiPHP Manager<\/em>), the system no longer applies the system default settings to that user.<\/p>\n<\/p><\/div>\n<\/div>\n<\/li>\n<\/ul>\n
                    Restore PHP to your system<\/h2>\n
                    The system cannot<\/strong> 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.<\/p>\n
                    \n
                    Warning:<\/div>\n
                    \n
                    We do not<\/strong> recommend that you perform yum remove<\/code> operations with any ea-php<\/code> 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<\/code> operation, confirm that none of your hosted websites use the PHP version that you wish to remove with WHM\u2019s MultiPHP Manager<\/em> interface (WHM >> Home >> Software >> MultiPHP Manager<\/em>).<\/p>\n<\/p><\/div>\n<\/div>\n
                    To restore PHP versions to your system, run the following commands:<\/p>\n
                    \n
                    \n\n\n
                    \n
                    1\n<\/span>2\n<\/span><\/code><\/pre>\n<\/td>\n
                    		\n
                    ea_install_profile<\/span> --<\/span>install<\/span> \/<\/span>etc<\/span>\/<\/span>cpanel<\/span>\/<\/span>ea4<\/span>\/<\/span>profiles<\/span>\/<\/span>cpanel<\/span>\/<\/span>default<\/span>.json<\/span>\n\/<\/span>usr<\/span>\/<\/span>local<\/span>\/<\/span>cpanel<\/span>\/<\/span>scripts<\/span>\/<\/span>restartsrv<\/span> apache_php_fpm<\/span><\/code><\/pre>\n<\/td>\n<\/tr>\n<\/table>\n<\/div>\n<\/div>\n
                    \n
                    Note:<\/div>\n
                    \n
                    If the above commands fail, contact your system administrator.<\/p>\n<\/p><\/div>\n<\/div><\/div>\n","protected":false},"excerpt":{"rendered":"
                    Overview 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 …<\/p>\n","protected":false},"author":1,"featured_media":803,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[1],"tags":[],"amp_enabled":true,"_links":{"self":[{"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/posts\/802"}],"collection":[{"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/comments?post=802"}],"version-history":[{"count":0,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/posts\/802\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/media\/803"}],"wp:attachment":[{"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/media?parent=802"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/categories?post=802"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/tags?post=802"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}