xref: /PHP-8.2/sapi/fpm/php-fpm.conf.in (revision 462da6e0)
1;;;;;;;;;;;;;;;;;;;;;
2; FPM Configuration ;
3;;;;;;;;;;;;;;;;;;;;;
4
5; All relative paths in this configuration file are relative to PHP's install
6; prefix (@prefix@). This prefix can be dynamically changed by using the
7; '-p' argument from the command line.
8
9;;;;;;;;;;;;;;;;;;
10; Global Options ;
11;;;;;;;;;;;;;;;;;;
12
13[global]
14; Pid file
15; Note: the default prefix is @EXPANDED_LOCALSTATEDIR@
16; Default Value: none
17;pid = run/php-fpm.pid
18
19; Error log file
20; If it's set to "syslog", log is sent to syslogd instead of being written
21; into a local file.
22; Note: the default prefix is @EXPANDED_LOCALSTATEDIR@
23; Default Value: log/php-fpm.log
24;error_log = log/php-fpm.log
25
26; syslog_facility is used to specify what type of program is logging the
27; message. This lets syslogd specify that messages from different facilities
28; will be handled differently.
29; See syslog(3) for possible values (ex daemon equiv LOG_DAEMON)
30; Default Value: daemon
31;syslog.facility = daemon
32
33; syslog_ident is prepended to every message. If you have multiple FPM
34; instances running on the same server, you can change the default value
35; which must suit common needs.
36; Default Value: php-fpm
37;syslog.ident = php-fpm
38
39; Log level
40; Possible Values: alert, error, warning, notice, debug
41; Default Value: notice
42;log_level = notice
43
44; Log limit on number of characters in the single line (log entry). If the
45; line is over the limit, it is wrapped on multiple lines. The limit is for
46; all logged characters including message prefix and suffix if present. However
47; the new line character does not count into it as it is present only when
48; logging to a file descriptor. It means the new line character is not present
49; when logging to syslog.
50; Default Value: 1024
51;log_limit = 4096
52
53; Log buffering specifies if the log line is buffered which means that the
54; line is written in a single write operation. If the value is false, then the
55; data is written directly into the file descriptor. It is an experimental
56; option that can potentially improve logging performance and memory usage
57; for some heavy logging scenarios. This option is ignored if logging to syslog
58; as it has to be always buffered.
59; Default value: yes
60;log_buffering = no
61
62; If this number of child processes exit with SIGSEGV or SIGBUS within the time
63; interval set by emergency_restart_interval then FPM will restart. A value
64; of '0' means 'Off'.
65; Default Value: 0
66;emergency_restart_threshold = 0
67
68; Interval of time used by emergency_restart_interval to determine when
69; a graceful restart will be initiated.  This can be useful to work around
70; accidental corruptions in an accelerator's shared memory.
71; Available Units: s(econds), m(inutes), h(ours), or d(ays)
72; Default Unit: seconds
73; Default Value: 0
74;emergency_restart_interval = 0
75
76; Time limit for child processes to wait for a reaction on signals from master.
77; Available units: s(econds), m(inutes), h(ours), or d(ays)
78; Default Unit: seconds
79; Default Value: 0
80;process_control_timeout = 0
81
82; The maximum number of processes FPM will fork. This has been designed to control
83; the global number of processes when using dynamic PM within a lot of pools.
84; Use it with caution.
85; Note: A value of 0 indicates no limit
86; Default Value: 0
87; process.max = 128
88
89; Specify the nice(2) priority to apply to the master process (only if set)
90; The value can vary from -19 (highest priority) to 20 (lowest priority)
91; Note: - It will only work if the FPM master process is launched as root
92;       - The pool process will inherit the master process priority
93;         unless specified otherwise
94; Default Value: no set
95; process.priority = -19
96
97; Send FPM to background. Set to 'no' to keep FPM in foreground for debugging.
98; Default Value: yes
99;daemonize = yes
100
101; Set open file descriptor rlimit for the master process.
102; Default Value: system defined value
103;rlimit_files = 1024
104
105; Set max core size rlimit for the master process.
106; Possible Values: 'unlimited' or an integer greater or equal to 0
107; Default Value: system defined value
108;rlimit_core = 0
109
110; Specify the event mechanism FPM will use. The following is available:
111; - select     (any POSIX os)
112; - poll       (any POSIX os)
113; - epoll      (linux >= 2.5.44)
114; - kqueue     (FreeBSD >= 4.1, OpenBSD >= 2.9, NetBSD >= 2.0)
115; - /dev/poll  (Solaris >= 7)
116; - port       (Solaris >= 10)
117; Default Value: not set (auto detection)
118;events.mechanism = epoll
119
120; When FPM is built with systemd integration, specify the interval,
121; in seconds, between health report notification to systemd.
122; Set to 0 to disable.
123; Available Units: s(econds), m(inutes), h(ours)
124; Default Unit: seconds
125; Default value: 10
126;systemd_interval = 10
127
128;;;;;;;;;;;;;;;;;;;;
129; Pool Definitions ;
130;;;;;;;;;;;;;;;;;;;;
131
132; Multiple pools of child processes may be started with different listening
133; ports and different management options.  The name of the pool will be
134; used in logs and stats. There is no limitation on the number of pools which
135; FPM can handle. Your system will tell you anyway :)
136
137; Include one or more files. If glob(3) exists, it is used to include a bunch of
138; files from a glob(3) pattern. This directive can be used everywhere in the
139; file.
140; Relative path can also be used. They will be prefixed by:
141;  - the global prefix if it's been set (-p argument)
142;  - @prefix@ otherwise
143include=@php_fpm_sysconfdir@/php-fpm.d/*.conf
144