install/fpm/configuration.xml
b01a6761f8e5a1dc58ec92b4bba9b7b5878047fe
b01a6761f8e5a1dc58ec92b4bba9b7b5878047fe
...
...
@@ -5,6 +5,7 @@
5
5
<para>
6
6
FPM uses &php.ini; syntax for its configuration file - <filename>php-fpm.conf</filename>, and pool configuration files.
7
7
</para>
8
+
8
9
<sect2>
9
10
<title>List of global <filename>php-fpm.conf</filename> directives</title>
10
11
<variablelist>
...
...
@@ -28,6 +29,7 @@
28
29
<para>
29
30
Path to error log file. Default value:
30
31
<literal>#INSTALL_PREFIX#/log/php-fpm.log</literal>.
32
+
If it's set to "syslog", log is sent to syslogd instead of being written in a local file.
31
33
</para>
32
34
</listitem>
33
35
</varlistentry>
...
...
@@ -43,6 +45,59 @@
43
45
</para>
44
46
</listitem>
45
47
</varlistentry>
48
+
<varlistentry xml:id="log-limit">
49
+
<term>
50
+
<parameter>log_limit</parameter>
51
+
<type>int</type>
52
+
</term>
53
+
<listitem>
54
+
<para>
55
+
Log limit for the logged lines which allows to log messages longer than
56
+
1024 characters without wrapping.
57
+
Default value: 1024.
58
+
Available as of PHP 7.3.0.
59
+
</para>
60
+
</listitem>
61
+
</varlistentry>
62
+
<varlistentry xml:id="log-buffering">
63
+
<term>
64
+
<parameter>log_buffering</parameter>
65
+
<type>bool</type>
66
+
</term>
67
+
<listitem>
68
+
<para>
69
+
Experimental logging without extra buffering.
70
+
Default value: yes.
71
+
Available as of PHP 7.3.0.
72
+
</para>
73
+
</listitem>
74
+
</varlistentry>
75
+
<varlistentry xml:id="syslog-facility">
76
+
<term>
77
+
<parameter>syslog.facility</parameter>
78
+
<type>string</type>
79
+
</term>
80
+
<listitem>
81
+
<para>
82
+
used to specify what type of program is logging the message.
83
+
Default value: daemon.
84
+
</para>
85
+
</listitem>
86
+
</varlistentry>
87
+
<varlistentry xml:id="syslog-ident">
88
+
<term>
89
+
<parameter>syslog.ident</parameter>
90
+
<type>string</type>
91
+
</term>
92
+
<listitem>
93
+
<para>
94
+
Prepended to every message.
95
+
If you have multiple FPM instances running on the same server,
96
+
you can change the default value which must suit common needs.
97
+
Default value: php-fpm.
98
+
</para>
99
+
</listitem>
100
+
</varlistentry>
46
101
<varlistentry xml:id="emergency-restart-threshold">
47
102
<term>
48
103
<parameter>emergency_restart_threshold</parameter>
...
...
@@ -51,7 +106,7 @@
51
106
<listitem>
52
107
<para>
53
108
If this number of child processes exit with SIGSEGV or SIGBUS within
54
-
the time interval set by <literal>emergency_restart_interval</literal>
109
+
the time interval set by <literal>emergency_restart_interval</literal>,
55
110
then FPM will restart. A value of 0 means 'Off'. Default value: 0 (Off).
56
111
</para>
57
112
</listitem>
...
...
@@ -63,7 +118,7 @@
63
118
</term>
64
119
<listitem>
65
120
<para>
66
-
Interval of time used by emergency_restart_interval to determine when
121
+
Interval of time used by <literal>emergency_restart_interval</literal> to determine when
67
122
a graceful restart will be initiated. This can be useful to work around
68
123
accidental corruptions in an accelerator's shared memory.
69
124
Available Units: s(econds), m(inutes), h(ours), or d(ays).
...
...
@@ -84,10 +139,37 @@
84
139
</para>
85
140
</listitem>
86
141
</varlistentry>
142
+
<varlistentry xml:id="process-max">
143
+
<term>
144
+
<parameter>process.max</parameter>
145
+
<type>int</type>
146
+
</term>
147
+
<listitem>
148
+
<para>
149
+
The maximum number of processes FPM will fork. This has been design
150
+
to control the global number of processes when using dynamic PM
151
+
within a lot of pools. Use it with caution.
152
+
Default value: 0.
153
+
</para>
154
+
</listitem>
155
+
</varlistentry>
156
+
<varlistentry xml:id="process-priority">
157
+
<term>
158
+
<parameter>process.priority</parameter>
159
+
<type>int</type>
160
+
</term>
161
+
<listitem>
162
+
<para>
163
+
Specify the nice(2) priority to apply to the master process (only if set).
164
+
The value can vary from -19 (highest priority) to 20 (lower priority).
165
+
Default value: not set.
166
+
</para>
167
+
</listitem>
168
+
</varlistentry>
87
169
<varlistentry xml:id="daemonize">
88
170
<term>
89
171
<parameter>daemonize</parameter>
90
-
<type>boolean</type>
172
+
<type>bool</type>
91
173
</term>
92
174
<listitem>
93
175
<para>
...
...
@@ -96,7 +178,59 @@
96
178
</para>
97
179
</listitem>
98
180
</varlistentry>
181
+
<varlistentry xml:id="rlimit-files-master">
182
+
<term>
183
+
<parameter>rlimit_files</parameter>
184
+
<type>int</type>
185
+
</term>
186
+
<listitem>
187
+
<para>
188
+
Set open file descriptor rlimit for the master process.
189
+
Default value: system defined value.
190
+
</para>
191
+
</listitem>
192
+
</varlistentry>
193
+
<varlistentry xml:id="rlimit-core-master">
194
+
<term>
195
+
<parameter>rlimit_core</parameter>
196
+
<type>int</type>
197
+
</term>
198
+
<listitem>
199
+
<para>
200
+
Set max core size rlimit for the master process.
201
+
Default value: 0.
202
+
</para>
203
+
</listitem>
204
+
</varlistentry>
205
+
<varlistentry xml:id="events-mechanism">
206
+
<term>
207
+
<parameter>events.mechanism</parameter>
208
+
<type>string</type>
209
+
</term>
210
+
<listitem>
211
+
<para>
212
+
Specify the event mechanism FPM will use.
213
+
The following is available: epoll, kqueue (*BSD), port (Solaris), poll, select.
214
+
Default value: not set (auto detection preferring epoll and kqueue).
215
+
</para>
216
+
</listitem>
217
+
</varlistentry>
218
+
<varlistentry xml:id="systemd-interval">
219
+
<term>
220
+
<parameter>systemd_interval</parameter>
221
+
<type>int</type>
222
+
</term>
223
+
<listitem>
224
+
<para>
225
+
When FPM is build with systemd integration, specify the interval,
226
+
in second, between health report notification to systemd.
227
+
Set to 0 to disable.
228
+
Default value: 10.
229
+
</para>
230
+
</listitem>
231
+
</varlistentry>
99
232
</variablelist>
233
+
100
234
</sect2>
101
235
102
236
<sect2>
...
...
@@ -126,8 +260,9 @@
126
260
</term>
127
261
<listitem>
128
262
<para>
129
-
Set listen(2) backlog. A value of '-1' means unlimited. Default value:
130
-
-1.
263
+
Set listen(2) backlog. A value of <literal>-1</literal> means maximum on BSD systems.
264
+
Default value: <literal>-1</literal> (FreeBSD or OpenBSD) or <literal>511</literal>
265
+
(Linux and other platforms).
131
266
</para>
132
267
</listitem>
133
268
</varlistentry>
...
...
@@ -138,11 +273,11 @@
138
273
</term>
139
274
<listitem>
140
275
<para>
141
-
List of ipv4 addresses of FastCGI clients which are allowed to
142
-
connect. Equivalent to the FCGI_WEB_SERVER_ADDRS environment variable in the
143
-
original PHP FastCGI (5.2.2+). Makes sense only with a tcp listening socket.
144
-
Each address must be separated by a comma. If this value is left blank,
145
-
connections will be accepted from any ip address. Default value: any.
276
+
List of IPv4 or IPv6 addresses of FastCGI clients which are allowed to connect. Equivalent
277
+
to the FCGI_WEB_SERVER_ADDRS environment variable in the original PHP FastCGI (5.2.2+).
278
+
Makes sense only with a tcp listening socket. Each address must be separated by a comma.
279
+
If this value is left blank, connections will be accepted from any ip address.
280
+
Default value: not set (any ip address accepted).
146
281
</para>
147
282
</listitem>
148
283
</varlistentry>
...
...
@@ -182,6 +317,31 @@
182
317
</para>
183
318
</listitem>
184
319
</varlistentry>
320
+
<varlistentry xml:id="listen-acl-users">
321
+
<term>
322
+
<parameter>listen.acl_users</parameter>
323
+
<type>string</type>
324
+
</term>
325
+
<listitem>
326
+
<para>
327
+
When POSIX Access Control Lists are supported you can set them using this option.
328
+
When set, <literal>listen.owner</literal> and <literal>listen.group</literal>
329
+
are ignored. Value is a comma separated list of user names.
330
+
</para>
331
+
</listitem>
332
+
</varlistentry>
333
+
<varlistentry xml:id="listen-acl-groups">
334
+
<term>
335
+
<parameter>listen.acl_groups</parameter>
336
+
<type>string</type>
337
+
</term>
338
+
<listitem>
339
+
<para>
340
+
See <literal>listen.acl_users</literal>.
341
+
Value is a comma separated list of group names.
342
+
</para>
343
+
</listitem>
344
+
</varlistentry>
185
345
<varlistentry xml:id="user">
186
346
<term>
187
347
<parameter>user</parameter>
...
...
@@ -232,7 +392,7 @@
232
392
</para>
233
393
</listitem>
234
394
</varlistentry>
235
-
<varlistentry xml:id="pm.max-chidlren">
395
+
<varlistentry xml:id="pm.max-children">
236
396
<term>
237
397
<parameter>pm.max_children</parameter>
238
398
<type>int</type>
...
...
@@ -261,8 +421,7 @@
261
421
<para>
262
422
The number of child processes created on startup.
263
423
Used only when <literal>pm</literal> is set to <literal>dynamic</literal>.
264
-
Default Value: min_spare_servers + (max_spare_servers -
265
-
min_spare_servers) / 2.
424
+
Default Value: (min_spare_servers + max_spare_servers) / 2.
266
425
</para>
267
426
</listitem>
268
427
</varlistentry>
...
...
@@ -292,6 +451,33 @@
292
451
</para>
293
452
</listitem>
294
453
</varlistentry>
454
+
<varlistentry xml:id="pm.max-spawn-rate">
455
+
<term>
456
+
<parameter>pm.max_spawn_rate</parameter>
457
+
<type>int</type>
458
+
</term>
459
+
<listitem>
460
+
<para>
461
+
The number of rate to spawn child processes at once. Used only when
462
+
<literal>pm</literal> is set to <literal>dynamic</literal>.
463
+
Default value: 32
464
+
</para>
465
+
</listitem>
466
+
</varlistentry>
467
+
<varlistentry xml:id="pm.process-idle-timeout">
468
+
<term>
469
+
<parameter>pm.process_idle_timeout</parameter>
470
+
<type>mixed</type>
471
+
</term>
472
+
<listitem>
473
+
<para>
474
+
The number of seconds after which an idle process will be killed.
475
+
Used only when <literal>pm</literal> is set to <literal>ondemand</literal>.
476
+
Available units: s(econds)(default), m(inutes), h(ours), or d(ays).
477
+
Default value: 10s.
478
+
</para>
479
+
</listitem>
480
+
</varlistentry>
295
481
<varlistentry xml:id="pm.max-requests">
296
482
<term>
297
483
<parameter>pm.max_requests</parameter>
...
...
@@ -306,6 +492,22 @@
306
492
</para>
307
493
</listitem>
308
494
</varlistentry>
495
+
<varlistentry xml:id="pm.status-listen">
496
+
<term>
497
+
<parameter>pm.status_listen</parameter>
498
+
<type>string</type>
499
+
</term>
500
+
<listitem>
501
+
<para>
502
+
The address on which to accept FastCGI status request. This creates a new invisible pool
503
+
that can handle requests independently. This is useful if the main pool is busy with long
504
+
running requests because it is still possible to get the
505
+
<link linkend="fpm.status">FPM status page</link> before finishing the long running
506
+
requests. The syntax is the same as for <link linkend="listen">listen</link> directive.
507
+
Default value: none.
508
+
</para>
509
+
</listitem>
510
+
</varlistentry>
309
511
<varlistentry xml:id="pm.status-path">
310
512
<term>
311
513
<parameter>pm.status_path</parameter>
...
...
@@ -313,8 +515,9 @@
313
515
</term>
314
516
<listitem>
315
517
<para>
316
-
The URI to view the FPM status page. If this value is not set, no URI
317
-
will be recognized as a status page. Default value: none.
518
+
The URI to view the <link linkend="fpm.status">FPM status page</link>. This value must
519
+
start with a leading slash (/). If this value is not set, no URI will be recognized as
520
+
a status page. Default value: none.
318
521
</para>
319
522
</listitem>
320
523
</varlistentry>
...
...
@@ -345,6 +548,44 @@
345
548
</para>
346
549
</listitem>
347
550
</varlistentry>
551
+
<varlistentry xml:id="worker-process-priority">
552
+
<term>
553
+
<parameter>process.priority</parameter>
554
+
<type>int</type>
555
+
</term>
556
+
<listitem>
557
+
<para>
558
+
Specify the nice(2) priority to apply to the worker process (only if set).
559
+
The value can vary from -19 (highest priority) to 20 (lower priority).
560
+
Default value: not set.
561
+
</para>
562
+
</listitem>
563
+
</varlistentry>
564
+
<varlistentry xml:id="process-dumpable">
565
+
<term>
566
+
<parameter>process.dumpable</parameter>
567
+
<type>bool</type>
568
+
</term>
569
+
<listitem>
570
+
<para>
571
+
Set the process dumpable flag (PR_SET_DUMPABLE prctl) even if the process user
572
+
or group is different than the master process user. It allows to create process
573
+
core dump and ptrace the process for the pool user.
574
+
Default Value: no. Since PHP 7.0.29, 7.1.17 and 7.2.5.
575
+
</para>
576
+
</listitem>
577
+
</varlistentry>
578
+
<varlistentry xml:id="prefix">
579
+
<term>
580
+
<parameter>prefix</parameter>
581
+
<type>string</type>
582
+
</term>
583
+
<listitem>
584
+
<para>
585
+
Specify prefix for path evaluation
586
+
</para>
587
+
</listitem>
588
+
</varlistentry>
348
589
<varlistentry xml:id="request-terminate-timeout">
349
590
<term>
350
591
<parameter>request_terminate_timeout</parameter>
...
...
@@ -360,6 +601,22 @@
360
601
</para>
361
602
</listitem>
362
603
</varlistentry>
604
+
<varlistentry xml:id="request-terminate-timeout-track-finished">
605
+
<term>
606
+
<parameter>request_terminate_timeout_track_finished</parameter>
607
+
<type>bool</type>
608
+
</term>
609
+
<listitem>
610
+
<para>
611
+
The timeout set by
612
+
<link linkend="request-terminate-timeout">request_terminate_timeout</link> is not engaged
613
+
after a <link linkend="function.fastcgi-finish-request">fastcgi_finish_request</link> or
614
+
when application has finished and internal shutdown functions are being called. This
615
+
directive will enable timeout limit to be applied unconditionally even in such cases.
616
+
Default value: no. Since PHP 7.3.0.
617
+
</para>
618
+
</listitem>
619
+
</varlistentry>
363
620
<varlistentry xml:id="request-slowlog-timeout">
364
621
<term>
365
622
<parameter>request_slowlog_timeout</parameter>
...
...
@@ -374,6 +631,18 @@
374
631
</para>
375
632
</listitem>
376
633
</varlistentry>
634
+
<varlistentry xml:id="request-slowlog-trace-depth">
635
+
<term>
636
+
<parameter>request_slowlog_trace_depth</parameter>
637
+
<type>int</type>
638
+
</term>
639
+
<listitem>
640
+
<para>
641
+
The depth of slowlog log stack trace.
642
+
Default value: 20. Since PHP 7.2.0.
643
+
</para>
644
+
</listitem>
645
+
</varlistentry>
377
646
<varlistentry xml:id="slowlog">
378
647
<term>
379
648
<parameter>slowlog</parameter>
...
...
@@ -393,7 +662,7 @@
393
662
</term>
394
663
<listitem>
395
664
<para>
396
-
Set open file descriptor rlimit. Default value: system defined value.
665
+
Set open file descriptor rlimit for child processes in this pool. Default value: system defined value.
397
666
</para>
398
667
</listitem>
399
668
</varlistentry>
...
...
@@ -404,7 +673,7 @@
404
673
</term>
405
674
<listitem>
406
675
<para>
407
-
Set max core size rlimit. Possible Values: 'unlimited' or an integer greater or equal to 0.
676
+
Set max core size rlimit for child processes in this pool. Possible Values: 'unlimited' or an integer greater or equal to 0.
408
677
Default value: system defined value.
409
678
</para>
410
679
</listitem>
...
...
@@ -436,7 +705,7 @@
436
705
<varlistentry xml:id="catch-workers-output">
437
706
<term>
438
707
<parameter>catch_workers_output</parameter>
439
-
<type>boolean</type>
708
+
<type>bool</type>
440
709
</term>
441
710
<listitem>
442
711
<para>
...
...
@@ -446,6 +715,269 @@
446
715
</para>
447
716
</listitem>
448
717
</varlistentry>
718
+
<varlistentry xml:id="decorate-workers-output">
719
+
<term>
720
+
<parameter>decorate_workers_output</parameter>
721
+
<type>bool</type>
722
+
</term>
723
+
<listitem>
724
+
<para>
725
+
Enable the output decoration for workers output when <link
726
+
linkend="catch-workers-output">catch_workers_output</link> is enabled.
727
+
Default value: yes.
728
+
Available as of PHP 7.3.0.
729
+
</para>
730
+
</listitem>
731
+
</varlistentry>
732
+
<varlistentry xml:id="clear-env">
733
+
<term>
734
+
<parameter>clear_env</parameter>
735
+
<type>bool</type>
736
+
</term>
737
+
<listitem>
738
+
<para>
739
+
Clear environment in FPM workers.
740
+
Prevents arbitrary environment variables from reaching FPM worker processes
741
+
by clearing the environment in workers before env vars specified in this
742
+
pool configuration are added.
743
+
Default value: Yes.
744
+
</para>
745
+
</listitem>
746
+
</varlistentry>
747
+
<varlistentry xml:id="security-limit-extensions">
748
+
<term>
749
+
<parameter>security.limit_extensions</parameter>
750
+
<type>string</type>
751
+
</term>
752
+
<listitem>
753
+
<para>
754
+
Limits the extensions of the main script FPM will allow to parse.
755
+
This can prevent configuration mistakes on the web server side.
756
+
You should only limit FPM to .php extensions to prevent malicious
757
+
users to use other extensions to execute php code.
758
+
Default value: .php .phar
759
+
</para>
760
+
</listitem>
761
+
</varlistentry>
762
+
<varlistentry xml:id="apparmor-hat">
763
+
<term>
764
+
<parameter>apparmor_hat</parameter>
765
+
<type>string</type>
766
+
</term>
767
+
<listitem>
768
+
<para>
769
+
If AppArmor is enabled, it allows to change a hat.
770
+
Default value: not set
771
+
</para>
772
+
</listitem>
773
+
</varlistentry>
774
+
<varlistentry xml:id="access-log">
775
+
<term>
776
+
<parameter>access.log</parameter>
777
+
<type>string</type>
778
+
</term>
779
+
<listitem>
780
+
<para>
781
+
The access log file.
782
+
Default value: not set
783
+
</para>
784
+
</listitem>
785
+
</varlistentry>
786
+
<varlistentry xml:id="access-format">
787
+
<term>
788
+
<parameter>access.format</parameter>
789
+
<type>string</type>
790
+
</term>
791
+
<listitem>
792
+
<para>
793
+
The access log format.
794
+
Default value: <literal>"%R - %u %t \"%m %r\" %s"</literal>:
795
+
<table xml:id="fpm.configuration.access.format">
796
+
<title>Valid options</title>
797
+
<tgroup cols="2">
798
+
<thead>
799
+
<row>
800
+
<entry>Placeholder</entry>
801
+
<entry>Description</entry>
802
+
</row>
803
+
</thead>
804
+
<tbody>
805
+
<row>
806
+
<entry>
807
+
<literal>%%</literal>
808
+
</entry>
809
+
<entry>The <literal>%</literal> character</entry>
810
+
</row>
811
+
<row>
812
+
<entry>
813
+
<literal>%C</literal>
814
+
</entry>
815
+
<entry>
816
+
%CPU used by the request. It can accept the following format:
817
+
<literal>%{user}C</literal> for user CPU only,
818
+
<literal>%{system}C</literal> for system CPU only,
819
+
<literal>%{total}C</literal> for user + system CPU (default)
820
+
</entry>
821
+
</row>
822
+
<row>
823
+
<entry>
824
+
<literal>%d</literal>
825
+
</entry>
826
+
<entry>
827
+
Time taken to serve the request.
828
+
It can accept the following formats for precision:
829
+
<literal>%{seconds}d</literal> (default), <literal>%{milliseconds}d</literal>,
830
+
<literal>%{microseconds}d</literal>
831
+
</entry>
832
+
</row>
833
+
<row>
834
+
<entry>
835
+
<literal>%{<replaceable>name</replaceable>}e</literal>
836
+
</entry>
837
+
<entry>
838
+
An environment variable (same as <varname>$_ENV</varname> or <varname>$_SERVER</varname>).
839
+
A variable name must be specified within curly brackets to specify the name of the env variable.
840
+
For example, server specifics like <literal>%{REQUEST_METHOD}e</literal> or
841
+
<literal>%{SERVER_PROTOCOL}e</literal>, HTTP headers like
842
+
<literal>%{HTTP_HOST}e</literal> or <literal>%{HTTP_USER_AGENT}e</literal>
843
+
</entry>
844
+
</row>
845
+
<row>
846
+
<entry>
847
+
<literal>%f</literal>
848
+
</entry>
849
+
<entry>Script filename</entry>
850
+
</row>
851
+
<row>
852
+
<entry>
853
+
<literal>%l</literal>
854
+
</entry>
855
+
<entry>
856
+
<literal>Content-Length</literal> of the request (for HTTP POST request only)
857
+
</entry>
858
+
</row>
859
+
<row>
860
+
<entry>
861
+
<literal>%m</literal>
862
+
</entry>
863
+
<entry>Request HTTP method</entry>
864
+
</row>
865
+
<row>
866
+
<entry>
867
+
<literal>%M</literal>
868
+
</entry>
869
+
<entry>
870
+
Peak of memory allocated by PHP.
871
+
It can accept the following format:
872
+
<literal>%{bytes}M</literal> (default), <literal>%{kilobytes}M</literal>
873
+
<literal>%{kilo}M</literal>, <literal>%{megabytes}M</literal>,
874
+
<literal>%{mega}M</literal>
875
+
</entry>
876
+
</row>
877
+
<row>
878
+
<entry>
879
+
<literal>%n</literal>
880
+
</entry>
881
+
<entry>Pool name</entry>
882
+
</row>
883
+
<row>
884
+
<entry>
885
+
<literal>%{<replaceable>name</replaceable>}o</literal>
886
+
</entry>
887
+
<entry>
888
+
Output header. The header name must be specified within curly brackets.
889
+
For example: <literal>%{Content-Type}o</literal>,
890
+
<literal>%{X-Powered-By}o</literal>, <literal>%{Transfer-Encoding}o</literal>
891
+
</entry>
892
+
</row>
893
+
<row>
894
+
<entry>
895
+
<literal>%p</literal>
896
+
</entry>
897
+
<entry>PID of the child that serviced the request</entry>
898
+
</row>
899
+
<row>
900
+
<entry>
901
+
<literal>%P</literal>
902
+
</entry>
903
+
<entry>PID of the parent of the child that serviced the request</entry>
904
+
</row>
905
+
<row>
906
+
<entry>
907
+
<literal>%q</literal>
908
+
</entry>
909
+
<entry>Query string</entry>
910
+
</row>
911
+
<row>
912
+
<entry>
913
+
<literal>%Q</literal>
914
+
</entry>
915
+
<entry>
916
+
The <literal>'?'</literal> character, or glue between <literal>%q</literal> and <literal>%r</literal>,
917
+
if query string exists
918
+
</entry>
919
+
</row>
920
+
<row>
921
+
<entry>
922
+
<literal>%r</literal>
923
+
</entry>
924
+
<entry>
925
+
Request URI without the query string,
926
+
see <literal>%q</literal> and <literal>%Q</literal>
927
+
</entry>
928
+
</row>
929
+
<row>
930
+
<entry>
931
+
<literal>%R</literal>
932
+
</entry>
933
+
<entry>Remote IP address</entry>
934
+
</row>
935
+
<row>
936
+
<entry>
937
+
<literal>%s</literal>
938
+
</entry>
939
+
<entry>Status (response code)</entry>
940
+
</row>
941
+
<row>
942
+
<entry>
943
+
<literal>%t</literal>
944
+
</entry>
945
+
<entry>
946
+
Server time the request was received. It can
947
+
accept a <literal>strftime(3)</literal> format:
948
+
<literal>%d/%b/%Y:%H:%M:%S %z</literal> (default)
949
+
The <literal>strftime(3)</literal> format must be encapsulated in
950
+
a <literal>%{<strftime_format>}t</literal> tag, e.g. for a ISO8601
951
+
formatted timestring, use:
952
+
<literal>%{%Y-%m-%dT%H:%M:%S%z}t</literal>
953
+
</entry>
954
+
</row>
955
+
<row>
956
+
<entry>
957
+
<literal>%T</literal>
958
+
</entry>
959
+
<entry>
960
+
Time the log was written (when the request finished). It can accept a
961
+
<literal>strftime(3)</literal> format:
962
+
<literal>%d/%b/%Y:%H:%M:%S %z</literal> (default).
963
+
The <literal>strftime(3)</literal> format must be encapsulated in a
964
+
<literal>%{<strftime_format>}T</literal> tag, e.g. for a ISO8601
965
+
formatted timestring, use:
966
+
<literal>%{%Y-%m-%dT%H:%M:%S%z}T</literal>
967
+
</entry>
968
+
</row>
969
+
<row>
970
+
<entry>
971
+
<literal>%u</literal>
972
+
</entry>
973
+
<entry>Basic access authentication user, if specified in <literal>Authorization</literal> header</entry>
974
+
</row>
975
+
</tbody>
976
+
</tgroup>
977
+
</table>
978
+
</para>
979
+
</listitem>
980
+
</varlistentry>
449
981
</variablelist>
450
982
<para>
451
983
It's possible to pass additional environment variables and update PHP settings of a certain pool.
...
...
@@ -478,10 +1010,10 @@ php_admin_value[memory_limit] = 32M
478
1010
</para>
479
1011
<para>
480
1012
Settings defined with <literal>php_admin_value</literal> and <literal>php_admin_flag</literal>
481
-
cannot be overriden with <function>ini_set</function>.
1013
+
cannot be overridden with <function>ini_set</function>.
482
1014
</para>
483
1015
<para>
484
-
As of 5.3.3, PHP settings are also possible to be set in webserver.
1016
+
PHP settings can be set in the webserver configuration.
485
1017
<example>
486
1018
<title>set PHP settings in nginx.conf</title>
487
1019
<programlisting role="ini">
...
...
@@ -503,6 +1035,12 @@ fastcgi_param PHP_ADMIN_VALUE "open_basedir=/var/www/htdocs";
503
1035
<link linkend="listen-allowed-clients">listen.allowed_clients</link>.
504
1036
</para>
505
1037
</caution>
1038
+
<note>
1039
+
<simpara>
1040
+
Pools are not a security mechanism, because they do not provide full
1041
+
separation; e.g. all pools would use a single OPcache instance.
1042
+
</simpara>
1043
+
</note>
506
1044
</para>
507
1045
</sect2>
508
1046
509
1047