appendices/ini.core.xml
d4d5216e7a965ca194f6b1c9dee84cecab2674e5
...
...
@@ -15,35 +15,6 @@
15
15
The defaults listed here are used when &php.ini; is not loaded; the values for the production and development &php.ini; may vary.
16
16
</para>
17
17
</note>
18
-
<section xml:id="ini.sect.httpd-options">
19
-
<title>Httpd Options</title>
20
-
<para>
21
-
<table>
22
-
<title>Httpd Options</title>
23
-
<tgroup cols="4">
24
-
<thead>
25
-
<row>
26
-
<entry>&Name;</entry>
27
-
<entry>&Default;</entry>
28
-
<entry>&Changeable;</entry>
29
-
<entry>&Changelog;</entry>
30
-
</row>
31
-
</thead>
32
-
<tbody>
33
-
<row>
34
-
<entry>async_send</entry>
35
-
<entry>"0"</entry>
36
-
<entry>PHP_INI_ALL</entry>
37
-
<entry>Available since PHP 4.2.0. Removed in PHP 4.3.0.</entry>
38
-
</row>
39
-
</tbody>
40
-
</tgroup>
41
-
</table>
42
-
</para>
43
-
<para>
44
-
</para>
45
-
</section>
46
-
47
18
<section xml:id="ini.sect.language-options">
48
19
<title>Language Options</title>
49
20
<para>
...
...
@@ -62,56 +33,40 @@
62
33
<row>
63
34
<entry><link linkend="ini.short-open-tag">short_open_tag</link></entry>
64
35
<entry>"1"</entry>
65
-
<entry>PHP_INI_PERDIR</entry>
66
-
<entry>PHP_INI_ALL in PHP 4.0.0. PHP_INI_PERDIR in PHP &gt;= 4.0.1.</entry>
67
-
</row>
68
-
<row>
69
-
<entry><link linkend="ini.asp-tags">asp_tags</link></entry>
70
-
<entry>"0"</entry>
71
-
<entry>PHP_INI_PERDIR</entry>
72
-
<entry>PHP_INI_ALL in PHP 4.0.0. Removed in PHP 7.0.0.</entry>
36
+
<entry><constant>INI_PERDIR</constant></entry>
37
+
<entry></entry>
73
38
</row>
74
39
<row>
75
40
<entry><link linkend="ini.precision">precision</link></entry>
76
41
<entry>"14"</entry>
77
-
<entry>PHP_INI_ALL</entry>
42
+
<entry><constant>INI_ALL</constant></entry>
78
43
<entry></entry>
79
44
</row>
80
45
<row>
81
46
<entry><link linkend="ini.serialize-precision">serialize_precision</link></entry>
82
-
<entry>"17"</entry>
83
-
<entry>PHP_INI_ALL</entry>
84
-
<entry>Available since PHP 4.3.2. Until PHP 5.3.5, the default value was 100.</entry>
85
-
</row>
86
-
<row>
87
-
<entry><link linkend="ini.y2k-compliance">y2k_compliance</link></entry>
88
-
<entry>"1"</entry>
89
-
<entry>PHP_INI_ALL</entry>
90
-
<entry>Removed in PHP 5.4.0.</entry>
91
-
</row>
92
-
<row>
93
-
<entry><link linkend="ini.allow-call-time-pass-reference">allow_call_time_pass_reference</link></entry>
94
-
<entry>"1"</entry>
95
-
<entry>PHP_INI_PERDIR</entry>
96
-
<entry>PHP_INI_ALL in PHP 4.0.0. Removed in PHP 5.4.0.</entry>
47
+
<entry>"-1"</entry>
48
+
<entry><constant>INI_ALL</constant></entry>
49
+
<entry>
50
+
Prior to PHP 7.1.0, the default value was 17.
51
+
</entry>
97
52
</row>
98
53
<row>
99
54
<entry><link linkend="ini.disable-functions">disable_functions</link></entry>
100
55
<entry>""</entry>
101
-
<entry>PHP_INI_SYSTEM only</entry>
102
-
<entry>Available since PHP 4.0.1.</entry>
56
+
<entry><constant>INI_SYSTEM</constant> only</entry>
57
+
<entry></entry>
103
58
</row>
104
59
<row>
105
60
<entry><link linkend="ini.disable-classes">disable_classes</link></entry>
106
61
<entry>""</entry>
107
62
<entry>&php.ini; only</entry>
108
-
<entry>Available since PHP 4.3.2.</entry>
63
+
<entry></entry>
109
64
</row>
110
65
<row>
111
66
<entry><link linkend="ini.exit-on-timeout">exit_on_timeout</link></entry>
112
67
<entry>""</entry>
113
-
<entry>PHP_INI_ALL</entry>
114
-
<entry>Available since PHP 5.3.0.</entry>
68
+
<entry><constant>INI_ALL</constant></entry>
69
+
<entry></entry>
115
70
</row>
116
71
<row>
117
72
<entry><link linkend="ini.expose-php">expose_php</link></entry>
...
...
@@ -120,46 +75,52 @@
120
75
<entry></entry>
121
76
</row>
122
77
<row>
78
+
<entry><link linkend="ini.hard-timeout">hard_timeout</link></entry>
79
+
<entry>"2"</entry>
80
+
<entry><constant>INI_SYSTEM</constant></entry>
81
+
<entry>Available as of PHP 7.1.0.</entry>
82
+
</row>
83
+
<row>
84
+
<entry><link linkend="ini.zend.exception-ignore-args">zend.exception_ignore_args</link></entry>
85
+
<entry>"0"</entry>
86
+
<entry><constant>INI_ALL</constant></entry>
87
+
<entry>Available as of PHP 7.4.0</entry>
88
+
</row>
89
+
<row>
123
90
<entry><link linkend="ini.zend.multibyte">zend.multibyte</link></entry>
124
91
<entry>"0"</entry>
125
-
<entry>PHP_INI_ALL</entry>
126
-
<entry>Available since PHP 5.4.0</entry>
92
+
<entry><constant>INI_ALL</constant></entry>
93
+
<entry></entry>
127
94
</row>
128
95
<row>
129
96
<entry><link linkend="ini.zend.script-encoding">zend.script_encoding</link></entry>
130
97
<entry>NULL</entry>
131
-
<entry>PHP_INI_ALL</entry>
132
-
<entry>Available since PHP 5.4.0</entry>
98
+
<entry><constant>INI_ALL</constant></entry>
99
+
<entry></entry>
133
100
</row>
134
101
<row>
135
-
<entry><link linkend="ini.zend.detect-unicode">zend.detect-unicode</link></entry>
102
+
<entry><link linkend="ini.zend.detect-unicode">zend.detect_unicode</link></entry>
136
103
<entry>NULL</entry>
137
-
<entry>PHP_INI_ALL</entry>
138
-
<entry>Available since PHP 5.4.0</entry>
104
+
<entry><constant>INI_ALL</constant></entry>
105
+
<entry></entry>
139
106
</row>
140
107
<row>
141
108
<entry><link linkend="ini.zend.signal-check">zend.signal_check</link></entry>
142
109
<entry>"0"</entry>
143
-
<entry>PHP_INI_SYSTEM</entry>
144
-
<entry>Available since PHP 5.4.0</entry>
110
+
<entry><constant>INI_SYSTEM</constant></entry>
111
+
<entry></entry>
145
112
</row>
146
113
<row>
147
114
<entry><link linkend="ini.zend.assertions">zend.assertions</link></entry>
148
115
<entry>"1"</entry>
149
-
<entry>PHP_INI_ALL</entry>
150
-
<entry>Available since PHP 7.0.0.</entry>
151
-
</row>
152
-
<row>
153
-
<entry><link linkend="ini.zend.ze1-compatibility-mode">zend.ze1_compatibility_mode</link></entry>
154
-
<entry>"0"</entry>
155
-
<entry>PHP_INI_ALL</entry>
156
-
<entry>Available since PHP 5.0.0. Removed in PHP 5.3.0</entry>
116
+
<entry><constant>INI_ALL</constant> with restrictions</entry>
117
+
<entry></entry>
157
118
</row>
158
119
<row>
159
-
<entry>detect_unicode</entry>
160
-
<entry>"1"</entry>
161
-
<entry>PHP_INI_ALL</entry>
162
-
<entry>Available since PHP 5.1.0. Renamed to <link linkend="ini.zend.detect-unicode">zend.detect-unicode</link> from PHP 5.4.0.</entry>
120
+
<entry><link linkend="ini.zend.exception-string-param-max-len">zend.exception_string_param_max_len</link></entry>
121
+
<entry>"15"</entry>
122
+
<entry><constant>INI_ALL</constant></entry>
123
+
<entry>Available as of PHP 8.0.0.</entry>
163
124
</row>
164
125
</tbody>
165
126
</tgroup>
...
...
@@ -173,7 +134,7 @@
173
134
<varlistentry xml:id="ini.short-open-tag">
174
135
<term>
175
136
<parameter>short_open_tag</parameter>
176
-
<type>boolean</type>
137
+
<type>bool</type>
177
138
</term>
178
139
<listitem>
179
140
<para>
...
...
@@ -187,62 +148,23 @@
187
148
</para>
188
149
<note>
189
150
<para>
190
-
This directive also affected the shorthand
191
-
<userinput>&lt;?=</userinput> before PHP 5.4.0,
192
-
which is identical to <userinput>&lt;? echo</userinput>. Use of this
193
-
shortcut required <systemitem role="directive">short_open_tag</systemitem>
194
-
to be on.
195
-
Since PHP 5.4.0, <userinput>&lt;?=</userinput> is always available.
151
+
This directive does not affect the shorthand
152
+
<userinput>&lt;?=</userinput>, which is always available.
196
153
</para>
197
154
</note>
198
155
</listitem>
199
156
</varlistentry>
200
157
201
-
<varlistentry xml:id="ini.asp-tags">
202
-
<term>
203
-
<parameter>asp_tags</parameter>
204
-
<type>boolean</type>
205
-
</term>
206
-
<listitem>
207
-
<simpara>
208
-
Enables the use of ASP-like &lt;% %&gt; tags in addition to
209
-
the usual &lt;?php ?&gt; tags. This includes the
210
-
variable-value printing shorthand of &lt;%= $value %&gt;. For
211
-
more information, see <link
212
-
linkend="language.basic-syntax.phpmode">Escaping from HTML</link>.
213
-
</simpara>
214
-
<para>
215
-
<table>
216
-
<title>Changelog for <literal>asp_tags</literal></title>
217
-
<tgroup cols="2">
218
-
<thead>
219
-
<row>
220
-
<entry>&Version;</entry>
221
-
<entry>&Description;</entry>
222
-
</row>
223
-
</thead>
224
-
<tbody>
225
-
<row>
226
-
<entry>7.0.0</entry>
227
-
<entry>
228
-
Removed from PHP.
229
-
</entry>
230
-
</row>
231
-
</tbody>
232
-
</tgroup>
233
-
</table>
234
-
</para>
235
-
</listitem>
236
-
</varlistentry>
237
-
238
158
<varlistentry xml:id="ini.precision">
239
159
<term>
240
160
<parameter>precision</parameter>
241
-
<type>integer</type>
161
+
<type>int</type>
242
162
</term>
243
163
<listitem>
244
164
<simpara>
245
165
The number of significant digits displayed in floating point numbers.
166
+
<literal>-1</literal> means that an enhanced algorithm for rounding
167
+
such numbers will be used.
246
168
</simpara>
247
169
</listitem>
248
170
</varlistentry>
...
...
@@ -250,114 +172,26 @@
250
172
<varlistentry xml:id="ini.serialize-precision">
251
173
<term>
252
174
<parameter>serialize_precision</parameter>
253
-
<type>integer</type>
175
+
<type>int</type>
254
176
</term>
255
177
<listitem>
256
178
<simpara>
257
179
The number of significant digits stored while serializing floating point numbers.
258
-
</simpara>
259
-
</listitem>
260
-
</varlistentry>
261
-
262
-
<varlistentry xml:id="ini.y2k-compliance">
263
-
<term>
264
-
<parameter>y2k_compliance</parameter>
265
-
<type>boolean</type>
266
-
</term>
267
-
<listitem>
268
-
<simpara>
269
-
Enforce year 2000 compliance (will cause problems with non-compliant browsers)
270
-
</simpara>
271
-
</listitem>
272
-
</varlistentry>
273
-
274
-
275
-
<varlistentry xml:id="ini.allow-call-time-pass-reference">
276
-
<term>
277
-
<parameter>allow_call_time_pass_reference</parameter>
278
-
<type>boolean</type>
279
-
</term>
280
-
<listitem>
281
-
<para>
282
-
Whether to warn when arguments are passed by reference at function call time.
283
-
The encouraged method of specifying which arguments should be passed by
284
-
reference is in the function declaration. You're encouraged to try and turn
285
-
this option Off and make sure your scripts work properly with it in order to
286
-
ensure they will work with future versions of the language (you will receive
287
-
a warning each time you use this feature).
288
-
</para>
289
-
<para>
290
-
Passing arguments by reference at function call time was deprecated for
291
-
code-cleanliness reasons. A function can modify its arguments in an
292
-
undocumented way if it didn't declare that the argument shall be passed by
293
-
reference. To prevent side-effects it's better to specify which
294
-
arguments are passed by reference in the function declaration only.
295
-
</para>
296
-
<para>
297
-
See also <link linkend="language.references">References Explained</link>.
298
-
</para>
299
-
<para>
300
-
<table>
301
-
<title>Changelog for <literal>allow_call_time_pass_reference</literal></title>
302
-
<tgroup cols="2">
303
-
<thead>
304
-
<row>
305
-
<entry>&Version;</entry>
306
-
<entry>&Description;</entry>
307
-
</row>
308
-
</thead>
309
-
<tbody>
310
-
<row>
311
-
<entry>5.4.0</entry>
312
-
<entry>
313
-
Removed from PHP.
314
-
</entry>
315
-
</row>
316
-
<row>
317
-
<entry>5.3.0</entry>
318
-
<entry>
319
-
Emits an <constant>E_DEPRECATED</constant> level error.
320
-
</entry>
321
-
</row>
322
-
<row>
323
-
<entry>5.0.0</entry>
324
-
<entry>
325
-
Deprecated, and generates an <constant>E_COMPILE_WARNING</constant> level error.
326
-
</entry>
327
-
</row>
328
-
</tbody>
329
-
</tgroup>
330
-
</table>
331
-
</para>
180
+
<literal>-1</literal> means that an enhanced algorithm for rounding
181
+
such numbers will be used.
182
+
</simpara>
332
183
</listitem>
333
184
</varlistentry>
334
185
335
186
<varlistentry xml:id="ini.expose-php">
336
187
<term>
337
188
<parameter>expose_php</parameter>
338
-
<type>boolean</type>
189
+
<type>bool</type>
339
190
</term>
340
191
<listitem>
341
192
<para>
342
193
Exposes to the world that PHP is installed on the server, which includes the
343
194
PHP version within the HTTP header (e.g., X-Powered-By: PHP/5.3.7).
344
-
Prior to PHP 5.5.0 the PHP logo guids are also exposed, thus appending them
345
-
to the URL of your PHP script would display the appropriate logo
346
-
(e.g., <link xlink:href="&url.php;?=PHPE9568F34-D428-11d2-A769-00AA001ACF42">&url.php;?=PHPE9568F34-D428-11d2-A769-00AA001ACF42</link>).
347
-
This also affected the output of <function>phpinfo</function>, as when disabled, the PHP logo
348
-
and credits information would not be displayed.
349
-
</para>
350
-
<note>
351
-
<para>
352
-
Since PHP 5.5.0 these guids and the <function>php_logo_guid</function> function
353
-
have been removed from PHP and the guids are replaced with data URIs instead.
354
-
Thus accessing the PHP logo via appending the guid to the URL no longer works.
355
-
Similarly, turning <parameter>expose_php</parameter> off will not affect
356
-
seeing the PHP logo in <function>phpinfo</function>.
357
-
</para>
358
-
</note>
359
-
<para>
360
-
See also <function>php_logo_guid</function> and <function>phpcredits</function>.
361
195
</para>
362
196
</listitem>
363
197
</varlistentry>
...
...
@@ -369,10 +203,8 @@
369
203
</term>
370
204
<listitem>
371
205
<para>
372
-
This directive allows you to disable certain functions for
373
-
<link linkend="security">security</link> reasons. It takes
374
-
on a comma-delimited list of function names. disable_functions
375
-
is not affected by <link linkend="ini.safe-mode">Safe Mode</link>.
206
+
This directive allows you to disable certain functions. It takes
207
+
on a comma-delimited list of function names.
376
208
</para>
377
209
<para>
378
210
Only <link linkend="functions.internal">internal functions</link> can
...
...
@@ -393,10 +225,8 @@
393
225
</term>
394
226
<listitem>
395
227
<simpara>
396
-
This directive allows you to disable certain classes for
397
-
<link linkend="security">security</link> reasons. It takes
398
-
on a comma-delimited list of class names. disable_classes
399
-
is not affected by <link linkend="ini.safe-mode">Safe Mode</link>.
228
+
This directive allows you to disable certain classes. It takes
229
+
on a comma-delimited list of class names.
400
230
</simpara>
401
231
<simpara>
402
232
This directive must be set in &php.ini; For example, you
...
...
@@ -408,7 +238,7 @@
408
238
<varlistentry xml:id="ini.zend.assertions">
409
239
<term>
410
240
<parameter>zend.assertions</parameter>
411
-
<type>integer</type>
241
+
<type>int</type>
412
242
</term>
413
243
<listitem>
414
244
<simpara>
...
...
@@ -416,41 +246,74 @@
416
246
executed (development mode). When set to <literal>0</literal>,
417
247
assertion code will be generated but it will be skipped (not executed)
418
248
at runtime. When set to <literal>-1</literal>, assertion code will not
419
-
be generated, making the assetions zero-cost (production mode).
249
+
be generated, making the assertions zero-cost (production mode).
250
+
</simpara>
251
+
<note>
252
+
<para>
253
+
If a process is started in production mode, <link linkend="ini.zend.assertions">zend.assertions</link>
254
+
cannot be changed at runtime, since the code for assertions was not generated.
255
+
</para>
256
+
<para>
257
+
If a process is started in development mode, <link linkend="ini.zend.assertions">zend.assertions</link>
258
+
cannot be set to <literal>-1</literal> at runtime.
259
+
</para>
260
+
</note>
261
+
</listitem>
262
+
</varlistentry>
263
+

