php-fpm.conf 17 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384
  1. ; Start a new pool named 'www'.
  2. ; the variable $pool can we used in any directive and will be replaced by the
  3. ; pool name ('www' here)
  4. [www]
  5. ; Per pool prefix
  6. ; It only applies on the following directives:
  7. ; - 'slowlog'
  8. ; - 'listen' (unixsocket)
  9. ; - 'chroot'
  10. ; - 'chdir'
  11. ; - 'php_values'
  12. ; - 'php_admin_values'
  13. ; When not set, the global prefix (or /usr) applies instead.
  14. ; Note: This directive can also be relative to the global prefix.
  15. ; Default Value: none
  16. ;prefix = /path/to/pools/$pool
  17. ; Unix user/group of processes
  18. ; Note: The user is mandatory. If the group is not set, the default user's group
  19. ; will be used.
  20. user = nginx
  21. group = nginx
  22. ; The address on which to accept FastCGI requests.
  23. ; Valid syntaxes are:
  24. ; 'ip.add.re.ss:port' - to listen on a TCP socket to a specific address on
  25. ; a specific port;
  26. ; 'port' - to listen on a TCP socket to all addresses on a
  27. ; specific port;
  28. ; '/path/to/unix/socket' - to listen on a unix socket.
  29. ; Note: This value is mandatory.
  30. listen = /var/run/php5-fpm.sock
  31. ; Set listen(2) backlog.
  32. ; Default Value: 128 (-1 on FreeBSD and OpenBSD)
  33. ;listen.backlog = 128
  34. ; Set permissions for unix socket, if one is used. In Linux, read/write
  35. ; permissions must be set in order to allow connections from a web server. Many
  36. ; BSD-derived systems allow connections regardless of permissions.
  37. ; Default Values: user and group are set as the running user
  38. ; mode is set to 0666
  39. listen.owner = nginx
  40. listen.group = nginx
  41. listen.mode = 0666
  42. ; List of ipv4 addresses of FastCGI clients which are allowed to connect.
  43. ; Equivalent to the FCGI_WEB_SERVER_ADDRS environment variable in the original
  44. ; PHP FCGI (5.2.2+). Makes sense only with a tcp listening socket. Each address
  45. ; must be separated by a comma. If this value is left blank, connections will be
  46. ; accepted from any ip address.
  47. ; Default Value: any
  48. ;listen.allowed_clients = 127.0.0.1
  49. ; Choose how the process manager will control the number of child processes.
  50. ; Possible Values:
  51. ; static - a fixed number (pm.max_children) of child processes;
  52. ; dynamic - the number of child processes are set dynamically based on the
  53. ; following directives. With this process management, there will be
  54. ; always at least 1 children.
  55. ; pm.max_children - the maximum number of children that can
  56. ; be alive at the same time.
  57. ; pm.start_servers - the number of children created on startup.
  58. ; pm.min_spare_servers - the minimum number of children in 'idle'
  59. ; state (waiting to process). If the number
  60. ; of 'idle' processes is less than this
  61. ; number then some children will be created.
  62. ; pm.max_spare_servers - the maximum number of children in 'idle'
  63. ; state (waiting to process). If the number
  64. ; of 'idle' processes is greater than this
  65. ; number then some children will be killed.
  66. ; ondemand - no children are created at startup. Children will be forked when
  67. ; new requests will connect. The following parameter are used:
  68. ; pm.max_children - the maximum number of children that
  69. ; can be alive at the same time.
  70. ; pm.process_idle_timeout - The number of seconds after which
  71. ; an idle process will be killed.
  72. ; Note: This value is mandatory.
  73. pm = dynamic
  74. ; The number of child processes to be created when pm is set to 'static' and the
  75. ; maximum number of child processes when pm is set to 'dynamic' or 'ondemand'.
  76. ; This value sets the limit on the number of simultaneous requests that will be
  77. ; served. Equivalent to the ApacheMaxClients directive with mpm_prefork.
  78. ; Equivalent to the PHP_FCGI_CHILDREN environment variable in the original PHP
  79. ; CGI. The below defaults are based on a server without much resources. Don't
  80. ; forget to tweak pm.* to fit your needs.
  81. ; Note: Used when pm is set to 'static', 'dynamic' or 'ondemand'
  82. ; Note: This value is mandatory.
  83. pm.max_children = 5
  84. ; The number of child processes created on startup.
  85. ; Note: Used only when pm is set to 'dynamic'
  86. ; Default Value: min_spare_servers + (max_spare_servers - min_spare_servers) / 2
  87. pm.start_servers = 2
  88. ; The desired minimum number of idle server processes.
  89. ; Note: Used only when pm is set to 'dynamic'
  90. ; Note: Mandatory when pm is set to 'dynamic'
  91. pm.min_spare_servers = 1
  92. ; The desired maximum number of idle server processes.
  93. ; Note: Used only when pm is set to 'dynamic'
  94. ; Note: Mandatory when pm is set to 'dynamic'
  95. pm.max_spare_servers = 3
  96. ; The number of seconds after which an idle process will be killed.
  97. ; Note: Used only when pm is set to 'ondemand'
  98. ; Default Value: 10s
  99. ;pm.process_idle_timeout = 10s;
  100. ; The number of requests each child process should execute before respawning.
  101. ; This can be useful to work around memory leaks in 3rd party libraries. For
  102. ; endless request processing specify '0'. Equivalent to PHP_FCGI_MAX_REQUESTS.
  103. ; Default Value: 0
  104. ;pm.max_requests = 500
  105. ; The URI to view the FPM status page. If this value is not set, no URI will be
  106. ; recognized as a status page. It shows the following informations:
  107. ; pool - the name of the pool;
  108. ; process manager - static, dynamic or ondemand;
  109. ; start time - the date and time FPM has started;
  110. ; start since - number of seconds since FPM has started;
  111. ; accepted conn - the number of request accepted by the pool;
  112. ; listen queue - the number of request in the queue of pending
  113. ; connections (see backlog in listen(2));
  114. ; max listen queue - the maximum number of requests in the queue
  115. ; of pending connections since FPM has started;
  116. ; listen queue len - the size of the socket queue of pending connections;
  117. ; idle processes - the number of idle processes;
  118. ; active processes - the number of active processes;
  119. ; total processes - the number of idle + active processes;
  120. ; max active processes - the maximum number of active processes since FPM
  121. ; has started;
  122. ; max children reached - number of times, the process limit has been reached,
  123. ; when pm tries to start more children (works only for
  124. ; pm 'dynamic' and 'ondemand');
  125. ; Value are updated in real time.
  126. ; Example output:
  127. ; pool: www
  128. ; process manager: static
  129. ; start time: 01/Jul/2011:17:53:49 +0200
  130. ; start since: 62636
  131. ; accepted conn: 190460
  132. ; listen queue: 0
  133. ; max listen queue: 1
  134. ; listen queue len: 42
  135. ; idle processes: 4
  136. ; active processes: 11
  137. ; total processes: 15
  138. ; max active processes: 12
  139. ; max children reached: 0
  140. ;
  141. ; By default the status page output is formatted as text/plain. Passing either
  142. ; 'html', 'xml' or 'json' in the query string will return the corresponding
  143. ; output syntax. Example:
  144. ; http://www.foo.bar/status
  145. ; http://www.foo.bar/status?json
  146. ; http://www.foo.bar/status?html
  147. ; http://www.foo.bar/status?xml
  148. ;
  149. ; By default the status page only outputs short status. Passing 'full' in the
  150. ; query string will also return status for each pool process.
  151. ; Example:
  152. ; http://www.foo.bar/status?full
  153. ; http://www.foo.bar/status?json&full
  154. ; http://www.foo.bar/status?html&full
  155. ; http://www.foo.bar/status?xml&full
  156. ; The Full status returns for each process:
  157. ; pid - the PID of the process;
  158. ; state - the state of the process (Idle, Running, ...);
  159. ; start time - the date and time the process has started;
  160. ; start since - the number of seconds since the process has started;
  161. ; requests - the number of requests the process has served;
  162. ; request duration - the duration in µs of the requests;
  163. ; request method - the request method (GET, POST, ...);
  164. ; request URI - the request URI with the query string;
  165. ; content length - the content length of the request (only with POST);
  166. ; user - the user (PHP_AUTH_USER) (or '-' if not set);
  167. ; script - the main script called (or '-' if not set);
  168. ; last request cpu - the %cpu the last request consumed
  169. ; it's always 0 if the process is not in Idle state
  170. ; because CPU calculation is done when the request
  171. ; processing has terminated;
  172. ; last request memory - the max amount of memory the last request consumed
  173. ; it's always 0 if the process is not in Idle state
  174. ; because memory calculation is done when the request
  175. ; processing has terminated;
  176. ; If the process is in Idle state, then informations are related to the
  177. ; last request the process has served. Otherwise informations are related to
  178. ; the current request being served.
  179. ; Example output:
  180. ; ************************
  181. ; pid: 31330
  182. ; state: Running
  183. ; start time: 01/Jul/2011:17:53:49 +0200
  184. ; start since: 63087
  185. ; requests: 12808
  186. ; request duration: 1250261
  187. ; request method: GET
  188. ; request URI: /test_mem.php?N=10000
  189. ; content length: 0
  190. ; user: -
  191. ; script: /home/fat/web/docs/php/test_mem.php
  192. ; last request cpu: 0.00
  193. ; last request memory: 0
  194. ;
  195. ; Note: There is a real-time FPM status monitoring sample web page available
  196. ; It's available in: ${prefix}/share/fpm/status.html
  197. ;
  198. ; Note: The value must start with a leading slash (/). The value can be
  199. ; anything, but it may not be a good idea to use the .php extension or it
  200. ; may conflict with a real PHP file.
  201. ; Default Value: not set
  202. ;pm.status_path = /status
  203. ; The ping URI to call the monitoring page of FPM. If this value is not set, no
  204. ; URI will be recognized as a ping page. This could be used to test from outside
  205. ; that FPM is alive and responding, or to
  206. ; - create a graph of FPM availability (rrd or such);
  207. ; - remove a server from a group if it is not responding (load balancing);
  208. ; - trigger alerts for the operating team (24/7).
  209. ; Note: The value must start with a leading slash (/). The value can be
  210. ; anything, but it may not be a good idea to use the .php extension or it
  211. ; may conflict with a real PHP file.
  212. ; Default Value: not set
  213. ;ping.path = /ping
  214. ; This directive may be used to customize the response of a ping request. The
  215. ; response is formatted as text/plain with a 200 response code.
  216. ; Default Value: pong
  217. ;ping.response = pong
  218. ; The access log file
  219. ; Default: not set
  220. ;access.log = log/$pool.access.log
  221. ; The access log format.
  222. ; The following syntax is allowed
  223. ; %%: the '%' character
  224. ; %C: %CPU used by the request
  225. ; it can accept the following format:
  226. ; - %{user}C for user CPU only
  227. ; - %{system}C for system CPU only
  228. ; - %{total}C for user + system CPU (default)
  229. ; %d: time taken to serve the request
  230. ; it can accept the following format:
  231. ; - %{seconds}d (default)
  232. ; - %{miliseconds}d
  233. ; - %{mili}d
  234. ; - %{microseconds}d
  235. ; - %{micro}d
  236. ; %e: an environment variable (same as $_ENV or $_SERVER)
  237. ; it must be associated with embraces to specify the name of the env
  238. ; variable. Some exemples:
  239. ; - server specifics like: %{REQUEST_METHOD}e or %{SERVER_PROTOCOL}e
  240. ; - HTTP headers like: %{HTTP_HOST}e or %{HTTP_USER_AGENT}e
  241. ; %f: script filename
  242. ; %l: content-length of the request (for POST request only)
  243. ; %m: request method
  244. ; %M: peak of memory allocated by PHP
  245. ; it can accept the following format:
  246. ; - %{bytes}M (default)
  247. ; - %{kilobytes}M
  248. ; - %{kilo}M
  249. ; - %{megabytes}M
  250. ; - %{mega}M
  251. ; %n: pool name
  252. ; %o: ouput header
  253. ; it must be associated with embraces to specify the name of the header:
  254. ; - %{Content-Type}o
  255. ; - %{X-Powered-By}o
  256. ; - %{Transfert-Encoding}o
  257. ; - ....
  258. ; %p: PID of the child that serviced the request
  259. ; %P: PID of the parent of the child that serviced the request
  260. ; %q: the query string
  261. ; %Q: the '?' character if query string exists
  262. ; %r: the request URI (without the query string, see %q and %Q)
  263. ; %R: remote IP address
  264. ; %s: status (response code)
  265. ; %t: server time the request was received
  266. ; it can accept a strftime(3) format:
  267. ; %d/%b/%Y:%H:%M:%S %z (default)
  268. ; %T: time the log has been written (the request has finished)
  269. ; it can accept a strftime(3) format:
  270. ; %d/%b/%Y:%H:%M:%S %z (default)
  271. ; %u: remote user
  272. ;
  273. ; Default: "%R - %u %t \"%m %r\" %s"
  274. ;access.format = "%R - %u %t \"%m %r%Q%q\" %s %f %{mili}d %{kilo}M %C%%"
  275. ; The log file for slow requests
  276. ; Default Value: not set
  277. ; Note: slowlog is mandatory if request_slowlog_timeout is set
  278. ;slowlog = log/$pool.log.slow
  279. ; The timeout for serving a single request after which a PHP backtrace will be
  280. ; dumped to the 'slowlog' file. A value of '0s' means 'off'.
  281. ; Available units: s(econds)(default), m(inutes), h(ours), or d(ays)
  282. ; Default Value: 0
  283. ;request_slowlog_timeout = 0
  284. ; The timeout for serving a single request after which the worker process will
  285. ; be killed. This option should be used when the 'max_execution_time' ini option
  286. ; does not stop script execution for some reason. A value of '0' means 'off'.
  287. ; Available units: s(econds)(default), m(inutes), h(ours), or d(ays)
  288. ; Default Value: 0
  289. ;request_terminate_timeout = 0
  290. ; Set open file descriptor rlimit.
  291. ; Default Value: system defined value
  292. ;rlimit_files = 1024
  293. ; Set max core size rlimit.
  294. ; Possible Values: 'unlimited' or an integer greater or equal to 0
  295. ; Default Value: system defined value
  296. ;rlimit_core = 0
  297. ; Chroot to this directory at the start. This value must be defined as an
  298. ; absolute path. When this value is not set, chroot is not used.
  299. ; Note: you can prefix with '$prefix' to chroot to the pool prefix or one
  300. ; of its subdirectories. If the pool prefix is not set, the global prefix
  301. ; will be used instead.
  302. ; Note: chrooting is a great security feature and should be used whenever
  303. ; possible. However, all PHP paths will be relative to the chroot
  304. ; (error_log, sessions.save_path, ...).
  305. ; Default Value: not set
  306. ;chroot =
  307. ; Chdir to this directory at the start.
  308. ; Note: relative path can be used.
  309. ; Default Value: current directory or / when chroot
  310. chdir = /
  311. ; Redirect worker stdout and stderr into main error log. If not set, stdout and
  312. ; stderr will be redirected to /dev/null according to FastCGI specs.
  313. ; Note: on highloaded environement, this can cause some delay in the page
  314. ; process time (several ms).
  315. ; Default Value: no
  316. ;catch_workers_output = yes
  317. ; Limits the extensions of the main script FPM will allow to parse. This can
  318. ; prevent configuration mistakes on the web server side. You should only limit
  319. ; FPM to .php extensions to prevent malicious users to use other extensions to
  320. ; exectute php code.
  321. ; Note: set an empty value to allow all extensions.
  322. ; Default Value: .php
  323. ;security.limit_extensions = .php .php3 .php4 .php5
  324. ; Pass environment variables like LD_LIBRARY_PATH. All $VARIABLEs are taken from
  325. ; the current environment.
  326. ; Default Value: clean env
  327. ;env[HOSTNAME] = $HOSTNAME
  328. ;env[PATH] = /usr/local/bin:/usr/bin:/bin
  329. ;env[TMP] = /tmp
  330. ;env[TMPDIR] = /tmp
  331. ;env[TEMP] = /tmp
  332. ; Additional php.ini defines, specific to this pool of workers. These settings
  333. ; overwrite the values previously defined in the php.ini. The directives are the
  334. ; same as the PHP SAPI:
  335. ; php_value/php_flag - you can set classic ini defines which can
  336. ; be overwritten from PHP call 'ini_set'.
  337. ; php_admin_value/php_admin_flag - these directives won't be overwritten by
  338. ; PHP call 'ini_set'
  339. ; For php_*flag, valid values are on, off, 1, 0, true, false, yes or no.
  340. ; Defining 'extension' will load the corresponding shared extension from
  341. ; extension_dir. Defining 'disable_functions' or 'disable_classes' will not
  342. ; overwrite previously defined php.ini values, but will append the new value
  343. ; instead.
  344. ; Note: path INI options can be relative and will be expanded with the prefix
  345. ; (pool, global or /usr)
  346. ; Default Value: nothing is defined by default except the values in php.ini and
  347. ; specified at startup with the -d argument
  348. ;php_admin_value[sendmail_path] = /usr/sbin/sendmail -t -i -f www@my.domain.com
  349. ;php_flag[display_errors] = off
  350. ;php_admin_value[error_log] = /var/log/fpm-php.www.log
  351. ;php_admin_flag[log_errors] = on
  352. ;php_admin_value[memory_limit] = 32M