Mercurial > repos > other > Puppet
view modules/php/templates/fpm/pool.conf.erb @ 432:d05e9281909c
Remove now abandoned Strike Creations website
author | IBBoard <dev@ibboard.co.uk> |
---|---|
date | Tue, 21 Feb 2023 15:54:18 +0000 |
parents | 3fce34f642f1 |
children |
line wrap: on
line source
[<%= @pool %>] ; The address on which to accept FastCGI requests. listen = <%= @listen %> ; Set listen(2) backlog. A value of '-1' means unlimited. listen.backlog = <%= @listen_backlog %> ; List of ipv4 addresses of FastCGI clients which are allowed to connect. ; Equivalent to the FCGI_WEB_SERVER_ADDRS environment variable in the original ; PHP FCGI (5.2.2+). Makes sense only with a tcp listening socket. Each address ; must be separated by a comma. If this value is left blank, connections will be ; accepted from any ip address. ; Default Value: any <% if @listen_allowed_clients -%> listen.allowed_clients = <%= @listen_allowed_clients %> <% else -%> ;listen.allowed_clients = 127.0.0.1 <% end -%> ; Set permissions for unix socket, if one is used. In Linux, read/write ; permissions must be set in order to allow connections from a web server. Many ; BSD-derived systems allow connections regardless of permissions. ; Default Values: user and group are set as the running user ; mode is set to 0666 <% if @listen_owner -%> listen.owner = <%= @listen_owner %> <% else -%> ;listen.owner = nobody <% end -%> <% if @listen_group -%> listen.group = <%= @listen_group %> <% else -%> ;listen.group = nobody <% end -%> <% if @listen_mode -%> listen.mode = <%= @listen_mode %> <% else -%> ;listen.mode = 0660 <% end -%> ; Unix user/group of processes ; Note: The user is mandatory. If the group is not set, the default user's group ; will be used. ; RPM: apache Choosed to be able to access some dir as httpd user = <%= @user %> ; RPM: Keep a group allowed to write in log dir. group = <%= @group_final %> <% if @apparmor_hat -%> ; Apparmor hat to change to apparmor_hat = <%= @apparmor_hat %> <% end -%> ; Choose how the process manager will control the number of child processes. ; Possible Values: ; static - a fixed number (pm.max_children) of child processes; ; dynamic - the number of child processes are set dynamically based on the ; following directives: ; pm.max_children - the maximum number of children that can ; be alive at the same time. ; pm.start_servers - the number of children created on startup. ; pm.min_spare_servers - the minimum number of children in 'idle' ; state (waiting to process). If the number ; of 'idle' processes is less than this ; number then some children will be created. ; pm.max_spare_servers - the maximum number of children in 'idle' ; state (waiting to process). If the number ; of 'idle' processes is greater than this ; number then some children will be killed. ; ondemand - no children are created at startup. Children will be forked when ; new requests will connect. The following parameter are used: ; pm.max_children - the maximum number of children that ; can be alive at the same time. ; pm.process_idle_timeout - The number of seconds after which ; an idle process will be killed. ; Note: This value is mandatory. pm = <%= @pm %> ; The number of child processes to be created when pm is set to 'static' and the ; maximum number of child processes to be created when pm is set to 'dynamic'. ; This value sets the limit on the number of simultaneous requests that will be ; served. Equivalent to the ApacheMaxClients directive with mpm_prefork. ; Equivalent to the PHP_FCGI_CHILDREN environment variable in the original PHP ; CGI. ; Note: Used when pm is set to either 'static' or 'dynamic' ; Note: This value is mandatory. pm.max_children = <%= @pm_max_children %> ; The number of child processes created on startup. ; Note: Used only when pm is set to 'dynamic' ; Default Value: min_spare_servers + (max_spare_servers - min_spare_servers) / 2 pm.start_servers = <%= @pm_start_servers %> ; The desired minimum number of idle server processes. ; Note: Used only when pm is set to 'dynamic' ; Note: Mandatory when pm is set to 'dynamic' pm.min_spare_servers = <%= @pm_min_spare_servers %> ; The desired maximum number of idle server processes. ; Note: Used only when pm is set to 'dynamic' ; Note: Mandatory when pm is set to 'dynamic' pm.max_spare_servers = <%= @pm_max_spare_servers %> ; The number of seconds after which an idle process will be killed. ; Note: Used only when pm is set to 'ondemand' ; Default Value: 10s pm.process_idle_timeout = <%= @pm_process_idle_timeout %> ; The number of requests each child process should execute before respawning. ; This can be useful to work around memory leaks in 3rd party libraries. For ; endless request processing specify '0'. Equivalent to PHP_FCGI_MAX_REQUESTS. ; Default Value: 0 pm.max_requests = <%= @pm_max_requests %> ; The URI to view the FPM status page. If this value is not set, no URI will be ; recognized as a status page. By default, the status page shows the following ; information: ; accepted conn - the number of request accepted by the pool; ; pool - the name of the pool; ; process manager - static or dynamic; ; idle processes - the number of idle processes; ; active processes - the number of active processes; ; total processes - the number of idle + active processes. ; The values of 'idle processes', 'active processes' and 'total processes' are ; updated each second. The value of 'accepted conn' is updated in real time. ; Example output: ; accepted conn: 12073 ; pool: www ; process manager: static ; idle processes: 35 ; active processes: 65 ; total processes: 100 ; By default the status page output is formatted as text/plain. Passing either ; 'html' or 'json' as a query string will return the corresponding output ; syntax. Example: ; http://www.foo.bar/status ; http://www.foo.bar/status?json ; http://www.foo.bar/status?html ; Note: The value must start with a leading slash (/). The value can be ; anything, but it may not be a good idea to use the .php extension or it ; may conflict with a real PHP file. ; Default Value: not set <% if @pm_status_path -%> pm.status_path = <%= @pm_status_path %> <% else -%> ;pm.status_path = /status <% end -%> ; The ping URI to call the monitoring page of FPM. If this value is not set, no ; URI will be recognized as a ping page. This could be used to test from outside ; that FPM is alive and responding, or to ; - create a graph of FPM availability (rrd or such); ; - remove a server from a group if it is not responding (load balancing); ; - trigger alerts for the operating team (24/7). ; Note: The value must start with a leading slash (/). The value can be ; anything, but it may not be a good idea to use the .php extension or it ; may conflict with a real PHP file. ; Default Value: not set <% if @ping_path -%> ping.path = <%= @ping_path %> <% else -%> ;ping.path = /ping <% end -%> ; This directive may be used to customize the response of a ping request. The ; response is formatted as text/plain with a 200 response code. ; Default Value: pong ping.response = <%= @ping_response %> ; The access log file ; Default: not set <% if @access_log -%> access.log = <%= @access_log %> <% end -%> ; The access log format. ; The following syntax is allowed ; %%: the '%' character ; %C: %CPU used by the request ; it can accept the following format: ; - %{user}C for user CPU only ; - %{system}C for system CPU only ; - %{total}C for user + system CPU (default) ; %d: time taken to serve the request ; it can accept the following format: ; - %{seconds}d (default) ; - %{miliseconds}d ; - %{mili}d ; - %{microseconds}d ; - %{micro}d ; %e: an environment variable (same as $_ENV or $_SERVER) ; it must be associated with embraces to specify the name of the env ; variable. Some exemples: ; - server specifics like: %{REQUEST_METHOD}e or %{SERVER_PROTOCOL}e ; - HTTP headers like: %{HTTP_HOST}e or %{HTTP_USER_AGENT}e ; %f: script filename ; %l: content-length of the request (for POST request only) ; %m: request method ; %M: peak of memory allocated by PHP ; it can accept the following format: ; - %{bytes}M (default) ; - %{kilobytes}M ; - %{kilo}M ; - %{megabytes}M ; - %{mega}M ; %n: pool name ; %o: ouput header ; it must be associated with embraces to specify the name of the header: ; - %{Content-Type}o ; - %{X-Powered-By}o ; - %{Transfert-Encoding}o ; - .... ; %p: PID of the child that serviced the request ; %P: PID of the parent of the child that serviced the request ; %q: the query string ; %Q: the '?' character if query string exists ; %r: the request URI (without the query string, see %q and %Q) ; %R: remote IP address ; %s: status (response code) ; %t: server time the request was received ; it can accept a strftime(3) format: ; %d/%b/%Y:%H:%M:%S %z (default) ; %T: time the log has been written (the request has finished) ; it can accept a strftime(3) format: ; %d/%b/%Y:%H:%M:%S %z (default) ; %u: remote user ; ; Default: "%R - %u %t \"%m %r\" %s" access.format = <%= @access_log_format %> ; The timeout for serving a single request after which the worker process will ; be killed. This option should be used when the 'max_execution_time' ini option ; does not stop script execution for some reason. A value of '0' means 'off'. ; Available units: s(econds)(default), m(inutes), h(ours), or d(ays) ; Default Value: 0 request_terminate_timeout = <%= @request_terminate_timeout %> ; The timeout for serving a single request after which a PHP backtrace will be ; dumped to the 'slowlog' file. A value of '0s' means 'off'. ; Available units: s(econds)(default), m(inutes), h(ours), or d(ays) ; Default Value: 0 request_slowlog_timeout = <%= @request_slowlog_timeout %> ; The log file for slow requests ; Default Value: not set ; Note: slowlog is mandatory if request_slowlog_timeout is set slowlog = <%= @slowlog %> ; Set open file descriptor rlimit. ; Default Value: system defined value <% if @rlimit_files -%> rlimit_files = <%= @rlimit_files %> <% else -%> ;rlimit_files = 1024 <% end -%> ; Set max core size rlimit. ; Possible Values: 'unlimited' or an integer greater or equal to 0 ; Default Value: system defined value <% if @rlimit_core -%> rlimit_core = <%= @rlimit_core %> <% else -%> ;rlimit_core = 0 <% end -%> ; Chroot to this directory at the start. This value must be defined as an ; absolute path. When this value is not set, chroot is not used. ; Note: chrooting is a great security feature and should be used whenever ; possible. However, all PHP paths will be relative to the chroot ; (error_log, sessions.save_path, ...). ; Default Value: not set <% if @chroot -%> chroot = <%= @chroot %> <% else -%> ;chroot = <% end -%> ; Chdir to this directory at the start. This value must be an absolute path. ; Default Value: current directory or / when chroot <% if @chdir -%> chdir = <%= @chdir %> <% else -%> ;chdir = /var/www <% end -%> ; Redirect worker stdout and stderr into main error log. If not set, stdout and ; stderr will be redirected to /dev/null according to FastCGI specs. ; Default Value: no catch_workers_output = <%= @catch_workers_output %> ; Include one or more files. If glob(3) exists, it is used to include a bunch of ; files from a glob(3) pattern. This directive can be used everywhere in the ; file. ; Relative path can also be used. They will be prefixed by: ; - the global prefix if it's been set (-p arguement) ; - /usr otherwise <% if @include -%> include=<%= @include %> <% else -%> ;include=/etc/php5/fpm/*.conf <% end -%> ; Pass environment variables like LD_LIBRARY_PATH. All $VARIABLEs are taken from ; the current environment. ; Default Value: clean env ;env[HOSTNAME] = $HOSTNAME ;env[PATH] = /usr/local/bin:/usr/bin:/bin ;env[TMP] = /tmp ;env[TMPDIR] = /tmp ;env[TEMP] = /tmp <% if @clear_env -%> <% @env.each do |var| -%> env[<%= var %>] = $<%= var %> <% end -%> <% @env_value.sort_by {|key,value| key}.each do |key,value| -%> <% if !value.empty? -%> env[<%= key %>] = '<%= value %>' <% end -%> <% end -%> <% else -%> clear_env = no <% end -%> ; Additional php.ini defines, specific to this pool of workers. These settings ; overwrite the values previously defined in the php.ini. The directives are the ; same as the PHP SAPI: ; php_value/php_flag - you can set classic ini defines which can ; be overwritten from PHP call 'ini_set'. ; php_admin_value/php_admin_flag - these directives won't be overwritten by ; PHP call 'ini_set' ; For php_*flag, valid values are on, off, 1, 0, true, false, yes or no. ; Defining 'extension' will load the corresponding shared extension from ; extension_dir. Defining 'disable_functions' or 'disable_classes' will not ; overwrite previously defined php.ini values, but will append the new value ; instead. ; Default Value: nothing is defined by default except the values in php.ini and ; specified at startup with the -d argument ;php_admin_value[sendmail_path] = /usr/sbin/sendmail -t -i -f www@my.domain.com ;php_flag[display_errors] = off ;php_admin_value[error_log] = /var/log/php-fpm/www-error.log ;php_admin_flag[log_errors] = on ;php_admin_value[memory_limit] = 32M ; ; Custom PHP values ; <% @php_value.sort_by {|key,value| key}.each do |key,value| -%> php_value[<%= key %>] = <%= value %> <% end -%> ; ; Custom PHP flags ; <% @php_flag.sort_by {|key,flag| key}.each do |key,flag| -%> php_flag[<%= key %>] = <%= flag %> <% end -%> ; ; Custom PHP admin values ; <% @php_admin_value.sort_by {|key,value| key}.each do |key,value| -%> php_admin_value[<%= key %>] = <%= value %> <% end -%> ; ; Custom PHP admin flags ; <% @php_admin_flag.sort_by {|key,flag| key}.each do |key,flag| -%> php_admin_flag[<%= key %>] = <%= flag %> <% end -%> ; ; Custom PHP directives ; <% @php_directives.each do |line| -%> <%= line.gsub "{", "%{" %> <% end -%> <% unless @security_limit_extensions.empty? -%> security.limit_extensions = <%= @security_limit_extensions.join(" ") %> <% end -%>