264
+
<varlistentry xml:id="ini.zend.exception-string-param-max-len">
265
+
<term>
266
+
<parameter>zend.exception_string_param_max_len</parameter>
267
+
<type>int</type>
268
+
</term>
269
+
<listitem>
270
+
<simpara>
271
+
The maximum length of string function arguments in stringified stack traces.
272
+
Must range between <literal>"0"</literal> and <literal>"1000000"</literal>.
420
273
</simpara>
421
274
</listitem>
422
275
</varlistentry>
423
276

424
-
<varlistentry xml:id="ini.zend.ze1-compatibility-mode">
277
+
<varlistentry xml:id="ini.hard-timeout">
425
278
<term>
426
-
<parameter>zend.ze1_compatibility_mode</parameter>
427
-
<type>boolean</type>
279
+
<parameter>hard_timeout</parameter>
280
+
<type>int</type>
428
281
</term>
429
282
<listitem>
430
283
<para>
431
-
Enable compatibility mode with Zend Engine 1 (PHP 4). It affects
432
-
the cloning, casting (objects with no properties cast to &false; or 0), and <link
433
-
linkend="language.oop5.object-comparison">comparing of objects</link>.
434
-
In this mode, objects are passed by value instead of reference by
435
-
default.
284
+
When the timeout set in <link linkend="ini.max-execution-time">max_execution_time</link>
285
+
has been hit, the PHP runtime will tear down resources gracefully. If
286
+
something gets stuck while this happens, the hard timeout will tick
287
+
for the set amount of seconds. When the hard timeout is hit, PHP will
288
+
exit ungracefully. When set to 0, the hard timeout will never activate.
436
289
</para>
437
290
<para>
438
-
See also the section titled
439
-
<link linkend="migration5">Migrating from PHP 4 to PHP 5</link>.
291
+
When PHP stops from a hard timeout, it will look something like this:
292
+
<screen>
293
+
<![CDATA[
294
+
Fatal error: Maximum execution time of 30+2 seconds exceeded (terminated) in Unknown on line 0
295
+
]]>
296
+
</screen>
440
297
</para>
441
-
<warning>
442
-
<simpara>This feature has been <emphasis>DEPRECATED</emphasis> and <emphasis>REMOVED</emphasis>
443
-
as of PHP 5.3.0.
444
-
</simpara>
445
-
</warning>
298
+
</listitem>
299
+
</varlistentry>
446
300
301
+
<varlistentry xml:id="ini.zend.exception-ignore-args">
302
+
<term>
303
+
<parameter>zend.exception_ignore_args</parameter>
304
+
<type>bool</type>
305
+
</term>
306
+
<listitem>
307
+
<para>
308
+
Excludes arguments from stack traces generated from exceptions.
309
+
</para>
447
310
</listitem>
448
311
</varlistentry>
449
312

