php-src/sapi/fpm/php-fpm.conf.in

<?xml version="1.0" ?>
<configuration>

	All relative paths in this config are relative to php's install prefix

	<section name="global_options">

		Pid file
		<value name="pid_file">@EXPANDED_LOCALSTATEDIR@/run/php-fpm.pid</value>

		Error log file
		<value name="error_log">@EXPANDED_LOCALSTATEDIR@/log/php-fpm.log</value>

		Log level
		<value name="log_level">notice</value>

		When this amount of php processes exited with SIGSEGV or SIGBUS ...
		<value name="emergency_restart_threshold">10</value>

		... in a less than this interval of time, a graceful restart will be initiated.
		Useful to work around accidental curruptions in accelerator's shared memory.
		<value name="emergency_restart_interval">1m</value>

		Time limit on waiting child's reaction on signals from master
		<value name="process_control_timeout">5s</value>

		Set to 'no' to debug fpm
		<value name="daemonize">yes</value>

	</section>

	<workers>

		<section name="pool">

			Name of pool. Used in logs and stats.
			<value name="name">default</value>

			Address to accept fastcgi requests on.
			Valid syntax is 'ip.ad.re.ss:port' or just 'port' or '/path/to/unix/socket'
			<value name="listen_address">127.0.0.1:9000</value>

			<value name="listen_options">

				Set listen(2) backlog
				<value name="backlog">-1</value>

				Set permissions for unix socket, if one used.
				In Linux read/write permissions must be set in order to allow connections from web server.
				Many BSD-derrived systems allow connections regardless of permissions.
				<value name="owner">@php_fpm_user@</value>
				<value name="group">@php_fpm_group@</value>
				<value name="mode">0666</value>
			</value>

			Additional php.ini defines, specific to this pool of workers.
			These settings overwrite the values previously defined in the php.ini.
			<value name="php_defines">
				<!-- <value name="sendmail_path">/usr/sbin/sendmail -t -i</value> -->
				<!-- <value name="display_errors">0</value> -->
				<!-- <value name="error_log">/var/log/php-error.log</value> -->
        		<!-- <value name="log_errors">true</value> -->
			</value>

			Unix user of processes
			<value name="user">@php_fpm_user@</value>

			Unix group of processes
			<value name="group">@php_fpm_group@</value>

			Process manager settings
			<value name="pm">

				Sets style of controling worker process count.
				Valid values are 'static' and 'dynamic'
				<value name="style">static</value>

				Sets the limit on the number of simultaneous requests that will be served.
				Equivalent to Apache MaxClients directive.
				Equivalent to PHP_FCGI_CHILDREN environment in original php.fcgi
				Used with any pm_style.
				<value name="max_children">50</value>

				Sets the status URI to call to obtain php-fpm status page.
				If not set, no URI will be recognized as a status page.
				By default, it returns text/plain looking like:
				accepted conn:   12073
				pool:             default
				process manager:  static
				idle processes:   35
				active processes: 65
				total processes:  100
				"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": idle + active
				The last three number are uptaded every second.
				The "accepted conn" is updated in real time
				*** Output ***
				By default it returns text/plain
				But passing as a query string html or json, it will returns
				the corresponding output syntax:
				http://www.foo.bar/status
				http://www.foo.bar/status?json
				http://www.foo.bar/status?html
				*** WARNING ***
				It has to start with a /. It could be named has you want.
				It's maybe not a good idea to use .php extension to be certain
				not to conflict with a real PHP file
				<value name="status">/status</value>

				Set the ping URI to call the monitoring page of php-fpm
				If not set, no URI will be recognized as a ping page.
				This could be used to test from outside that php-fpm
				is alive and responding:
				- have a graph of php-fpm availability (rrd or such)
				- remove a server from a pool if it's not responding (load balancing systems)
				- trigger alerts for the operating team (24/7)
				*** WARNING ***
				It has to start with a /. It could be named has you want.
				It's maybe not a good idea to use .php extension to be certain
				not to conflict with a real PHP file
				<value name="ping">/ping</value>
				Set the response to custom the response of a ping request
				If 'pong' is not set, the default is "pong".
				The response is text/plain with a 200 response code
				<value name="pong">pong</value>

				Settings group for 'dynamic' pm style
				<value name="dynamic">

					Sets the number of server processes created on startup.
					Used only when 'dynamic' pm_style is selected
					<value name="start_servers">20</value>

					Sets the desired minimum number of idle server processes.
					Used only when 'dynamic' pm_style is selected
					<value name="min_spare_servers">5</value>

					Sets the desired maximum number of idle server processes.
					Used only when 'dynamic' pm_style is selected
					<value name="max_spare_servers">35</value>

				</value>

			</value>

			The timeout (in seconds) for serving a single request after which the worker process will be terminated
			Should be used when 'max_execution_time' ini option does not stop script execution for some reason
			'0s' means 'off'
			<value name="request_terminate_timeout">0s</value>

			The timeout (in seconds) for serving of single request after which a php backtrace will be dumped to slow.log file
			'0s' means 'off'
			<value name="request_slowlog_timeout">0s</value>

			The log file for slow requests
			<value name="slowlog">@EXPANDED_LOCALSTATEDIR@/log/php-fpm.log.slow</value>

			Set open file desc rlimit
			<value name="rlimit_files">1024</value>

			Set max core size rlimit
			<value name="rlimit_core">0</value>

			Chroot to this directory at the start, absolute path
			<value name="chroot"></value>

			Chdir to this directory at the start, absolute path
			<value name="chdir"></value>

			Redirect workers' stdout and stderr into main error log.
			If not set, they will be redirected to /dev/null, according to FastCGI specs
			<value name="catch_workers_output">yes</value>

			How much requests each process should execute before respawn.
			Useful to work around memory leaks in 3rd party libraries.
			For endless request processing please specify 0
			Equivalent to PHP_FCGI_MAX_REQUESTS
			<value name="max_requests">500</value>

			Comma separated list of ipv4 addresses of FastCGI clients that allowed to connect.
			Equivalent to FCGI_WEB_SERVER_ADDRS environment in original php.fcgi (5.2.2+)
			Makes sense only with AF_INET listening socket.
			<value name="allowed_clients">127.0.0.1</value>

			Pass environment variables like LD_LIBRARY_PATH
			All $VARIABLEs are taken from current environment
			<value name="environment">
				<value name="HOSTNAME">$HOSTNAME</value>
				<value name="PATH">/usr/local/bin:/usr/bin:/bin</value>
				<value name="TMP">/tmp</value>
				<value name="TMPDIR">/tmp</value>
				<value name="TEMP">/tmp</value>
				<value name="OSTYPE">$OSTYPE</value>
				<value name="MACHTYPE">$MACHTYPE</value>
				<value name="MALLOC_CHECK_">2</value>
			</value>

		</section>

	</workers>

</configuration>