Puppet Defined Type: pool

Defined in:
manifests/fpm/pool.pp

Overview

Configure fpm pools

Parameters

See the official php-fpm documentation for parameters that are not documented here: php.net/manual/en/install.fpm.configuration.php.

ensure

Remove pool if set to `'absent'`, add otherwise

listen

On what socket to listen for FastCGI connections, i.e. `'127.0.0.1:9000'' or `'/var/run/php5-fpm.sock'`

listen_backlog
listen_allowed_clients
listen_owner

Set owner of the Unix socket

listen_group

Set the group of the Unix socket

listen_mode
user

Which user the php-fpm process to run as

group

Which group the php-fpm process to run as

pm
pm_max_children
pm_start_servers
pm_min_spare_servers
pm_max_spare_servers
pm_max_requests
pm_status_path
ping_path
ping_response
access_log

The path to the file to write access log requests to

access_log_format

The format to save the access log entries as

request_terminate_timeout
request_slowlog_timeout
security_limit_extensions
slowlog
template

The template to use for the pool

rlimit_files
rlimit_core
chroot
chdir
catch_workers_output
include

Other configuration files to include on this pool

env

List of environment variables that are passed to the php-fpm from the outside and will be available to php scripts in this pool

env_value

Hash of environment variables and values as strings to use in php scripts in this pool

options

An optional hash for any other data.

php_value

Hash of php_value directives

php_flag

Hash of php_flag directives

php_admin_value

Hash of php_admin_value directives

php_admin_flag

Hash of php_admin_flag directives

php_directives

List of custom directives that are appended to the pool config

root_group

UNIX group of the root user

base_dir

The folder that contains the php-fpm pool configs. This defaults to a sensible default depending on your operating system, like '/etc/php5/fpm/pool.d' or '/etc/php-fpm.d'

Parameter Summary

  • ensure (Any) => 'present'
  • listen (Any) => '127.0.0.1:9000'
  • listen_backlog (Any) => '-1'
  • listen_allowed_clients (Any) => undef
  • listen_owner (Any) => undef
  • listen_group (Any) => undef
  • listen_mode (Any) => undef
  • user (Any) => $::php::fpm::config::user
  • group (Any) => $::php::fpm::config::group
  • pm (Any) => 'dynamic'
  • pm_max_children (Any) => '50'
  • pm_start_servers (Any) => '5'
  • pm_min_spare_servers (Any) => '5'
  • pm_max_spare_servers (Any) => '35'
  • pm_max_requests (Any) => '0'
  • pm_status_path (Any) => undef
  • ping_path (Any) => undef
  • ping_response (Any) => 'pong'
  • access_log (Any) => undef
  • access_log_format (Any) => "%R - %u %t \"%m %r\" %s"
  • request_terminate_timeout (Any) => '0'
  • request_slowlog_timeout (Any) => '0'
  • security_limit_extensions (Any) => undef
  • slowlog (Any) => "/var/log/php-fpm/${name}-slow.log"
  • template (Any) => 'php/fpm/pool.conf.erb'
  • rlimit_files (Any) => undef
  • rlimit_core (Any) => undef
  • chroot (Any) => undef
  • chdir (Any) => undef
  • catch_workers_output (Any) => 'no'
  • include (Any) => undef
  • env (Any) => []
  • env_value (Any) => {}
  • options (Any) => {}
  • php_value (Any) => {}
  • php_flag (Any) => {}
  • php_admin_value (Any) => {}
  • php_admin_flag (Any) => {}
  • php_directives (Any) => []
  • root_group (Any) => $::php::params::root_group
  • base_dir (Any) => undef