450
313
<varlistentry xml:id="ini.zend.multibyte">
451
314
<term>
452
315
<parameter>zend.multibyte</parameter>
453
-
<type>boolean</type>
316
+
<type>bool</type>
454
317
</term>
455
318
<listitem>
456
319
<para>
...
...
@@ -478,7 +341,7 @@
478
341
is used, both zend.multibyte and zend.script_encoding must be used.
479
342
</para>
480
343
<para>
481
-
Literal strings will be transliterated from zend.script_enconding to
344
+
Literal strings will be transliterated from zend.script_encoding to
482
345
mbstring.internal_encoding, as if
483
346
<function>mb_convert_encoding</function> would have been called.
484
347
</para>
...
...
@@ -488,7 +351,7 @@
488
351
<varlistentry xml:id="ini.zend.detect-unicode">
489
352
<term>
490
353
<parameter>zend.detect_unicode</parameter>
491
-
<type>boolean</type>
354
+
<type>bool</type>
492
355
</term>
493
356
<listitem>
494
357
<para>
...
...
@@ -504,7 +367,7 @@
504
367
<varlistentry xml:id="ini.zend.signal-check">
505
368
<term>
506
369
<parameter>zend.signal_check</parameter>
507
-
<type>boolean</type>
370
+
<type>bool</type>
508
371
</term>
509
372
<listitem>
510
373
<para>
...
...
@@ -516,7 +379,7 @@
516
379
<varlistentry xml:id="ini.exit-on-timeout">
517
380
<term>
518
381
<parameter>exit_on_timeout</parameter>
519
-
<type>boolean</type>
382
+
<type>bool</type>
520
383
</term>
521
384
<listitem>
522
385
<para>
...
...
@@ -549,8 +412,8 @@
549
412
<row>
550
413
<entry><link linkend="ini.memory-limit">memory_limit</link></entry>
551
414
<entry>"128M"</entry>
552
-
<entry>PHP_INI_ALL</entry>
553
-
<entry>"8M" before PHP 5.2.0, "16M" in PHP 5.2.0</entry>
415
+
<entry><constant>INI_ALL</constant></entry>
416
+
<entry></entry>
554
417
</row>
555
418
</tbody>
556
419
</tgroup>
...
...
@@ -564,7 +427,7 @@
564
427
<varlistentry xml:id="ini.memory-limit">
565
428
<term>
566
429
<parameter>memory_limit</parameter>
567
-
<type>integer</type>
430
+
<type>int</type>
568
431
</term>
569
432
<listitem>
570
433
<para>
...
...
@@ -573,14 +436,6 @@
573
436
scripts for eating up all available memory on a server. Note that
574
437
to have no memory limit, set this directive to <literal>-1</literal>.
575
438
</para>
576
-
<para>
577
-
Prior to PHP 5.2.1, in order to use this directive it had to
578
-
be enabled at compile time by using
579
-
<option role="configure">--enable-memory-limit</option> in the
580
-
configure line. This compile-time flag was also required to define
581
-
the functions <function>memory_get_usage</function> and
582
-
<function>memory_get_peak_usage</function> prior to 5.2.1.
583
-
</para>
584
439
585
440
&ini.shorthandbytes;
586
441
...
...
@@ -610,19 +465,25 @@
610
465
<tbody>
611
466
<row>
612
467
<entry><link linkend="ini.realpath-cache-size">realpath_cache_size</link></entry>
613
-
<entry>"16K"</entry>
614
-
<entry>PHP_INI_SYSTEM</entry>
615
-
<entry>Available since PHP 5.1.0.</entry>
468
+
<entry>"4M"</entry>
469
+
<entry><constant>INI_SYSTEM</constant></entry>
470
+
<entry>Prior to PHP 7.0.16 and 7.1.2, the default was <literal>"16K"</literal></entry>
616
471
</row>
617
472
<row>
618
473
<entry><link linkend="ini.realpath-cache-ttl">realpath_cache_ttl</link></entry>
619
474
<entry>"120"</entry>
620
-
<entry>PHP_INI_SYSTEM</entry>
621
-
<entry>Available since PHP 5.1.0.</entry>
475
+
<entry><constant>INI_SYSTEM</constant></entry>
476
+
<entry></entry>
622
477
</row>
623
478
</tbody>
624
479
</tgroup>
625
480
</table>
481
+
<note>
482
+
<para>
483
+
Using <link linkend="ini.open-basedir">open_basedir</link> will
484
+
<emphasis>disable</emphasis> the realpath cache.
485
+
</para>
486
+
</note>
626
487
</para>
627
488
&ini.descriptions.title;
628
489
<para>
...
...
@@ -630,7 +491,7 @@
630
491
<varlistentry xml:id="ini.realpath-cache-size">
631
492
<term>
632
493
<parameter>realpath_cache_size</parameter>
633
-
<type>integer</type>
494
+
<type>int</type>
634
495
</term>
635
496
<listitem>
636
497
<para>
...
...
@@ -653,7 +514,7 @@
653
514
<varlistentry xml:id="ini.realpath-cache-ttl">
654
515
<term>
655
516
<parameter>realpath_cache_ttl</parameter>
656
-
<type>integer</type>
517
+
<type>int</type>
657
518
</term>
658
519
<listitem>
659
520
<para>
...
...
@@ -685,92 +546,92 @@
685
546
<row>
686
547
<entry><link linkend="ini.arg-separator.output">arg_separator.output</link></entry>
687
548
<entry>"&amp;"</entry>
688
-
<entry>PHP_INI_ALL</entry>
689
-
<entry>Available since PHP 4.0.5.</entry>
549
+
<entry><constant>INI_ALL</constant></entry>
550
+
<entry></entry>
690
551
</row>
691
552
<row>
692
553
<entry><link linkend="ini.arg-separator.input">arg_separator.input</link></entry>
693
554
<entry>"&amp;"</entry>
694
-
<entry>PHP_INI_PERDIR</entry>
695
-
<entry>Available since PHP 4.0.5.</entry>
555
+
<entry><constant>INI_PERDIR</constant></entry>
556
+
<entry></entry>
696
557
</row>
697
558
<row>
698
559
<entry><link linkend="ini.variables-order">variables_order</link></entry>
699
560
<entry>"EGPCS"</entry>
700
-
<entry>PHP_INI_PERDIR</entry>
701
-
<entry>PHP_INI_ALL in PHP &lt;= 5.0.5.</entry>
561
+
<entry><constant>INI_PERDIR</constant></entry>
562
+
<entry></entry>
702
563
</row>
703
564
<row>
704
565
<entry><link linkend="ini.request-order">request_order</link></entry>
705
566
<entry>""</entry>
706
-
<entry>PHP_INI_PERDIR</entry>
707
-
<entry>Available since PHP 5.3.0</entry>
567
+
<entry><constant>INI_PERDIR</constant></entry>
568
+
<entry></entry>
708
569
</row>
709
570
<row>
710
571
<entry><link linkend="ini.auto-globals-jit">auto_globals_jit</link></entry>
711
572
<entry>"1"</entry>
712
-
<entry>PHP_INI_PERDIR</entry>
713
-
<entry>Available since PHP 5.0.0.</entry>
714
-
</row>
715
-
<row>
716
-
<entry><link linkend="ini.register-globals">register_globals</link></entry>
717
-
<entry>"0"</entry>
718
-
<entry>PHP_INI_PERDIR</entry>
719
-
<entry>PHP_INI_ALL in PHP &lt;= 4.2.3. Removed in PHP 5.4.0.</entry>
573
+
<entry><constant>INI_PERDIR</constant></entry>
574
+
<entry></entry>
720
575
</row>
721
576
<row>
722
577
<entry><link linkend="ini.register-argc-argv">register_argc_argv</link></entry>
723
578
<entry>"1"</entry>
724
-
<entry>PHP_INI_PERDIR</entry>
725
-
<entry>PHP_INI_ALL in PHP &lt;= 4.2.3.</entry>
726
-
</row>
727
-
<row>
728
-
<entry><link linkend="ini.register-long-arrays">register_long_arrays</link></entry>
729
-
<entry>"1"</entry>
730
-
<entry>PHP_INI_PERDIR</entry>
731
-
<entry>Available since PHP 5.0.0. Deprecated in PHP 5.3.0. Removed in PHP 5.4.0.</entry>
579
+
<entry><constant>INI_PERDIR</constant></entry>
580
+
<entry></entry>
732
581
</row>
733
582
<row>
734
583
<entry><link linkend="ini.enable-post-data-reading">enable_post_data_reading</link></entry>
735
584
<entry>"1"</entry>
736
-
<entry>PHP_INI_PERDIR</entry>
737
-
<entry>Available since PHP 5.4.0</entry>
585
+
<entry><constant>INI_PERDIR</constant></entry>
586
+
<entry></entry>
738
587
</row>
739
588
<row>
740
589
<entry><link linkend="ini.post-max-size">post_max_size</link></entry>
741
590
<entry>"8M"</entry>
742
-
<entry>PHP_INI_PERDIR</entry>
743
-
<entry>PHP_INI_SYSTEM in PHP &lt;= 4.2.3. Available since PHP 4.0.3.</entry>
591
+
<entry><constant>INI_PERDIR</constant></entry>
592
+
<entry></entry>
744
593
</row>
745
594
<row>
746
595
<entry><link linkend="ini.auto-prepend-file">auto_prepend_file</link></entry>
747
596
<entry>NULL</entry>
748
-
<entry>PHP_INI_PERDIR</entry>
749
-
<entry>PHP_INI_ALL in PHP &lt;= 4.2.3.</entry>
597
+
<entry><constant>INI_PERDIR</constant></entry>
598
+
<entry></entry>
750
599
</row>
751
600
<row>
752
601
<entry><link linkend="ini.auto-append-file">auto_append_file</link></entry>
753
602
<entry>NULL</entry>
754
-
<entry>PHP_INI_PERDIR</entry>
755
-
<entry>PHP_INI_ALL in PHP &lt;= 4.2.3.</entry>
603
+
<entry><constant>INI_PERDIR</constant></entry>
604
+
<entry></entry>
756
605
</row>
757
606
<row>
758
607
<entry><link linkend="ini.default-mimetype">default_mimetype</link></entry>
759
608
<entry>"text/html"</entry>
760
-
<entry>PHP_INI_ALL</entry>
609
+
<entry><constant>INI_ALL</constant></entry>
761
610
<entry></entry>
762
611
</row>
763
612
<row>
764
613
<entry><link linkend="ini.default-charset">default_charset</link></entry>
765
614
<entry>"UTF-8"</entry>
766
-
<entry>PHP_INI_ALL</entry>
767
-
<entry>Defaults to "UTF-8" since PHP &gt;= 5.6.0; empty for PHP &lt; 5.6.0.</entry>
615
+
<entry><constant>INI_ALL</constant></entry>
616
+
<entry></entry>
768
617
</row>
769
618
<row>
770
-
<entry><link linkend="ini.always-populate-raw-post-data">always_populate_raw_post_data</link></entry>
771
-
<entry>"0"</entry>
772
-
<entry>PHP_INI_PERDIR</entry>
773
-
<entry>PHP_INI_ALL in PHP &lt;= 4.2.3. Available since PHP 4.1.0. Removed in PHP 7.0.0.</entry>
619
+
<entry><link linkend="ini.input-encoding">input_encoding</link></entry>
620
+
<entry>""</entry>
621
+
<entry><constant>INI_ALL</constant></entry>
622
+
<entry></entry>
623
+
</row>
624
+
<row>
625
+
<entry><link linkend="ini.output-encoding">output_encoding</link></entry>
626
+
<entry>""</entry>
627
+
<entry><constant>INI_ALL</constant></entry>
628
+
<entry></entry>
629
+
</row>
630
+
<row>
631
+
<entry><link linkend="ini.internal-encoding">internal_encoding</link></entry>
632
+
<entry>""</entry>
633
+
<entry><constant>INI_ALL</constant></entry>
634
+
<entry></entry>
774
635
</row>
775
636
</tbody>
776
637
</tgroup>
...
...
@@ -828,21 +689,6 @@
828
689
<varname>$_COOKIE</varname>. Setting to "" means no
829
690
&link.superglobals; will be set.
830
691
</para>
831
-
<para>
832
-
If the deprecated
833
-
<link linkend="ini.register-globals">register_globals</link>
834
-
directive is on, then variables_order also
835
-
configures the order the <literal>ENV</literal>,
836
-
<literal>GET</literal>, <literal>POST</literal>,
837
-
<literal>COOKIE</literal> and <literal>SERVER</literal> variables
838
-
are populated in global scope. So for example if variables_order
839
-
is set to <literal>"EGPCS"</literal>, register_globals is enabled,
840
-
and both <varname>$_GET['action']</varname> and
841
-
<varname>$_POST['action']</varname> are set, then
842
-
<varname>$action</varname> will contain the value of
843
-
<varname>$_POST['action']</varname> as <literal>P</literal> comes
844
-
after <literal>G</literal> in our example directive value.
845
-
</para>
846
692
<warning>
847
693
<para>
848
694
In both the CGI and FastCGI SAPIs,
...
...
@@ -888,27 +734,18 @@
888
734
<varlistentry xml:id="ini.auto-globals-jit">
889
735
<term>
890
736
<parameter>auto_globals_jit</parameter>
891
-
<type>boolean</type>
737
+
<type>bool</type>
892
738
</term>
893
739
<listitem>
894
740
<para>
895
-
When enabled, the SERVER and ENV variables are created when they're
741
+
When enabled, the SERVER, REQUEST, and ENV variables are created when they're
896
742
first used (Just In Time) instead of when the script starts. If these
897
743
variables are not used within a script, having this directive on will
898
744
result in a performance gain.
899
745
</para>
900
-
<para>
901
-
The PHP directives
902
-
<link linkend="ini.register-globals">register_globals</link>,
903
-
<link linkend="ini.register-long-arrays">register_long_arrays</link>,
904
-
and <link linkend="ini.register-argc-argv">register_argc_argv</link>
905
-
must be disabled for this directive to have any affect. Since PHP
906
-
5.1.3 it is not necessary to have <link
907
-
linkend="ini.register-argc-argv">register_argc_argv</link> disabled.
908
-
</para>
909
746
<warning>
910
747
<para>
911
-
Usage of SERVER and ENV variables is checked during the compile time
748
+
Usage of SERVER, REQUEST, and ENV variables is checked during the compile time
912
749
so using them through e.g. <link
913
750
linkend="language.variables.variable">variable variables</link> will
914
751
not cause their initialization.
...
...
@@ -917,47 +754,10 @@
917
754
</listitem>
918
755
</varlistentry>
919
756
920
-
<varlistentry xml:id="ini.register-globals">
921
-
<term>
922
-
<parameter>register_globals</parameter>
923
-
<type>boolean</type>
924
-
</term>
925
-
<listitem>
926
-
<para>
927
-
Whether or not to register the EGPCS (Environment, GET,
928
-
POST, Cookie, Server) variables as global variables.
929
-
</para>
930
-
<para>
931
-
As of <link xlink:href="&url.php.release4.2.0;">PHP 4.2.0</link>,
932
-
this directive defaults to <emphasis>off</emphasis>.
933
-
</para>
934
-
<para>
935
-
Please read the security chapter on
936
-
<link linkend="security.globals">Using register_globals</link>
937
-
for related information.
938
-
</para>
939
-
<para>
940
-
Please note that <systemitem role="directive">register_globals</systemitem>
941
-
cannot be set at runtime (<function>ini_set</function>). Although, you can
942
-
use &htaccess; if your host allows it as described
943
-
above. An example &htaccess; entry:
944
-
<userinput>php_flag register_globals off</userinput>.
945
-
</para>
946
-
<note>
947
-
<para>
948
-
<systemitem role="directive">register_globals</systemitem> is affected
949
-
by the <link linkend="ini.variables-order">variables_order</link>
950
-
directive.
951
-
</para>
952
-
</note>
953
-
&warn.deprecated.feature-5-3-0.removed-5-4-0;
954
-
</listitem>
955
-
</varlistentry>
956
-
957
757
<varlistentry xml:id="ini.register-argc-argv">
958
758
<term>
959
759
<parameter>register_argc_argv</parameter>
960
-
<type>boolean</type>
760
+
<type>bool</type>
961
761
</term>
962
762
<listitem>
963
763
<simpara>
...
...
@@ -970,33 +770,10 @@
970
770
</listitem>
971
771
</varlistentry>
972
772
973
-
<varlistentry xml:id="ini.register-long-arrays">
974
-
<term>
975
-
<parameter>register_long_arrays</parameter>
976
-
<type>boolean</type>
977
-
</term>
978
-
<listitem>
979
-
<simpara>
980
-
Tells PHP whether or not to register the deprecated long
981
-
<varname>$HTTP_*_VARS</varname> type
982
-
<link linkend="language.variables.predefined">predefined
983
-
variables</link>. When On (default), long predefined PHP
984
-
variables like <varname>$HTTP_GET_VARS</varname> will be defined.
985
-
If you're not using them, it's recommended to turn them off,
986
-
for performance reasons. Instead, use the superglobal arrays,
987
-
like <varname>$_GET</varname>.
988
-
</simpara>
989
-
<simpara>
990
-
This directive became available in PHP 5.0.0.
991
-
</simpara>
992
-
&warn.deprecated.feature-5-3-0.removed-5-4-0;
993
-
</listitem>
994
-
</varlistentry>
995
-
996
773
<varlistentry xml:id="ini.enable-post-data-reading">
997
774
<term>
998
775
<parameter>enable_post_data_reading</parameter>
999
-
<type>boolean</type>
776
+
<type>bool</type>
1000
777
</term>
1001
778
<listitem>
1002
779
<simpara>
...
...
@@ -1013,7 +790,7 @@
1013
790
<varlistentry xml:id="ini.post-max-size">
1014
791
<term>
1015
792
<parameter>post_max_size</parameter>
1016
-
<type>integer</type>
793
+
<type>int</type>
1017
794
</term>
1018
795
<listitem>
1019
796
<simpara>
...
...
@@ -1128,8 +905,11 @@
1128
905
</term>
1129
906
<listitem>
1130
907
<para>
1131
-
By default, PHP will output a character encoding using the Content-Type
1132
-
header. To disable sending of the charset, simply set it to be empty.
908
+
By default, PHP will output a media type using the Content-Type header.
909
+
To disable this, simply set it to be empty.
910
+
</para>
911
+
<para>
912
+
PHP's built-in default media type is set to text/html.
1133
913
</para>
1134
914
</listitem>
1135
915
</varlistentry>
...
...
@@ -1141,7 +921,7 @@
1141
921
</term>
1142
922
<listitem>
1143
923
<para>
1144
-
In PHP 5.6 onwards, "UTF-8" is the default value and its value is used
924
+
"UTF-8" is the default value and its value is used
1145
925
as the default character encoding for
1146
926
<function>htmlentities</function>,
1147
927
<function>html_entity_decode</function> and
...
...
@@ -1179,7 +959,7 @@
1179
959
</term>
1180
960
<listitem>
1181
961
<para>
1182
-
Available from PHP 5.6.0. This setting is used for multibyte modules
962
+
This setting is used for multibyte modules
1183
963
such as mbstring and iconv. Default is empty.
1184
964
</para>
1185
965
</listitem>
...
...
@@ -1192,7 +972,7 @@
1192
972
</term>
1193
973
<listitem>
1194
974
<para>
1195
-
Available from PHP 5.6.0. This setting is used for multibyte modules
975
+
This setting is used for multibyte modules
1196
976
such as mbstring and iconv. Default is empty.
1197
977
</para>
1198
978
</listitem>
...
...
@@ -1205,50 +985,15 @@
1205
985
</term>
1206
986
<listitem>
1207
987
<para>
1208
-
Available from PHP 5.6.0. This setting is used for multibyte modules
988
+
This setting is used for multibyte modules
1209
989
such as mbstring and iconv. Default is empty. If empty,
1210
990
<link linkend="ini.default-charset">default_charset</link> is used.
1211
991
</para>
1212
992
</listitem>
1213
993
</varlistentry>
1214
994
1215
-
<varlistentry xml:id="ini.always-populate-raw-post-data">
1216
-
<term>
1217
-
<parameter>always_populate_raw_post_data</parameter>
1218
-
<type>mixed</type>
1219
-
</term>
1220
-
<listitem>
1221
-
&warn.deprecated.feature-5-6-0.removed-7-0-0;
1222
-
<para>
1223
-
If set to &true;, PHP will always populate the
1224
-
<varname>$HTTP_RAW_POST_DATA</varname> containing the raw POST data.
1225
-
Otherwise, the variable is populated only when the MIME type of the
1226
-
data is unrecognised.
1227
-
</para>
1228
-
<para>
1229
-
The preferred method for accessing raw POST data is
1230
-
<link linkend="wrappers.php">php://input</link>, and
1231
-
<varname>$HTTP_RAW_POST_DATA</varname> is deprecated in PHP 5.6.0
1232
-
onwards. Setting <parameter>always_populate_raw_post_data</parameter>
1233
-
to <literal>-1</literal> will opt into the new behaviour that will be
1234
-
implemented in a future version of PHP, in which
1235
-
<varname>$HTTP_RAW_POST_DATA</varname> is never defined.
1236
-
</para>
1237
-
<para>
1238
-
Regardless of the setting, <varname>$HTTP_RAW_POST_DATA</varname> is
1239
-
not available with <literal>enctype="multipart/form-data"</literal>.
1240
-
</para>
1241
-
</listitem>
1242
-
</varlistentry>
1243
-
1244
995
</variablelist>
1245
996
</para>
1246
-
<para>
1247
-
See also: <link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link>,
1248
-
<link linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link>,
1249
-
and
1250
-
<link linkend="ini.magic-quotes-sybase">magic_quotes_sybase</link>.
1251
-
</para>
1252
997
</section>
1253
998
1254
999
<section xml:id="ini.sect.path-directory">
...
...
@@ -1269,104 +1014,110 @@
1269
1014
<row>
1270
1015
<entry><link linkend="ini.include-path">include_path</link></entry>
1271
1016
<entry>".;/path/to/php/pear"</entry>
1272
-
<entry>PHP_INI_ALL</entry>
1017
+
<entry><constant>INI_ALL</constant></entry>
1273
1018
<entry></entry>
1274
1019
</row>
1275
1020
<row>
1276
1021
<entry><link linkend="ini.open-basedir">open_basedir</link></entry>
1277
1022
<entry>NULL</entry>
1278
-
<entry>PHP_INI_ALL</entry>
1279
-
<entry>PHP_INI_SYSTEM in PHP &lt; 5.3.0</entry>
1023
+
<entry><constant>INI_ALL</constant></entry>
1024
+
<entry></entry>
1280
1025
</row>
1281
1026
<row>
1282
1027
<entry><link linkend="ini.doc-root">doc_root</link></entry>
1283
1028
<entry>NULL</entry>
1284
-
<entry>PHP_INI_SYSTEM</entry>
1029
+
<entry><constant>INI_SYSTEM</constant></entry>
1285
1030
<entry></entry>
1286
1031
</row>
1287
1032
<row>
1288
1033
<entry><link linkend="ini.user-dir">user_dir</link></entry>
1289
1034
<entry>NULL</entry>
1290
-
<entry>PHP_INI_SYSTEM</entry>
1035
+
<entry><constant>INI_SYSTEM</constant></entry>
1291
1036
<entry></entry>
1292
1037
</row>
1293
1038
<row>
1294
-
<entry><link linkend="ini.extension-dir">extension_dir</link></entry>
1295
-
<entry>"/path/to/php"</entry>
1296
-
<entry>PHP_INI_SYSTEM</entry>
1039
+
<entry><link linkend="ini.user-ini.cache-ttl">user_ini.cache_ttl</link></entry>
1040
+
<entry>"300"</entry>
1041
+
<entry><constant>INI_SYSTEM</constant></entry>
1297
1042
<entry></entry>
1298
1043
</row>
1299
1044
<row>
1300
-
<entry><link linkend="ini.extension">extension</link></entry>
1301
-
<entry>NULL</entry>
1302
-
<entry>&php.ini; only</entry>
1045
+
<entry><link linkend="ini.user-ini.filename">user_ini.filename</link></entry>
1046
+
<entry>".user.ini"</entry>
1047
+
<entry><constant>INI_SYSTEM</constant></entry>
1303
1048
<entry></entry>
1304
1049
</row>
1305
1050
<row>
1306
-
<entry><link linkend="ini.zend-extension">zend_extension</link></entry>
1307
-
<entry>NULL</entry>
1308
-
<entry>&php.ini; only</entry>
1051
+
<entry><link linkend="ini.extension-dir">extension_dir</link></entry>
1052
+
<entry>"/path/to/php"</entry>
1053
+
<entry><constant>INI_SYSTEM</constant></entry>
1309
1054
<entry></entry>
1310
1055
</row>
1311
1056
<row>
1312
-
<entry><link linkend="ini.zend-extension-debug">zend_extension_debug</link></entry>
1313
-
<entry>NULL</entry>
1314
-
<entry>&php.ini; only</entry>
1315
-
<entry>Available before PHP 5.3.0.</entry>
1316
-
</row>
1317
-
<row>
1318
-
<entry><link linkend="ini.zend-extension-debug-ts">zend_extension_debug_ts</link></entry>
1057
+
<entry><link linkend="ini.extension">extension</link></entry>
1319
1058
<entry>NULL</entry>
1320
1059
<entry>&php.ini; only</entry>
1321
-
<entry>Available before PHP 5.3.0.</entry>
1060
+
<entry></entry>
1322
1061
</row>
1323
1062
<row>
1324
-
<entry><link linkend="ini.zend-extension-ts">zend_extension_ts</link></entry>
1063
+
<entry><link linkend="ini.zend-extension">zend_extension</link></entry>
1325
1064
<entry>NULL</entry>
1326
1065
<entry>&php.ini; only</entry>
1327
-
<entry>Available before PHP 5.3.0.</entry>
1066
+
<entry></entry>
1328
1067
</row>
1329
1068
<row>
1330
1069
<entry><link linkend="ini.cgi.check-shebang-line">cgi.check_shebang_line</link></entry>
1331
1070
<entry>"1"</entry>
1332
-
<entry>PHP_INI_SYSTEM</entry>
1333
-
<entry>Available since PHP 5.2.0.</entry>
1071
+
<entry><constant>INI_SYSTEM</constant></entry>
1072
+
<entry></entry>
1073
+
</row>
1074
+
<row>
1075
+
<entry><link linkend="ini.cgi.discard-path">cgi.discard_path</link></entry>
1076
+
<entry>"0"</entry>
1077
+
<entry><constant>INI_SYSTEM</constant></entry>
1078
+
<entry></entry>
1334
1079
</row>
1335
1080
<row>
1336
1081
<entry><link linkend="ini.cgi.fix-pathinfo">cgi.fix_pathinfo</link></entry>
1337
1082
<entry>"1"</entry>
1338
-
<entry>PHP_INI_SYSTEM</entry>
1339
-
<entry>Available since PHP 4.3.0. PHP_INI_ALL prior to PHP 5.2.1.</entry>
1083
+
<entry><constant>INI_SYSTEM</constant></entry>
1084
+
<entry></entry>
1340
1085
</row>
1341
1086
<row>
1342
1087
<entry><link linkend="ini.cgi.force-redirect">cgi.force_redirect</link></entry>
1343
1088
<entry>"1"</entry>
1344
-
<entry>PHP_INI_SYSTEM</entry>
1345
-
<entry>Available since PHP 4.2.0. PHP_INI_ALL prior to PHP 5.2.1.</entry>
1089
+
<entry><constant>INI_SYSTEM</constant></entry>
1090
+
<entry></entry>
1091
+
</row>
1092
+
<row>
1093
+
<entry><link linkend="ini.cgi.nph">cgi.nph</link></entry>
1094
+
<entry>"0"</entry>
1095
+
<entry><constant>INI_SYSTEM</constant></entry>
1096
+
<entry></entry>
1346
1097
</row>
1347
1098
<row>
1348
1099
<entry><link linkend="ini.cgi.redirect-status-env">cgi.redirect_status_env</link></entry>
1349
1100
<entry>NULL</entry>
1350
-
<entry>PHP_INI_SYSTEM</entry>
1351
-
<entry>Available since PHP 4.2.0. PHP_INI_ALL prior to PHP 5.2.1.</entry>
1101
+
<entry><constant>INI_SYSTEM</constant></entry>
1102
+
<entry></entry>
1352
1103
</row>
1353
1104
<row>
1354
1105
<entry><link linkend="ini.cgi.rfc2616-headers">cgi.rfc2616_headers</link></entry>
1355
1106
<entry>"0"</entry>
1356
-
<entry>PHP_INI_ALL</entry>
1357
-
<entry>Available since PHP 4.3.0.</entry>
1107
+
<entry><constant>INI_ALL</constant></entry>
1108
+
<entry></entry>
1358
1109
</row>
1359
1110
<row>
1360
1111
<entry><link linkend="ini.fastcgi.impersonate">fastcgi.impersonate</link></entry>
1361
1112
<entry>"0"</entry>
1362
-
<entry>PHP_INI_SYSTEM</entry>
1363
-
<entry>Available since PHP 4.3.0. PHP_INI_ALL prior to PHP 5.2.1.</entry>
1113
+
<entry><constant>INI_SYSTEM</constant></entry>
1114
+
<entry></entry>
1364
1115
</row>
1365
1116
<row>
1366
1117
<entry><link linkend="ini.fastcgi.logging">fastcgi.logging</link></entry>
1367
1118
<entry>"1"</entry>
1368
-
<entry>PHP_INI_SYSTEM</entry>
1369
-
<entry>Available since PHP 4.3.0. PHP_INI_ALL prior to PHP 5.2.1.</entry>
1119
+
<entry><constant>INI_SYSTEM</constant></entry>
1120
+
<entry></entry>
1370
1121
</row>
1371
1122
</tbody>
1372
1123
</tgroup>
...
...
@@ -1396,9 +1147,9 @@
1396
1147
PHP considers each entry in the include path separately when looking for
1397
1148
files to include. It will check the first path, and if it doesn't find
1398
1149
it, check the next path, until it either locates the included file or
1399
-
returns with a
1400
-
<link linkend="errorfunc.constants.errorlevels.e-warning">warning</link>
1401
-
or an <link linkend="errorfunc.constants.errorlevels.e-error">error</link>.
1150
+
returns with an
1151
+
<constant>E_WARNING</constant>
1152
+
or an <constant>E_ERROR</constant>.
1402
1153
You may modify or set your include path at runtime using
1403
1154
<function>set_include_path</function>.
1404
1155
</para>
...
...
@@ -1461,9 +1212,7 @@ include_path = ".:${USER}/pear/php"
1461
1212
<listitem>
1462
1213
<para>
1463
1214
Limit the files that can be accessed by PHP to the specified
1464
-
directory-tree, including the file itself. This directive
1465
-
is <emphasis>NOT</emphasis> affected by whether Safe Mode is
1466
-
turned On or Off.
1215
+
directory-tree, including the file itself.
1467
1216
</para>
1468
1217
<para>
1469
1218
When a script tries to access the filesystem, for example using
...
...
@@ -1501,19 +1250,14 @@ include_path = ".:${USER}/pear/php"
1501
1250
</para>
1502
1251
<para>
1503
1252
The restriction specified with <option>open_basedir</option> is a
1504
-
directory name since PHP 5.2.16 and 5.3.4. Previous versions used it
1505
-
as a prefix. This means that "<literal>open_basedir
1506
-
= /dir/incl</literal>" also allowed access to "<literal>/dir/include</literal>" and
1507
-
"<literal>/dir/incls</literal>" if they exist. When you want to restrict access
1508
-
to only the specified directory, end with a slash. For example:
1509
-
<literal>open_basedir = /dir/incl/</literal>
1253
+
directory name, not a prefix.
1510
1254
</para>
1511
1255
<para>
1512
1256
The default is to allow all files to be opened.
1513
1257
</para>
1514
1258
<note>
1515
1259
<para>
1516
-
As of PHP 5.3.0 open_basedir can be tightened at run-time. This means
1260
+
open_basedir can be tightened at run-time. This means
1517
1261
that if open_basedir is set to <literal>/www/</literal> in &php.ini;
1518
1262
a script can tighten the configuration to
1519
1263
<literal>/www/tmp/</literal> at run-time with
...
...
@@ -1522,6 +1266,18 @@ include_path = ".:${USER}/pear/php"
1522
1266
regardless of the operating system.
1523
1267
</para>
1524
1268
</note>
1269
+
<note>
1270
+
<para>
1271
+
Using open_basedir will set <link linkend="ini.realpath-cache-size">realpath_cache_size</link>
1272
+
to <literal>0</literal> and thus <emphasis>disable</emphasis> the realpath cache.
1273
+
</para>
1274
+
</note>
1275
+
<caution>
1276
+
<para>
1277
+
<literal>open_basedir</literal> is just an extra safety net, that is in no way
1278
+
comprehensive, and can therefore not be relied upon when security is needed.
1279
+
</para>
1280
+
</caution>
1525
1281
</listitem>
1526
1282
</varlistentry>
1527
1283
...
...
@@ -1533,8 +1289,7 @@ include_path = ".:${USER}/pear/php"
1533
1289
<listitem>
1534
1290
<para>
1535
1291
PHP's "root directory" on the server. Only used if
1536
-
non-empty. If PHP is configured with &safemode;, no files outside
1537
-
this directory are served.
1292
+
non-empty.
1538
1293
If PHP was not compiled with FORCE_REDIRECT, you <emphasis>should
1539
1294
</emphasis> set doc_root if you are running PHP as a CGI under any web
1540
1295
server (other than IIS). The alternative is to use the
...
...
@@ -1544,95 +1299,77 @@ include_path = ".:${USER}/pear/php"
1544
1299
</listitem>
1545
1300
</varlistentry>
1546
1301
1547
-
<varlistentry xml:id="ini.user-dir">
1302
+
<varlistentry xml:id="ini.user-ini.cache-ttl">
1548
1303
<term>
1549
-
<parameter>user_dir</parameter>
1550
-
<type>string</type>
1551
-
</term>
1552
-
<listitem>
1553
-
<para>
1554
-
The base name of the directory used on a user's home directory for PHP
1555
-
files, for example <filename class="directory">public_html
1556
-
</filename>.
1557
-
</para>
1558
-
</listitem>
1559
-
</varlistentry>
1560
-
1561
-
<varlistentry xml:id="ini.extension-dir">
1562
-
<term>
1563
-
<parameter>extension_dir</parameter>
1564
-
<type>string</type>
1304
+
<parameter>user_ini.cache_ttl</parameter>
1305
+
<type>int</type>
1565
1306
</term>
1566
1307
<listitem>
1567
1308
<para>
1568
-
In what directory PHP should look for dynamically loadable
1569
-
extensions. See also: <link linkend="ini.enable-dl">enable_dl</link>,
1570
-
and <function>dl</function>.
1571
1309
</para>
1572
1310
</listitem>
1573
1311
</varlistentry>
1574
1312
1575
-
<varlistentry xml:id="ini.extension">
1313
+
<varlistentry xml:id="ini.user-ini.filename">
1576
1314
<term>
1577
-
<parameter>extension</parameter>
1315
+
<parameter>user_ini.filename</parameter>
1578
1316
<type>string</type>
1579
1317
</term>
1580
1318
<listitem>
1581
1319
<para>
1582
-
Which dynamically loadable extensions to load when PHP starts up.
1583
1320
</para>
1584
1321
</listitem>
1585
1322
</varlistentry>
1586
1323
1587
-
<varlistentry xml:id="ini.zend-extension">
1324
+
<varlistentry xml:id="ini.user-dir">
1588
1325
<term>
1589
-
<parameter>zend_extension</parameter>
1326
+
<parameter>user_dir</parameter>
1590
1327
<type>string</type>
1591
1328
</term>
1592
1329
<listitem>
1593
1330
<para>
1594
-
Name of dynamically loadable Zend extension (for example
1595
-
<link linkend="book.apd">APD</link>) to load when PHP starts up.
1331
+
The base name of the directory used on a user's home directory for PHP
1332
+
files, for example <filename class="directory">public_html
1333
+
</filename>.
1596
1334
</para>
1597
1335
</listitem>
1598
1336
</varlistentry>
1599
1337
1600
-
<varlistentry xml:id="ini.zend-extension-debug">
1338
+
<varlistentry xml:id="ini.extension-dir">
1601
1339
<term>
1602
-
<parameter>zend_extension_debug</parameter>
1340
+
<parameter>extension_dir</parameter>
1603
1341
<type>string</type>
1604
1342
</term>
1605
1343
<listitem>
1606
1344
<para>
1607
-
Variant of <link linkend="ini.zend-extension">zend_extension</link>
1608
-
for extensions compiled with debug info prior to PHP 5.3.0.
1345
+
In what directory PHP should look for dynamically loadable
1346
+
extensions. It is recommended to specify an absolute path. See also: <link linkend="ini.enable-dl">enable_dl</link>,
1347
+
and <function>dl</function>.
1609
1348
</para>
1610
1349
</listitem>
1611
1350
</varlistentry>
1612
1351
1613
-
<varlistentry xml:id="ini.zend-extension-debug-ts">
1352
+
<varlistentry xml:id="ini.extension">
1614
1353
<term>
1615
-
<parameter>zend_extension_debug_ts</parameter>
1354
+
<parameter>extension</parameter>
1616
1355
<type>string</type>
1617
1356
</term>
1618
1357
<listitem>
1619
1358
<para>
1620
-
Variant of <link linkend="ini.zend-extension">zend_extension</link>
1621
-
for extensions compiled with debug info and thread safety prior to PHP
1622
-
5.3.0.
1359
+
Which dynamically loadable extensions to load when PHP starts up.
1623
1360
</para>
1624
1361
</listitem>
1625
1362
</varlistentry>
1626
1363
1627
-
<varlistentry xml:id="ini.zend-extension-ts">
1364
+
<varlistentry xml:id="ini.zend-extension">
1628
1365
<term>
1629
-
<parameter>zend_extension_ts</parameter>
1366
+
<parameter>zend_extension</parameter>
1630
1367
<type>string</type>
1631
1368
</term>
1632
1369
<listitem>
1633
1370
<para>
1634
-
Variant of <link linkend="ini.zend-extension">zend_extension</link>
1635
-
for extensions compiled with thread safety prior to PHP 5.3.0.
1371
+
Name of dynamically loadable Zend extension (for example
1372
+
XDebug) to load when PHP starts up.
1636
1373
</para>
1637
1374
</listitem>
1638
1375
</varlistentry>
...
...
@@ -1640,7 +1377,7 @@ include_path = ".:${USER}/pear/php"
1640
1377
<varlistentry xml:id="ini.cgi.check-shebang-line">
1641
1378
<term>
1642
1379
<parameter>cgi.check_shebang_line</parameter>
1643
-
<type>boolean</type>
1380
+
<type>bool</type>
1644
1381
</term>
1645
1382
<listitem>
1646
1383
<para>
...
...
@@ -1654,10 +1391,23 @@ include_path = ".:${USER}/pear/php"
1654
1391
</listitem>
1655
1392
</varlistentry>
1656
1393
1394
+
<varlistentry xml:id="ini.cgi.discard-path">
1395
+
<term>
1396
+
<parameter>cgi.discard_path</parameter>
1397
+
<type>bool</type>
1398
+
</term>
1399
+
<listitem>
1400
+
<para>
1401
+
If this is enabled, the PHP CGI binary can safely be placed outside of
1402
+
the web tree and people will not be able to circumvent .htaccess security.
1403
+
</para>
1404
+
</listitem>
1405
+
</varlistentry>
1406
+
1657
1407
<varlistentry xml:id="ini.cgi.fix-pathinfo">
1658
1408
<term>
1659
1409
<parameter>cgi.fix_pathinfo</parameter>
1660
-
<type>boolean</type>
1410
+
<type>bool</type>
1661
1411
</term>
1662
1412
<listitem>
1663
1413
<para>
...
...
@@ -1680,7 +1430,7 @@ include_path = ".:${USER}/pear/php"
1680
1430
<varlistentry xml:id="ini.cgi.force-redirect">
1681
1431
<term>
1682
1432
<parameter>cgi.force_redirect</parameter>
1683
-
<type>boolean</type>
1433
+
<type>bool</type>
1684
1434
</term>
1685
1435
<listitem>
1686
1436
<para>
...
...
@@ -1698,6 +1448,19 @@ include_path = ".:${USER}/pear/php"
1698
1448
</listitem>
1699
1449
</varlistentry>
1700
1450
1451
+
<varlistentry xml:id="ini.cgi.nph">
1452
+
<term>
1453
+
<parameter>cgi.nph</parameter>
1454
+
<type>bool</type>
1455
+
</term>
1456
+
<listitem>
1457
+
<para>
1458
+
If cgi.nph is enabled it will force cgi to always sent Status: 200 with
1459
+
every request.
1460
+
</para>
1461
+
</listitem>
1462
+
</varlistentry>
1463
+
1701
1464
<varlistentry xml:id="ini.cgi.redirect-status-env">
1702
1465
<term>
1703
1466
<parameter>cgi.redirect_status_env</parameter>
...
...
@@ -1763,7 +1526,7 @@ include_path = ".:${USER}/pear/php"
1763
1526
<varlistentry xml:id="ini.fastcgi.logging">
1764
1527
<term>
1765
1528
<parameter>fastcgi.logging</parameter>
1766
-
<type>boolean</type>
1529
+
<type>bool</type>
1767
1530
</term>
1768
1531
<listitem>
1769
1532
<para>
...
...
@@ -1795,38 +1558,38 @@ include_path = ".:${USER}/pear/php"
1795
1558
<row>
1796
1559
<entry><link linkend="ini.file-uploads">file_uploads</link></entry>
1797
1560
<entry>"1"</entry>
1798
-
<entry>PHP_INI_SYSTEM</entry>
1799
-
<entry>PHP_INI_ALL in PHP &lt;= 4.2.3. Available since PHP 4.0.3.</entry>
1561
+
<entry><constant>INI_SYSTEM</constant></entry>
1562
+
<entry></entry>
1800
1563
</row>
1801
1564
<row>
1802
1565
<entry><link linkend="ini.upload-tmp-dir">upload_tmp_dir</link></entry>
1803
1566
<entry>NULL</entry>
1804
-
<entry>PHP_INI_SYSTEM</entry>
1567
+
<entry><constant>INI_SYSTEM</constant></entry>
1805
1568
<entry></entry>
1806
1569
</row>
1807
1570
<row>
1808
1571
<entry><link linkend="ini.max-input-nesting-level">max_input_nesting_level</link></entry>
1809
1572
<entry>64</entry>
1810
-
<entry>PHP_INI_PERDIR</entry>
1811
-
<entry>Available since PHP 5.3.9.</entry>
1573
+
<entry><constant>INI_PERDIR</constant></entry>
1574
+
<entry></entry>
1812
1575
</row>
1813
1576
<row>
1814
1577
<entry><link linkend="ini.max-input-vars">max_input_vars</link></entry>
1815
1578
<entry>1000</entry>
1816
-
<entry>PHP_INI_PERDIR</entry>
1817
-
<entry>Available since PHP 5.3.9.</entry>
1579
+
<entry><constant>INI_PERDIR</constant></entry>
1580
+
<entry></entry>
1818
1581
</row>
1819
1582
<row>
1820
1583
<entry><link linkend="ini.upload-max-filesize">upload_max_filesize</link></entry>
1821
1584
<entry>"2M"</entry>
1822
-
<entry>PHP_INI_PERDIR</entry>
1823
-
<entry>PHP_INI_ALL in PHP &lt;= 4.2.3.</entry>
1585
+
<entry><constant>INI_PERDIR</constant></entry>
1586
+
<entry></entry>
1824
1587
</row>
1825
1588
<row>
1826
1589
<entry><link linkend="ini.max-file-uploads">max_file_uploads</link></entry>
1827
1590
<entry>20</entry>
1828
-
<entry>PHP_INI_SYSTEM</entry>
1829
-
<entry>Available since PHP 5.2.12.</entry>
1591
+
<entry><constant>INI_PERDIR</constant></entry>
1592
+
<entry></entry>
1830
1593
</row>
1831
1594
</tbody>
1832
1595
</tgroup>
...
...
@@ -1840,7 +1603,7 @@ include_path = ".:${USER}/pear/php"
1840
1603
<varlistentry xml:id="ini.file-uploads">
1841
1604
<term>
1842
1605
<parameter>file_uploads</parameter>
1843
-
<type>boolean</type>
1606
+
<type>bool</type>
1844
1607
</term>
1845
1608
<listitem>
1846
1609
<para>
...
...
@@ -1877,12 +1640,15 @@ include_path = ".:${USER}/pear/php"
1877
1640
<varlistentry xml:id="ini.upload-max-filesize">
1878
1641
<term>
1879
1642
<parameter>upload_max_filesize</parameter>
1880
-
<type>integer</type>
1643
+
<type>int</type>
1881
1644
</term>
1882
1645
<listitem>
1883
1646
<para>
1884
1647
The maximum size of an uploaded file.
1885
1648
</para>
1649
+
<para>
1650
+
<link linkend="ini.post-max-size">post_max_size</link> must be larger than this value.
1651
+
</para>
1886
1652
1887
1653
&ini.shorthandbytes;
1888
1654
...
...
@@ -1892,12 +1658,12 @@ include_path = ".:${USER}/pear/php"
1892
1658
<varlistentry xml:id="ini.max-file-uploads">
1893
1659
<term>
1894
1660
<parameter>max_file_uploads</parameter>
1895
-
<type>integer</type>
1661
+
<type>int</type>
1896
1662
</term>
1897
1663
<listitem>
1898
1664
<para>
1899
1665
The maximum number of files allowed to be uploaded simultaneously.
1900
-
Starting with PHP 5.3.4, upload fields left blank on submission do not
1666
+
Upload fields left blank on submission do not
1901
1667
count towards this limit.
1902
1668
</para>
1903
1669
</listitem>
...
...
@@ -1924,8 +1690,8 @@ include_path = ".:${USER}/pear/php"
1924
1690
<row>
1925
1691
<entry><link linkend="ini.sql.safe-mode">sql.safe_mode</link></entry>
1926
1692
<entry>"0"</entry>
1927
-
<entry>PHP_INI_SYSTEM</entry>
1928
-
<entry></entry>
1693
+
<entry><constant>INI_SYSTEM</constant></entry>
1694
+
<entry>Removed as of PHP 7.2.0</entry>
1929
1695
</row>
1930
1696
</tbody>
1931
1697
</tgroup>
...
...
@@ -1939,7 +1705,7 @@ include_path = ".:${USER}/pear/php"
1939
1705
<varlistentry xml:id="ini.sql.safe-mode">
1940
1706
<term>
1941
1707
<parameter>sql.safe_mode</parameter>
1942
-
<type>boolean</type>
1708
+
<type>bool</type>
1943
1709
</term>
1944
1710
<listitem>
1945
1711
<para>
...
...
@@ -1948,6 +1714,11 @@ include_path = ".:${USER}/pear/php"
1948
1714
on the default values, see the documentation for the relevant connection
1949
1715
functions.
1950
1716
</para>
1717
+
<warning>
1718
+
<simpara>
1719
+
This feature has been <emphasis>REMOVED</emphasis> as of PHP 7.2.0.
1720
+
</simpara>
1721
+
</warning>
1951
1722
</listitem>
1952
1723
</varlistentry>
1953
1724
</variablelist>
...
...
@@ -1970,10 +1741,10 @@ include_path = ".:${USER}/pear/php"
1970
1741
</thead>
1971
1742
<tbody>
1972
1743
<row>
1973
-
<entry><link linkend="ini.windows-show-crt-warning">windows_show_crt_warning</link></entry>
1744
+
<entry><link linkend="ini.windows-show-crt-warning">windows.show_crt_warning</link></entry>
1974
1745
<entry>"0"</entry>
1975
-
<entry>PHP_INI_ALL</entry>
1976
-
<entry>Available since PHP 5.4.0.</entry>
1746
+
<entry><constant>INI_ALL</constant></entry>
1747
+
<entry></entry>
1977
1748
</row>
1978
1749
</tbody>
1979
1750
</tgroup>
...
...
@@ -1986,13 +1757,12 @@ include_path = ".:${USER}/pear/php"
1986
1757
<variablelist>
1987
1758
<varlistentry xml:id="ini.windows-show-crt-warning">
1988
1759
<term>
1989
-
<parameter>windows_show_crt_warning</parameter>
1990
-
<type>boolean</type>
1760
+
<parameter>windows.show_crt_warning</parameter>
1761
+
<type>bool</type>
1991
1762
</term>
1992
1763
<listitem>
1993
1764
<para>
1994
-
This directive shows the Windows CRT warnings when enabled. These
1995
-
warnings were displayed by default until PHP 5.4.0.
1765
+
This directive shows the Windows CRT warnings when enabled.
1996
1766
</para>
1997
1767
</listitem>
1998
1768
</varlistentry>
1999
1769