php-fpm.conf 19 KB

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