{"id":798,"date":"2021-07-23T12:38:25","date_gmt":"2021-07-23T12:38:25","guid":{"rendered":"https:\/\/ssdsunucum.com\/blog\/configuration-values-of-php-fpm\/"},"modified":"2021-07-23T12:38:25","modified_gmt":"2021-07-23T12:38:25","slug":"configuration-values-of-php-fpm","status":"publish","type":"post","link":"https:\/\/ssdsunucum.com\/blog\/configuration-values-of-php-fpm\/","title":{"rendered":"Configuration Values of PHP-FPM"},"content":{"rendered":"<\/p>\n
\n
<\/div>\n
\n

Overview<\/h2>\n

This document lists the PHP-FPM system\u2019s configuration settings and their default values. This document also explains how to add additional settings to your system\u2019s PHP-FPM configuration.<\/p>\n

You can configure some of the global directives and pool options through WHM\u2019s MultiPHP Manager<\/em> interface (WHM >> Home >> Software >> MultiPHP Manager<\/em>).<\/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.<\/p>\n<\/p><\/div>\n<\/div>\n

Global directives<\/h2>\n

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

    \n
  • Key<\/code> \u2014 The entry in the .yaml<\/code> file.<\/li>\n
  • Name<\/code> \u2014 The pool name in the \/var\/cpanel\/ApachePHPFPM\/system_pool_defaults.yaml<\/code> configuration file.\n
    \n
    More:<\/div>\n
    \n For more information about pool names, read our PHP-FPM Domain Pools documentation.\n <\/div>\n<\/div>\n<\/li>\n
  • Present if not listed<\/code> \u2014 When you set this value to Yes<\/code>, the system adds the value to the \/var\/cpanel\/userdata\/user\/domain.php-fpm.yaml<\/code> configuration file, where user<\/code> represents the cPanel user\u2019s name and domain<\/code> represents the domain.<\/li>\n
  • Default<\/code> \u2014 The template value that resides in the \/var\/cpanel\/ApachePHPFPM\/system.yaml<\/code> configuration file.<\/li>\n<\/ul>\n
    \n
    Warning:<\/div>\n
    \n
      \n
    • You must normalize the period character .<\/code> to an underscore character _<\/code> for all key names when you create or modify the \/var\/cpanel\/ApachePHPFPM\/system.yaml<\/code> file. For example, you would normalize syslog.ident<\/code> to syslog_ident<\/code>. Otherwise, the system may not<\/strong> accept the key name.<\/li>\n
    • Exercise extreme<\/strong> caution when you manually edit .yaml<\/code> files. Incorrect syntax in these files will cause services to fail. We strongly<\/strong> suggest that you create a backup of your system before you manually edit .yaml<\/code> files.<\/li>\n<\/ul><\/div>\n<\/div>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
      Key<\/th>\nName<\/th>\nPresent if not listed<\/th>\nDefault<\/th>\n<\/tr>\n<\/thead>\n
      daemonize<\/code><\/td>\ndaemonize<\/code><\/td>\nYes<\/td>\nno<\/code><\/td>\n<\/tr>\n
      emergency_restart_interval<\/code><\/td>\nemergency_restart_interval<\/code><\/td>\nYes<\/td>\n0<\/code><\/td>\n<\/tr>\n
      emergency_restart_threshold<\/code><\/td>\nemergency_restart_threshold<\/code><\/td>\nYes<\/td>\n0<\/code><\/td>\n<\/tr>\n
      error_log<\/code><\/td>\nerror_log<\/code><\/td>\nYes<\/td>\n\/opt\/cpanel\/[% ea_php_version %]\/root\/usr\/var\/log\/php-fpm\/error.log<\/code><\/td>\n<\/tr>\n
      events_mechanism<\/code><\/td>\nevents.mechanism<\/code><\/td>\nNo<\/td>\nN\/A<\/code><\/td>\n<\/tr>\n
      log_level<\/code><\/td>\nlog_level<\/code><\/td>\nYes<\/td>\nnotice<\/code><\/td>\n<\/tr>\n
      pid<\/code><\/td>\npid<\/code><\/td>\nYes<\/td>\n\/opt\/cpanel\/[% ea_php_version %]\/root\/usr\/var\/run\/php-fpm\/php-fpm.pid<\/code><\/td>\n<\/tr>\n
      process_control_timeout<\/code><\/td>\nprocess_control_timeout<\/code><\/td>\nYes<\/td>\n10<\/code><\/td>\n<\/tr>\n
      process_max<\/code><\/td>\nprocess_max<\/code><\/td>\nNo<\/td>\n0<\/code><\/td>\n<\/tr>\n
      process_priority<\/code><\/td>\nprocess.priority<\/code><\/td>\nNo<\/td>\nN\/A<\/code><\/td>\n<\/tr>\n
      rlimit_core<\/code><\/td>\nrlimit_core<\/code><\/td>\nNo<\/td>\n0<\/code><\/td>\n<\/tr>\n
      rlimit_files<\/code><\/td>\nrlimit_files<\/code><\/td>\nNo<\/td>\nN\/A<\/code><\/td>\n<\/tr>\n
      syslog_facility<\/code><\/td>\nsyslog.facility<\/code><\/td>\nNo<\/td>\ndaemon<\/code><\/td>\n<\/tr>\n
      syslog_ident<\/code><\/td>\nsyslog.ident<\/code><\/td>\nNo<\/td>\nphp-fpm<\/code><\/td>\n<\/tr>\n
      systemd_interval<\/code><\/td>\nsystemd_interval<\/code><\/td>\nNo<\/td>\n10<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

      Pool name directives<\/h2>\n

      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<\/code> file.<\/p>\n

      \n
      Important:<\/div>\n
      \n

      To avoid directive configuration errors, you must follow these syntax rules:<\/p>\n

        \n
      • \n

        You must<\/strong> use single quotation marks ' '<\/code> at the beginning and end of strings with double quotation marks \" \"<\/code>. The YAML parser automatically removes quotation marks from string values. This means that values that require double quotation marks must<\/strong> use single quotation marks before and after the double quotation marks to retain their value.<\/p>\n<\/li>\n

      • \n

        You must<\/strong> use an escape character <\/code> with any double quotation marks \" \"<\/code> that you use inside of the string.<\/p>\n<\/li>\n<\/ul><\/div>\n<\/div>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
        Key<\/th>\nName<\/th>\nPresent if not listed<\/th>\nDefault<\/th>\n<\/tr>\n<\/thead>\n
        catch_workers_output<\/code><\/td>\ncatch_workers_output<\/code><\/td>\nYes<\/td>\nyes<\/code><\/td>\n<\/tr>\n
        chdir<\/code><\/td>\nchdir<\/code><\/td>\nYes<\/td>\n[% homedir %]<\/code><\/td>\n<\/tr>\n
        chroot<\/code><\/td>\nchroot<\/code><\/td>\nNo<\/td>\nN\/A<\/code><\/td>\n<\/tr>\n
        clear_env<\/code><\/td>\nclear_env<\/code><\/td>\nNo<\/td>\nN\/A<\/code><\/td>\n<\/tr>\n
        group<\/code><\/td>\ngroup<\/code><\/td>\nYes<\/td>\nnobody<\/code><\/td>\n<\/tr>\n
        listen<\/code><\/td>\nlisten<\/code><\/td>\nYes<\/td>\n\"[% socket_path %]\"<\/code><\/td>\n<\/tr>\n
        listen_acl_groups<\/code><\/td>\nlisten.acl_groups<\/code><\/td>\nNo<\/td>\nN\/A<\/code><\/td>\n<\/tr>\n
        listen_acl_users<\/code><\/td>\nlisten.acl_users<\/code><\/td>\nNo<\/td>\nN\/A<\/code><\/td>\n<\/tr>\n
        listen_allowed_clients<\/code><\/td>\nlisten.allowed_clients<\/code><\/td>\nNo<\/td>\nany<\/code><\/td>\n<\/tr>\n
        listen_backlog<\/code><\/td>\nlisten.backlog<\/code><\/td>\nNo<\/td>\n-1<\/code><\/td>\n<\/tr>\n
        listen_group<\/code><\/td>\nlisten.group<\/code><\/td>\nNo<\/td>\nnobody<\/code><\/td>\n<\/tr>\n
        listen_mode<\/code><\/td>\nlisten.mode<\/code><\/td>\nNo<\/td>\n0660<\/code><\/td>\n<\/tr>\n
        listen_owner<\/code><\/td>\nlisten.owner<\/code><\/td>\nNo<\/td>\n\"[% username %]\"<\/code><\/td>\n<\/tr>\n
        php_admin_flag_allow_url_fopen<\/code><\/td>\nphp_admin_flag[allow_url_fopen]<\/code><\/td>\nYes<\/td>\non<\/code><\/td>\n<\/tr>\n
        php_admin_flag_log_errors<\/code><\/td>\nphp_admin_flag[log_errors]<\/code><\/td>\nYes<\/td>\non<\/code><\/td>\n<\/tr>\n
        php_admin_value_disable_functions<\/code><\/td>\nphp_admin_value[disable_functions]<\/code><\/td>\nYes<\/td>\nexec,passthru,shell_exec,system<\/code><\/td>\n<\/tr>\n
        php_admin_value_doc_root<\/code><\/td>\nphp_admin_value[doc_root]<\/code><\/td>\nYes<\/td>\n[% documentroot %]<\/code> <\/p>\n
        \n
        Note:<\/div>\n
        \n
          \n
        • When you specify a vhost document root for subdomains, the system does not<\/strong> escape the vhost correctly in the subdomain\u2019s PHP-FPM configuration file.<\/li>\n
        • PHP-FPM does not<\/strong> process certain characters in the document root unless you add double quotes \"\"<\/code> around the document root.<\/li>\n
        • You can also add the colon :<\/code>, semicolon ;<\/code>, and parenthesis ()<\/code> characters to the document root.<\/li>\n<\/ul><\/div>\n<\/div>\n<\/td>\n<\/tr>\n
        php_admin_value_error_log<\/code><\/td>\nphp_admin_value[error_log]<\/code><\/td>\nYes<\/td>\n[% homedir %]\/logs\/[% scrubbed_domain %].php.error.log<\/code> <\/p>\n
        \n
        Note:<\/div>\n
        \n

        The system normalizes the period character .<\/code> to an underscore character _<\/code> for the domain.
        \nFor example, the \/home\/example\/logs\/example.net.php.error.log<\/code> file becomes the \/home\/example\/logs\/example_net.php.error.log<\/code> file, where example<\/code> represents the username and example_net<\/code> represents the domain name.<\/p>\n<\/p><\/div>\n<\/div>\n<\/td>\n<\/tr>\n

        php_admin_value_short_open_tag<\/code><\/td>\nphp_admin_value[short_open_tag]<\/code><\/td>\nYes<\/td>\non<\/code><\/td>\n<\/tr>\n
        php_value_error_reporting<\/code><\/td>\nphp_value[error_reporting]<\/code><\/td>\nYes<\/td>\nE_ALL & ~E_NOTICE<\/code><\/td>\n<\/tr>\n
        php_value_session_save_handler<\/code><\/td>\nphp_value[session.save_handler]<\/code><\/td>\nNo<\/td>\nN\/A<\/code><\/td>\n<\/tr>\n
        php_value_session_save_path<\/code><\/td>\nphp_value[session.save_path]<\/code><\/td>\nNo<\/td>\nN\/A<\/code><\/td>\n<\/tr>\n
        php_value_soap_wsdl_cache_dir<\/code><\/td>\nphp_value[soap.wsdl_cache_dir]<\/code><\/td>\nNo<\/td>\nN\/A<\/code><\/td>\n<\/tr>\n
        ping_path<\/code><\/td>\nping.path<\/code><\/td>\nYes<\/td>\n\/ping<\/code><\/td>\n<\/tr>\n
        pm<\/code><\/td>\npm<\/code><\/td>\nYes<\/td>\nondemand<\/code><\/td>\n<\/tr>\n
        pm_max_children<\/code><\/td>\npm.max_children<\/code><\/td>\nYes<\/td>\n5<\/code><\/td>\n<\/tr>\n
        pm_max_requests<\/code><\/td>\npm.max_requests<\/code><\/td>\nYes<\/td>\n20<\/code><\/td>\n<\/tr>\n
        pm_max_spare_servers<\/code><\/td>\npm.max_spare_servers<\/code><\/td>\nYes<\/td>\n5<\/code><\/td>\n<\/tr>\n
        pm_min_spare_servers<\/code><\/td>\npm.min_spare_servers<\/code><\/td>\nYes<\/td>\n1<\/code><\/td>\n<\/tr>\n
        pm_process_idle_timeout<\/code><\/td>\npm.process_idle_timeout<\/code><\/td>\nYes<\/td>\n10<\/code><\/td>\n<\/tr>\n
        pm_start_servers<\/code><\/td>\npm.start_servers<\/code><\/td>\nYes<\/td>\n0<\/code><\/td>\n<\/tr>\n
        pm_status_path<\/code><\/td>\npm.status_path<\/code><\/td>\nYes<\/td>\n\/status<\/code><\/td>\n<\/tr>\n
        request_slowlog_timeout<\/code><\/td>\nrequest_slowlog_timeout<\/code><\/td>\nNo<\/td>\nN\/A<\/code><\/td>\n<\/tr>\n
        request_terminate_timeout<\/code><\/td>\nrequest_terminate_timeout<\/code><\/td>\nNo<\/td>\nN\/A<\/code><\/td>\n<\/tr>\n
        rlimit_core<\/code><\/td>\nrlimit_core<\/code><\/td>\nNo<\/td>\nN\/A<\/code><\/td>\n<\/tr>\n
        rlimit_files<\/code><\/td>\nrlimit_files<\/code><\/td>\nNo<\/td>\nN\/A<\/code><\/td>\n<\/tr>\n
        security_limit_extensions<\/code><\/td>\nsecurity.limit_extensions<\/code><\/td>\nYes<\/td>\nThe system allows the following options: <\/p>\n
          \n
        • .phtml<\/code><\/li>\n
        • .php<\/code> <\/li>\n
        • .php3<\/code><\/li>\n
        • .php4<\/code><\/li>\n
        • .php5<\/code><\/li>\n
        • .php6<\/code><\/li>\n
        • .php7<\/code><\/li>\n<\/ul>\n<\/td>\n<\/tr>\n
        slowlog<\/code><\/td>\nslowlog<\/code><\/td>\nNo<\/td>\nN\/A<\/code><\/td>\n<\/tr>\n
        user<\/code><\/td>\nuser<\/code><\/td>\nYes<\/td>\n\"[% username %]\"<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
        \n
        Note:<\/div>\n
        \n

        For more information about pool names, read our PHP-FPM Domain Pools documentation.<\/p>\n<\/p><\/div>\n<\/div>\n

        Add a value to a configuration<\/h3>\n

        A complete configuration directive line would resemble the following example:<\/p>\n

        \n
        php_value_open_basedir: { name: 'php_value[open_basedir]'<\/span>, value: \"[% documentroot %]\"<\/span> }<\/code><\/pre>\n<\/div>\n
        This example contains the following values:<\/p>\n
          \n
        • php_value_open_basedir<\/code> represents the Key<\/code> entry.\n
            \n
          • The Key<\/code> entry must only<\/strong> contain letters, numbers, and underscores.<\/li>\n<\/ul>\n<\/li>\n
          • php_value[openbasedir]<\/code> represents the pool name.<\/li>\n
          • documentroot<\/code> represents the configuration value.<\/li>\n<\/ul>\n
            Add an unknown value to a configuration<\/h3>\n
            You can add a value that cPanel & WHM does not currently provide as a default with a YAML map.<\/p>\n
            To create a YAML map, add a line to the configuration file that resembles the following example:<\/p>\n
            \n
            php_admin_value_ldap_max_links: { name: 'php_admin_value[ldap.max_links]', value: -1 }<\/code><\/pre>\n<\/div>\n
            This example contains the following values:<\/p>\n
              \n
            • php_admin_value_ldap_max_links<\/code> represents the Key<\/code> entry.\n
                \n
              • The Key<\/code> entry must only<\/strong> contain letters, numbers, and underscores.<\/li>\n<\/ul>\n<\/li>\n
              • php_admin_value[ldap.max_links]<\/code> represents the pool name.<\/li>\n
              • -1<\/code> represents the configuration value.<\/li>\n<\/ul>\n
                \n
                Important:<\/div>\n
                \n
                If you prepend any PHP settings with the php_value<\/code> or php_flag<\/code> flags, the system will overwrite any previous php.ini<\/code> values that you set in the user\u2019s .htaccess<\/code> files. To remove these flags, run the following commands:\n    <\/p>\n
                \n
                \n\n\n
                \n
                1\n<\/span>2\n<\/span><\/code><\/pre>\n<\/td>\n
                		\n
                    find<\/span> \/<\/span>home<\/span> -<\/span>type<\/span> f<\/span> -<\/span>name<\/span> '<\/span>.htaccess<\/span>'<\/span> -<\/span>exec<\/span> grep<\/span> -<\/span>Hrn<\/span> '<\/span>php_value<\/span>' '<\/span>{}'<\/span> <\/span>;\n    find<\/span> \/<\/span>home<\/span> -<\/span>type<\/span> f<\/span> -<\/span>name<\/span> '<\/span>.htaccess<\/span>'<\/span> -<\/span>exec<\/span> grep<\/span> -<\/span>Hrn<\/span> '<\/span>php_flag<\/span>' '<\/span>{}'<\/span> <\/span>;<\/span><\/span><\/code><\/pre>\n<\/td>\n<\/tr>\n<\/table>\n<\/div>\n<\/div>\n
                For more information, read our How to Manage Your php.ini Directives with PHP-FPM documentation.<\/p>\n<\/p><\/div>\n<\/div><\/div>\n","protected":false},"excerpt":{"rendered":"
                Overview This document lists the PHP-FPM system\u2019s configuration settings and their default values. This document also explains how to add additional settings to your system\u2019s PHP-FPM configuration. You can configure some of the global directives and pool options through WHM\u2019s MultiPHP Manager interface (WHM >> Home >> Software >> MultiPHP Manager). Warning: We strongly recommend …<\/p>\n","protected":false},"author":1,"featured_media":799,"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\/798"}],"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=798"}],"version-history":[{"count":0,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/posts\/798\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/media\/799"}],"wp:attachment":[{"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/media?parent=798"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/categories?post=798"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ssdsunucum.com\/blog\/wp-json\/wp\/v2\/tags?post=798"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}