appendices/ini.core.xml
a1ab750f296de54d79fe3749d5c9164b0593d803
a1ab750f296de54d79fe3749d5c9164b0593d803
...
...
@@ -33,46 +33,27 @@
33
33
<row>
34
34
<entry><link linkend="ini.short-open-tag">short_open_tag</link></entry>
35
35
<entry>"1"</entry>
36
-
<entry>PHP_INI_PERDIR</entry>
36
+
<entry><constant>INI_PERDIR</constant></entry>
37
37
<entry></entry>
38
38
</row>
39
-
<row>
40
-
<entry><link linkend="ini.asp-tags">asp_tags</link></entry>
41
-
<entry>"0"</entry>
42
-
<entry>PHP_INI_PERDIR</entry>
43
-
<entry>Removed in PHP 7.0.0.</entry>
44
-
</row>
45
39
<row>
46
40
<entry><link linkend="ini.precision">precision</link></entry>
47
41
<entry>"14"</entry>
48
-
<entry>PHP_INI_ALL</entry>
42
+
<entry><constant>INI_ALL</constant></entry>
49
43
<entry></entry>
50
44
</row>
51
45
<row>
52
46
<entry><link linkend="ini.serialize-precision">serialize_precision</link></entry>
53
47
<entry>"-1"</entry>
54
-
<entry>PHP_INI_ALL</entry>
48
+
<entry><constant>INI_ALL</constant></entry>
55
49
<entry>
56
-
Before PHP 5.3.6, the default value was 100.
57
-
Before PHP 7.1.0, the default value was 17.
50
+
Prior to PHP 7.1.0, the default value was 17.
58
51
</entry>
59
52
</row>
60
-
<row>
61
-
<entry><link linkend="ini.y2k-compliance">y2k_compliance</link></entry>
62
-
<entry>"1"</entry>
63
-
<entry>PHP_INI_ALL</entry>
64
-
<entry>Removed in PHP 5.4.0.</entry>
65
-
</row>
66
-
<row>
67
-
<entry><link linkend="ini.allow-call-time-pass-reference">allow_call_time_pass_reference</link></entry>
68
-
<entry>"1"</entry>
69
-
<entry>PHP_INI_PERDIR</entry>
70
-
<entry>Removed in PHP 5.4.0.</entry>
71
-
</row>
72
53
<row>
73
54
<entry><link linkend="ini.disable-functions">disable_functions</link></entry>
74
55
<entry>""</entry>
75
-
<entry>PHP_INI_SYSTEM only</entry>
56
+
<entry><constant>INI_SYSTEM</constant> only</entry>
76
57
<entry></entry>
77
58
</row>
78
59
<row>
...
...
@@ -84,8 +65,8 @@
84
65
<row>
85
66
<entry><link linkend="ini.exit-on-timeout">exit_on_timeout</link></entry>
86
67
<entry>""</entry>
87
-
<entry>PHP_INI_ALL</entry>
88
-
<entry>Available since PHP 5.3.0.</entry>
68
+
<entry><constant>INI_ALL</constant></entry>
69
+
<entry></entry>
89
70
</row>
90
71
<row>
91
72
<entry><link linkend="ini.expose-php">expose_php</link></entry>
...
...
@@ -96,56 +77,50 @@
96
77
<row>
97
78
<entry><link linkend="ini.hard-timeout">hard_timeout</link></entry>
98
79
<entry>"2"</entry>
99
-
<entry>PHP_INI_SYSTEM</entry>
100
-
<entry>Available since PHP 7.1.0.</entry>
80
+
<entry><constant>INI_SYSTEM</constant></entry>
81
+
<entry>Available as of PHP 7.1.0.</entry>
101
82
</row>
102
83
<row>
103
84
<entry><link linkend="ini.zend.exception-ignore-args">zend.exception_ignore_args</link></entry>
104
85
<entry>"0"</entry>
105
-
<entry>PHP_INI_ALL</entry>
106
-
<entry>Available since PHP 7.4.0</entry>
86
+
<entry><constant>INI_ALL</constant></entry>
87
+
<entry>Available as of PHP 7.4.0</entry>
107
88
</row>
108
89
<row>
109
90
<entry><link linkend="ini.zend.multibyte">zend.multibyte</link></entry>
110
91
<entry>"0"</entry>
111
-
<entry>PHP_INI_ALL</entry>
112
-
<entry>Available since PHP 5.4.0</entry>
92
+
<entry><constant>INI_ALL</constant></entry>
93
+
<entry></entry>
113
94
</row>
114
95
<row>
115
96
<entry><link linkend="ini.zend.script-encoding">zend.script_encoding</link></entry>
116
97
<entry>NULL</entry>
117
-
<entry>PHP_INI_ALL</entry>
118
-
<entry>Available since PHP 5.4.0</entry>
98
+
<entry><constant>INI_ALL</constant></entry>
99
+
<entry></entry>
119
100
</row>
120
101
<row>
121
-
<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>
122
103
<entry>NULL</entry>
123
-
<entry>PHP_INI_ALL</entry>
124
-
<entry>Available since PHP 5.4.0</entry>
104
+
<entry><constant>INI_ALL</constant></entry>
105
+
<entry></entry>
125
106
</row>
126
107
<row>
127
108
<entry><link linkend="ini.zend.signal-check">zend.signal_check</link></entry>
128
109
<entry>"0"</entry>
129
-
<entry>PHP_INI_SYSTEM</entry>
130
-
<entry>Available since PHP 5.4.0</entry>
110
+
<entry><constant>INI_SYSTEM</constant></entry>
111
+
<entry></entry>
131
112
</row>
132
113
<row>
133
114
<entry><link linkend="ini.zend.assertions">zend.assertions</link></entry>
134
115
<entry>"1"</entry>
135
-
<entry>PHP_INI_ALL with restrictions</entry>
136
-
<entry>Available since PHP 7.0.0.</entry>
116
+
<entry><constant>INI_ALL</constant> with restrictions</entry>
117
+
<entry></entry>
137
118
</row>
138
119
<row>
139
-
<entry><link linkend="ini.zend.ze1-compatibility-mode">zend.ze1_compatibility_mode</link></entry>
140
-
<entry>"0"</entry>
141
-
<entry>PHP_INI_ALL</entry>
142
-
<entry>Removed in PHP 5.3.0</entry>
143
-
</row>
144
-
<row>
145
-
<entry>detect_unicode</entry>
146
-
<entry>"1"</entry>
147
-
<entry>PHP_INI_ALL</entry>
148
-
<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>
149
124
</row>
150
125
</tbody>
151
126
</tgroup>
...
...
@@ -159,7 +134,7 @@
159
134
<varlistentry xml:id="ini.short-open-tag">
160
135
<term>
161
136
<parameter>short_open_tag</parameter>
162
-
<type>boolean</type>
137
+
<type>bool</type>
163
138
</term>
164
139
<listitem>
165
140
<para>
...
...
@@ -173,58 +148,17 @@
173
148
</para>
174
149
<note>
175
150
<para>
176
-
This directive also affected the shorthand
177
-
<userinput><?=</userinput> before PHP 5.4.0,
178
-
which is identical to <userinput><? echo</userinput>. Use of this
179
-
shortcut required <systemitem role="directive">short_open_tag</systemitem>
180
-
to be on.
181
-
Since PHP 5.4.0, <userinput><?=</userinput> is always available.
151
+
This directive does not affect the shorthand
152
+
<userinput><?=</userinput>, which is always available.
182
153
</para>
183
154
</note>
184
155
</listitem>
185
156
</varlistentry>
186
157
187
-
<varlistentry xml:id="ini.asp-tags">
188
-
<term>
189
-
<parameter>asp_tags</parameter>
190
-
<type>boolean</type>
191
-
</term>
192
-
<listitem>
193
-
<simpara>
194
-
Enables the use of ASP-like <% %> tags in addition to
195
-
the usual <?php ?> tags. This includes the
196
-
variable-value printing shorthand of <%= $value %>. For
197
-
more information, see <link
198
-
linkend="language.basic-syntax.phpmode">Escaping from HTML</link>.
199
-
</simpara>
200
-
<para>
201
-
<table>
202
-
<title>Changelog for <literal>asp_tags</literal></title>
203
-
<tgroup cols="2">
204
-
<thead>
205
-
<row>
206
-
<entry>&Version;</entry>
207
-
<entry>&Description;</entry>
208
-
</row>
209
-
</thead>
210
-
<tbody>
211
-
<row>
212
-
<entry>7.0.0</entry>
213
-
<entry>
214
-
Removed from PHP.
215
-
</entry>
216
-
</row>
217
-
</tbody>
218
-
</tgroup>
219
-
</table>
220
-
</para>
221
-
</listitem>
222
-
</varlistentry>
223
-
224
158
<varlistentry xml:id="ini.precision">
225
159
<term>
226
160
<parameter>precision</parameter>
227
-
<type>integer</type>
161
+
<type>int</type>
228
162
</term>
229
163
<listitem>
230
164
<simpara>
...
...
@@ -238,7 +172,7 @@
238
172
<varlistentry xml:id="ini.serialize-precision">
239
173
<term>
240
174
<parameter>serialize_precision</parameter>
241
-
<type>integer</type>
175
+
<type>int</type>
242
176
</term>
243
177
<listitem>
244
178
<simpara>
...
...
@@ -249,105 +183,15 @@
249
183
</listitem>
250
184
</varlistentry>
251
185
252
-
<varlistentry xml:id="ini.y2k-compliance">
253
-
<term>
254
-
<parameter>y2k_compliance</parameter>
255
-
<type>boolean</type>
256
-
</term>
257
-
<listitem>
258
-
<simpara>
259
-
Enforce year 2000 compliance (will cause problems with non-compliant browsers)
260
-
</simpara>
261
-
</listitem>
262
-
</varlistentry>
263
-
264
-
265
-
<varlistentry xml:id="ini.allow-call-time-pass-reference">
266
-
<term>
267
-
<parameter>allow_call_time_pass_reference</parameter>
268
-
<type>boolean</type>
269
-
</term>
270
-
<listitem>
271
-
<para>
272
-
Whether to warn when arguments are passed by reference at function call time.
273
-
The encouraged method of specifying which arguments should be passed by
274
-
reference is in the function declaration. You're encouraged to try and turn
275
-
this option Off and make sure your scripts work properly with it in order to
276
-
ensure they will work with future versions of the language (you will receive
277
-
a warning each time you use this feature).
278
-
</para>
279
-
<para>
280
-
Passing arguments by reference at function call time was deprecated for
281
-
code-cleanliness reasons. A function can modify its arguments in an
282
-
undocumented way if it didn't declare that the argument shall be passed by
283
-
reference. To prevent side-effects it's better to specify which
284
-
arguments are passed by reference in the function declaration only.
285
-
</para>
286
-
<para>
287
-
See also <link linkend="language.references">References Explained</link>.
288
-
</para>
289
-
<para>
290
-
<table>
291
-
<title>Changelog for <literal>allow_call_time_pass_reference</literal></title>
292
-
<tgroup cols="2">
293
-
<thead>
294
-
<row>
295
-
<entry>&Version;</entry>
296
-
<entry>&Description;</entry>
297
-
</row>
298
-
</thead>
299
-
<tbody>
300
-
<row>
301
-
<entry>5.4.0</entry>
302
-
<entry>
303
-
Removed from PHP.
304
-
</entry>
305
-
</row>
306
-
<row>
307
-
<entry>5.3.0</entry>
308
-
<entry>
309
-
Emits an <constant>E_DEPRECATED</constant> level error.
310
-
</entry>
311
-
</row>
312
-
<row>
313
-
<entry>5.0.0</entry>
314
-
<entry>
315
-
Deprecated, and generates an <constant>E_COMPILE_WARNING</constant> level error.
316
-
</entry>
317
-
</row>
318
-
</tbody>
319
-
</tgroup>
320
-
</table>
321
-
</para>
322
-
</listitem>
323
-
</varlistentry>
324
-
325
186
<varlistentry xml:id="ini.expose-php">
326
187
<term>
327
188
<parameter>expose_php</parameter>
328
-
<type>boolean</type>
189
+
<type>bool</type>
329
190
</term>
330
191
<listitem>
331
192
<para>
332
193
Exposes to the world that PHP is installed on the server, which includes the
333
194
PHP version within the HTTP header (e.g., X-Powered-By: PHP/5.3.7).
334
-
Prior to PHP 5.5.0 the PHP logo guids are also exposed, thus appending them
335
-
to the URL of your PHP script would display the appropriate logo
336
-
(e.g., <link xlink:href="&url.php;?=PHPE9568F34-D428-11d2-A769-00AA001ACF42">&url.php;?=PHPE9568F34-D428-11d2-A769-00AA001ACF42</link>).
337
-
This also affected the output of <function>phpinfo</function>, as when disabled, the PHP logo
338
-
and credits information would not be displayed.
339
-
</para>
340
-
<note>
341
-
<para>
342
-
Since PHP 5.5.0 these guids and the <function>php_logo_guid</function> function
343
-
have been removed from PHP and the guids are replaced with data URIs instead.
344
-
Thus accessing the PHP logo via appending the guid to the URL no longer works.
345
-
Similarly, turning <parameter>expose_php</parameter> off will not affect
346
-
seeing the PHP logo in <function>phpinfo</function>.
347
-
</para>
348
-
</note>
349
-
<para>
350
-
See also <function>php_logo_guid</function> and <function>phpcredits</function>.
351
195
</para>
352
196
</listitem>
353
197
</varlistentry>
...
...
@@ -358,19 +202,24 @@
358
202
<type>string</type>
359
203
</term>
360
204
<listitem>
361
-
<para>
362
-
This directive allows you to disable certain functions. It takes
363
-
on a comma-delimited list of function names.
364
-
</para>
365
-
<para>
205
+
<simpara>
206
+
This directive allows certain functions to be disabled.
207
+
It takes a comma-delimited list of function names.
208
+
As of PHP 8.0.0, disabling a function removes its definition,
209
+
allowing userland to redefine it.
210
+
Prior to PHP 8.0.0, disabling a function just prevented the function
211
+
from being invoked.
212
+
</simpara>
213
+
<simpara>
366
214
Only <link linkend="functions.internal">internal functions</link> can
367
-
be disabled using this directive. <link linkend="functions.user-defined">User-defined functions</link>
215
+
be disabled using this directive.
216
+
<link linkend="functions.user-defined">User-defined functions</link>
368
217
are unaffected.
369
-
</para>
370
-
<para>
371
-
This directive must be set in &php.ini; For example, you
372
-
cannot set this in &httpd.conf;.
373
-
</para>
218
+
</simpara>
219
+
<simpara>
220
+
This directive must be set in &php.ini;.
221
+
It cannot be set in &httpd.conf;.
222
+
</simpara>
374
223
</listitem>
375
224
</varlistentry>
376
225
...
...
@@ -380,13 +229,18 @@
380
229
<type>string</type>
381
230
</term>
382
231
<listitem>
232
+
<para>
233
+
This directive allows certain classes to be disabled.
234
+
It takes a comma-delimited list of class names.
235
+
Disabling a class just prevents the class's instantiation.
236
+
</para>
237
+
<para>
238
+
Only internal classes can be disabled using this directive.
239
+
User-defined classes are unaffected.
240
+
</para>
383
241
<simpara>
384
-
This directive allows you to disable certain classes. It takes
385
-
on a comma-delimited list of class names.
386
-
</simpara>
387
-
<simpara>
388
-
This directive must be set in &php.ini; For example, you
389
-
cannot set this in &httpd.conf;.
242
+
This directive must be set in &php.ini;.
243
+
It cannot be set in &httpd.conf;.
390
244
</simpara>
391
245
</listitem>
392
246
</varlistentry>
...
...
@@ -394,7 +248,7 @@
394
248
<varlistentry xml:id="ini.zend.assertions">
395
249
<term>
396
250
<parameter>zend.assertions</parameter>
397
-
<type>integer</type>
251
+
<type>int</type>
398
252
</term>
399
253
<listitem>
400
254
<simpara>
...
...
@@ -417,38 +271,39 @@
417
271
</listitem>
418
272
</varlistentry>
419
273
420
-
<varlistentry xml:id="ini.zend.ze1-compatibility-mode">
274
+
<varlistentry xml:id="ini.zend.exception-string-param-max-len">
421
275
<term>
422
-
<parameter>zend.ze1_compatibility_mode</parameter>
423
-
<type>boolean</type>
276
+
<parameter>zend.exception_string_param_max_len</parameter>
277
+
<type>int</type>
424
278
</term>
425
279
<listitem>
426
-
<para>
427
-
Enable compatibility mode with Zend Engine 1 (PHP 4). It affects
428
-
the cloning, casting (objects with no properties cast to &false; or 0), and <link
429
-
linkend="language.oop5.object-comparison">comparing of objects</link>.
430
-
In this mode, objects are passed by value instead of reference by
431
-
default.
432
-
</para>
433
-
<para>
434
-
See also the section titled
435
-
<link linkend="migration5">Migrating from PHP 4 to PHP 5</link>.
436
-
</para>
437
-
<warning>
438
-
<simpara>This feature has been <emphasis>DEPRECATED</emphasis> and <emphasis>REMOVED</emphasis>
439
-
as of PHP 5.3.0.
440
-
</simpara>
441
-
</warning>
280
+
<simpara>
281
+
The maximum length of string function arguments in stringified stack traces.
282
+
Must range between <literal>"0"</literal> and <literal>"1000000"</literal>.
283
+
</simpara>
442
284
</listitem>
443
285
</varlistentry>
444
286
445
287
<varlistentry xml:id="ini.hard-timeout">
446
288
<term>
447
289
<parameter>hard_timeout</parameter>
448
-
<type>integer</type>
290
+
<type>int</type>
449
291
</term>
450
292
<listitem>
451
293
<para>
294
+
When the timeout set in <link linkend="ini.max-execution-time">max_execution_time</link>
295
+
has been hit, the PHP runtime will tear down resources gracefully. If
296
+
something gets stuck while this happens, the hard timeout will tick
297
+
for the set amount of seconds. When the hard timeout is hit, PHP will
298
+
exit ungracefully. When set to 0, the hard timeout will never activate.
299
+
</para>
300
+
<para>
301
+
When PHP stops from a hard timeout, it will look something like this:
302
+
<screen>
303
+
<![CDATA[
304
+
Fatal error: Maximum execution time of 30+2 seconds exceeded (terminated) in Unknown on line 0
305
+
]]>
306
+
</screen>
452
307
</para>
453
308
</listitem>
454
309
</varlistentry>
...
...
@@ -456,7 +311,7 @@
456
311
<varlistentry xml:id="ini.zend.exception-ignore-args">
457
312
<term>
458
313
<parameter>zend.exception_ignore_args</parameter>
459
-
<type>boolean</type>
314
+
<type>bool</type>
460
315
</term>
461
316
<listitem>
462
317
<para>
...
...
@@ -468,7 +323,7 @@
468
323
<varlistentry xml:id="ini.zend.multibyte">
469
324
<term>
470
325
<parameter>zend.multibyte</parameter>
471
-
<type>boolean</type>
326
+
<type>bool</type>
472
327
</term>
473
328
<listitem>
474
329
<para>
...
...
@@ -496,7 +351,7 @@
496
351
is used, both zend.multibyte and zend.script_encoding must be used.
497
352
</para>
498
353
<para>
499
-
Literal strings will be transliterated from zend.script_enconding to
354
+
Literal strings will be transliterated from zend.script_encoding to
500
355
mbstring.internal_encoding, as if
501
356
<function>mb_convert_encoding</function> would have been called.
502
357
</para>
...
...
@@ -506,7 +361,7 @@
506
361
<varlistentry xml:id="ini.zend.detect-unicode">
507
362
<term>
508
363
<parameter>zend.detect_unicode</parameter>
509
-
<type>boolean</type>
364
+
<type>bool</type>
510
365
</term>
511
366
<listitem>
512
367
<para>
...
...
@@ -522,7 +377,7 @@
522
377
<varlistentry xml:id="ini.zend.signal-check">
523
378
<term>
524
379
<parameter>zend.signal_check</parameter>
525
-
<type>boolean</type>
380
+
<type>bool</type>
526
381
</term>
527
382
<listitem>
528
383
<para>
...
...
@@ -534,7 +389,7 @@
534
389
<varlistentry xml:id="ini.exit-on-timeout">
535
390
<term>
536
391
<parameter>exit_on_timeout</parameter>
537
-
<type>boolean</type>
392
+
<type>bool</type>
538
393
</term>
539
394
<listitem>
540
395
<para>
...
...
@@ -567,8 +422,8 @@
567
422
<row>
568
423
<entry><link linkend="ini.memory-limit">memory_limit</link></entry>
569
424
<entry>"128M"</entry>
570
-
<entry>PHP_INI_ALL</entry>
571
-
<entry>"8M" before PHP 5.2.0, "16M" in PHP 5.2.0</entry>
425
+
<entry><constant>INI_ALL</constant></entry>
426
+
<entry></entry>
572
427
</row>
573
428
</tbody>
574
429
</tgroup>
...
...
@@ -582,7 +437,7 @@
582
437
<varlistentry xml:id="ini.memory-limit">
583
438
<term>
584
439
<parameter>memory_limit</parameter>
585
-
<type>integer</type>
440
+
<type>int</type>
586
441
</term>
587
442
<listitem>
588
443
<para>
...
...
@@ -591,14 +446,6 @@
591
446
scripts for eating up all available memory on a server. Note that
592
447
to have no memory limit, set this directive to <literal>-1</literal>.
593
448
</para>
594
-
<para>
595
-
Prior to PHP 5.2.1, in order to use this directive it had to
596
-
be enabled at compile time by using
597
-
<option role="configure">--enable-memory-limit</option> in the
598
-
configure line. This compile-time flag was also required to define
599
-
the functions <function>memory_get_usage</function> and
600
-
<function>memory_get_peak_usage</function> prior to 5.2.1.
601
-
</para>
602
449
603
450
&ini.shorthandbytes;
604
451
...
...
@@ -629,14 +476,14 @@
629
476
<row>
630
477
<entry><link linkend="ini.realpath-cache-size">realpath_cache_size</link></entry>
631
478
<entry>"4M"</entry>
632
-
<entry>PHP_INI_SYSTEM</entry>
633
-
<entry>Available since PHP 5.1.0. Prior to PHP 7.0.16 and 7.1.2, the default was <literal>"16K"</literal></entry>
479
+
<entry><constant>INI_SYSTEM</constant></entry>
480
+
<entry>Prior to PHP 7.0.16 and 7.1.2, the default was <literal>"16K"</literal></entry>
634
481
</row>
635
482
<row>
636
483
<entry><link linkend="ini.realpath-cache-ttl">realpath_cache_ttl</link></entry>
637
484
<entry>"120"</entry>
638
-
<entry>PHP_INI_SYSTEM</entry>
639
-
<entry>Available since PHP 5.1.0.</entry>
485
+
<entry><constant>INI_SYSTEM</constant></entry>
486
+
<entry></entry>
640
487
</row>
641
488
</tbody>
642
489
</tgroup>
...
...
@@ -654,7 +501,7 @@
654
501
<varlistentry xml:id="ini.realpath-cache-size">
655
502
<term>
656
503
<parameter>realpath_cache_size</parameter>
657
-
<type>integer</type>
504
+
<type>int</type>
658
505
</term>
659
506
<listitem>
660
507
<para>
...
...
@@ -677,7 +524,7 @@
677
524
<varlistentry xml:id="ini.realpath-cache-ttl">
678
525
<term>
679
526
<parameter>realpath_cache_ttl</parameter>
680
-
<type>integer</type>
527
+
<type>int</type>
681
528
</term>
682
529
<listitem>
683
530
<para>
...
...
@@ -709,92 +556,92 @@
709
556
<row>
710
557
<entry><link linkend="ini.arg-separator.output">arg_separator.output</link></entry>
711
558
<entry>"&"</entry>
712
-
<entry>PHP_INI_ALL</entry>
559
+
<entry><constant>INI_ALL</constant></entry>
713
560
<entry></entry>
714
561
</row>
715
562
<row>
716
563
<entry><link linkend="ini.arg-separator.input">arg_separator.input</link></entry>
717
564
<entry>"&"</entry>
718
-
<entry>PHP_INI_PERDIR</entry>
565
+
<entry><constant>INI_PERDIR</constant></entry>
719
566
<entry></entry>
720
567
</row>
721
568
<row>
722
569
<entry><link linkend="ini.variables-order">variables_order</link></entry>
723
570
<entry>"EGPCS"</entry>
724
-
<entry>PHP_INI_PERDIR</entry>
725
-
<entry>PHP_INI_ALL in PHP <= 5.0.5.</entry>
571
+
<entry><constant>INI_PERDIR</constant></entry>
572
+
<entry></entry>
726
573
</row>
727
574
<row>
728
575
<entry><link linkend="ini.request-order">request_order</link></entry>
729
576
<entry>""</entry>
730
-
<entry>PHP_INI_PERDIR</entry>
731
-
<entry>Available since PHP 5.3.0</entry>
577
+
<entry><constant>INI_PERDIR</constant></entry>
578
+
<entry></entry>
732
579
</row>
733
580
<row>
734
581
<entry><link linkend="ini.auto-globals-jit">auto_globals_jit</link></entry>
735
582
<entry>"1"</entry>
736
-
<entry>PHP_INI_PERDIR</entry>
737
-
<entry>Available since PHP 5.0.0.</entry>
738
-
</row>
739
-
<row>
740
-
<entry><link linkend="ini.register-globals">register_globals</link></entry>
741
-
<entry>"0"</entry>
742
-
<entry>PHP_INI_PERDIR</entry>
743
-
<entry>Removed in PHP 5.4.0.</entry>
583
+
<entry><constant>INI_PERDIR</constant></entry>
584
+
<entry></entry>
744
585
</row>
745
586
<row>
746
587
<entry><link linkend="ini.register-argc-argv">register_argc_argv</link></entry>
747
588
<entry>"1"</entry>
748
-
<entry>PHP_INI_PERDIR</entry>
589
+
<entry><constant>INI_PERDIR</constant></entry>
749
590
<entry></entry>
750
591
</row>
751
-
<row>
752
-
<entry><link linkend="ini.register-long-arrays">register_long_arrays</link></entry>
753
-
<entry>"1"</entry>
754
-
<entry>PHP_INI_PERDIR</entry>
755
-
<entry>Deprecated in PHP 5.3.0. Removed in PHP 5.4.0.</entry>
756
-
</row>
757
592
<row>
758
593
<entry><link linkend="ini.enable-post-data-reading">enable_post_data_reading</link></entry>
759
594
<entry>"1"</entry>
760
-
<entry>PHP_INI_PERDIR</entry>
761
-
<entry>Available since PHP 5.4.0</entry>
595
+
<entry><constant>INI_PERDIR</constant></entry>
596
+
<entry></entry>
762
597
</row>
763
598
<row>
764
599
<entry><link linkend="ini.post-max-size">post_max_size</link></entry>
765
600
<entry>"8M"</entry>
766
-
<entry>PHP_INI_PERDIR</entry>
601
+
<entry><constant>INI_PERDIR</constant></entry>
767
602
<entry></entry>
768
603
</row>
769
604
<row>
770
605
<entry><link linkend="ini.auto-prepend-file">auto_prepend_file</link></entry>
771
606
<entry>NULL</entry>
772
-
<entry>PHP_INI_PERDIR</entry>
607
+
<entry><constant>INI_PERDIR</constant></entry>
773
608
<entry></entry>
774
609
</row>
775
610
<row>
776
611
<entry><link linkend="ini.auto-append-file">auto_append_file</link></entry>
777
612
<entry>NULL</entry>
778
-
<entry>PHP_INI_PERDIR</entry>
613
+
<entry><constant>INI_PERDIR</constant></entry>
779
614
<entry></entry>
780
615
</row>
781
616
<row>
782
617
<entry><link linkend="ini.default-mimetype">default_mimetype</link></entry>
783
618
<entry>"text/html"</entry>
784
-
<entry>PHP_INI_ALL</entry>
619
+
<entry><constant>INI_ALL</constant></entry>
785
620
<entry></entry>
786
621
</row>
787
622
<row>
788
623
<entry><link linkend="ini.default-charset">default_charset</link></entry>
789
624
<entry>"UTF-8"</entry>
790
-
<entry>PHP_INI_ALL</entry>
791
-
<entry>Defaults to "UTF-8" since PHP >= 5.6.0; empty for PHP < 5.6.0.</entry>
625
+
<entry><constant>INI_ALL</constant></entry>
626
+
<entry></entry>
792
627
</row>
793
628
<row>
794
-
<entry><link linkend="ini.always-populate-raw-post-data">always_populate_raw_post_data</link></entry>
795
-
<entry>"0"</entry>
796
-
<entry>PHP_INI_PERDIR</entry>
797
-
<entry>Removed in PHP 7.0.0.</entry>
629
+
<entry><link linkend="ini.input-encoding">input_encoding</link></entry>
630
+
<entry>""</entry>
631
+
<entry><constant>INI_ALL</constant></entry>
632
+
<entry></entry>
633
+
</row>
634
+
<row>
635
+
<entry><link linkend="ini.output-encoding">output_encoding</link></entry>
636
+
<entry>""</entry>
637
+
<entry><constant>INI_ALL</constant></entry>
638
+
<entry></entry>
639
+
</row>
640
+
<row>
641
+
<entry><link linkend="ini.internal-encoding">internal_encoding</link></entry>
642
+
<entry>""</entry>
643
+
<entry><constant>INI_ALL</constant></entry>
644
+
<entry></entry>
798
645
</row>
799
646
</tbody>
800
647
</tgroup>
...
...
@@ -852,21 +699,6 @@
852
699
<varname>$_COOKIE</varname>. Setting to "" means no
853
700
&link.superglobals; will be set.
854
701
</para>
855
-
<para>
856
-
If the deprecated
857
-
<link linkend="ini.register-globals">register_globals</link>
858
-
directive is on, then variables_order also
859
-
configures the order the <literal>ENV</literal>,
860
-
<literal>GET</literal>, <literal>POST</literal>,
861
-
<literal>COOKIE</literal> and <literal>SERVER</literal> variables
862
-
are populated in global scope. So for example if variables_order
863
-
is set to <literal>"EGPCS"</literal>, register_globals is enabled,
864
-
and both <varname>$_GET['action']</varname> and
865
-
<varname>$_POST['action']</varname> are set, then
866
-
<varname>$action</varname> will contain the value of
867
-
<varname>$_POST['action']</varname> as <literal>P</literal> comes
868
-
after <literal>G</literal> in our example directive value.
869
-
</para>
870
702
<warning>
871
703
<para>
872
704
In both the CGI and FastCGI SAPIs,
...
...
@@ -912,7 +744,7 @@
912
744
<varlistentry xml:id="ini.auto-globals-jit">
913
745
<term>
914
746
<parameter>auto_globals_jit</parameter>
915
-
<type>boolean</type>
747
+
<type>bool</type>
916
748
</term>
917
749
<listitem>
918
750
<para>
...
...
@@ -921,15 +753,6 @@
921
753
variables are not used within a script, having this directive on will
922
754
result in a performance gain.
923
755
</para>
924
-
<para>
925
-
The PHP directives
926
-
<link linkend="ini.register-globals">register_globals</link>,
927
-
<link linkend="ini.register-long-arrays">register_long_arrays</link>,
928
-
and <link linkend="ini.register-argc-argv">register_argc_argv</link>
929
-
must be disabled for this directive to have any affect. Since PHP
930
-
5.1.3 it is not necessary to have <link
931
-
linkend="ini.register-argc-argv">register_argc_argv</link> disabled.
932
-
</para>
933
756
<warning>
934
757
<para>
935
758
Usage of SERVER, REQUEST, and ENV variables is checked during the compile time
...
...
@@ -941,47 +764,10 @@
941
764
</listitem>
942
765
</varlistentry>
943
766
944
-
<varlistentry xml:id="ini.register-globals">
945
-
<term>
946
-
<parameter>register_globals</parameter>
947
-
<type>boolean</type>
948
-
</term>
949
-
<listitem>
950
-
<para>
951
-
Whether or not to register the EGPCS (Environment, GET,
952
-
POST, Cookie, Server) variables as global variables.
953
-
</para>
954
-
<para>
955
-
As of <link xlink:href="&url.php.release4.2.0;">PHP 4.2.0</link>,
956
-
this directive defaults to <emphasis>off</emphasis>.
957
-
</para>
958
-
<para>
959
-
Please read the security chapter on
960
-
<link linkend="security.globals">Using register_globals</link>
961
-
for related information.
962
-
</para>
963
-
<para>
964
-
Please note that <systemitem role="directive">register_globals</systemitem>
965
-
cannot be set at runtime (<function>ini_set</function>). Although, you can
966
-
use &htaccess; if your host allows it as described
967
-
above. An example &htaccess; entry:
968
-
<userinput>php_flag register_globals off</userinput>.
969
-
</para>
970
-
<note>
971
-
<para>
972
-
<systemitem role="directive">register_globals</systemitem> is affected
973
-
by the <link linkend="ini.variables-order">variables_order</link>
974
-
directive.
975
-
</para>
976
-
</note>
977
-
&warn.deprecated.feature-5-3-0.removed-5-4-0;
978
-
</listitem>
979
-
</varlistentry>
980
-
981
767
<varlistentry xml:id="ini.register-argc-argv">
982
768
<term>
983
769
<parameter>register_argc_argv</parameter>
984
-
<type>boolean</type>
770
+
<type>bool</type>
985
771
</term>
986
772
<listitem>
987
773
<simpara>
...
...
@@ -994,33 +780,10 @@
994
780
</listitem>
995
781
</varlistentry>
996
782
997
-
<varlistentry xml:id="ini.register-long-arrays">
998
-
<term>
999
-
<parameter>register_long_arrays</parameter>
1000
-
<type>boolean</type>
1001
-
</term>
1002
-
<listitem>
1003
-
<simpara>
1004
-
Tells PHP whether or not to register the deprecated long
1005
-
<varname>$HTTP_*_VARS</varname> type
1006
-
<link linkend="language.variables.predefined">predefined
1007
-
variables</link>. When On (default), long predefined PHP
1008
-
variables like <varname>$HTTP_GET_VARS</varname> will be defined.
1009
-
If you're not using them, it's recommended to turn them off,
1010
-
for performance reasons. Instead, use the superglobal arrays,
1011
-
like <varname>$_GET</varname>.
1012
-
</simpara>
1013
-
<simpara>
1014
-
This directive became available in PHP 5.0.0.
1015
-
</simpara>
1016
-
&warn.deprecated.feature-5-3-0.removed-5-4-0;
1017
-
</listitem>
1018
-
</varlistentry>
1019
-
1020
783
<varlistentry xml:id="ini.enable-post-data-reading">
1021
784
<term>
1022
785
<parameter>enable_post_data_reading</parameter>
1023
-
<type>boolean</type>
786
+
<type>bool</type>
1024
787
</term>
1025
788
<listitem>
1026
789
<simpara>
...
...
@@ -1037,7 +800,7 @@
1037
800
<varlistentry xml:id="ini.post-max-size">
1038
801
<term>
1039
802
<parameter>post_max_size</parameter>
1040
-
<type>integer</type>
803
+
<type>int</type>
1041
804
</term>
1042
805
<listitem>
1043
806
<simpara>
...
...
@@ -1168,7 +931,7 @@
1168
931
</term>
1169
932
<listitem>
1170
933
<para>
1171
-
In PHP 5.6 onwards, "UTF-8" is the default value and its value is used
934
+
"UTF-8" is the default value and its value is used
1172
935
as the default character encoding for
1173
936
<function>htmlentities</function>,
1174
937
<function>html_entity_decode</function> and
...
...
@@ -1206,7 +969,7 @@
1206
969
</term>
1207
970
<listitem>
1208
971
<para>
1209
-
Available from PHP 5.6.0. This setting is used for multibyte modules
972
+
This setting is used for multibyte modules
1210
973
such as mbstring and iconv. Default is empty.
1211
974
</para>
1212
975
</listitem>
...
...
@@ -1219,7 +982,7 @@
1219
982
</term>
1220
983
<listitem>
1221
984
<para>
1222
-
Available from PHP 5.6.0. This setting is used for multibyte modules
985
+
This setting is used for multibyte modules
1223
986
such as mbstring and iconv. Default is empty.
1224
987
</para>
1225
988
</listitem>
...
...
@@ -1232,50 +995,15 @@
1232
995
</term>
1233
996
<listitem>
1234
997
<para>
1235
-
Available from PHP 5.6.0. This setting is used for multibyte modules
998
+
This setting is used for multibyte modules
1236
999
such as mbstring and iconv. Default is empty. If empty,
1237
1000
<link linkend="ini.default-charset">default_charset</link> is used.
1238
1001
</para>
1239
1002
</listitem>
1240
1003
</varlistentry>
1241
1004
1242
-
<varlistentry xml:id="ini.always-populate-raw-post-data">
1243
-
<term>
1244
-
<parameter>always_populate_raw_post_data</parameter>
1245
-
<type>mixed</type>
1246
-
</term>
1247
-
<listitem>
1248
-
&warn.deprecated.feature-5-6-0.removed-7-0-0;
1249
-
<para>
1250
-
If set to &true;, PHP will always populate the
1251
-
<varname>$HTTP_RAW_POST_DATA</varname> containing the raw POST data.
1252
-
Otherwise, the variable is populated only when the MIME type of the
1253
-
data is unrecognised.
1254
-
</para>
1255
-
<para>
1256
-
The preferred method for accessing raw POST data is
1257
-
<link linkend="wrappers.php">php://input</link>, and
1258
-
<varname>$HTTP_RAW_POST_DATA</varname> is deprecated in PHP 5.6.0
1259
-
onwards. Setting <parameter>always_populate_raw_post_data</parameter>
1260
-
to <literal>-1</literal> will opt into the new behaviour that will be
1261
-
implemented in a future version of PHP, in which
1262
-
<varname>$HTTP_RAW_POST_DATA</varname> is never defined.
1263
-
</para>
1264
-
<para>
1265
-
Regardless of the setting, <varname>$HTTP_RAW_POST_DATA</varname> is
1266
-
not available with <literal>enctype="multipart/form-data"</literal>.
1267
-
</para>
1268
-
</listitem>
1269
-
</varlistentry>
1270
-
1271
1005
</variablelist>
1272
1006
</para>
1273
-
<para>
1274
-
See also: <link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link>,
1275
-
<link linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link>,
1276
-
and
1277
-
magic_quotes_sybase.
1278
-
</para>
1279
1007
</section>
1280
1008
1281
1009
<section xml:id="ini.sect.path-directory">
...
...
@@ -1296,43 +1024,43 @@
1296
1024
<row>
1297
1025
<entry><link linkend="ini.include-path">include_path</link></entry>
1298
1026
<entry>".;/path/to/php/pear"</entry>
1299
-
<entry>PHP_INI_ALL</entry>
1027
+
<entry><constant>INI_ALL</constant></entry>
1300
1028
<entry></entry>
1301
1029
</row>
1302
1030
<row>
1303
1031
<entry><link linkend="ini.open-basedir">open_basedir</link></entry>
1304
1032
<entry>NULL</entry>
1305
-
<entry>PHP_INI_ALL</entry>
1306
-
<entry>PHP_INI_SYSTEM in PHP < 5.3.0</entry>
1033
+
<entry><constant>INI_ALL</constant></entry>
1034
+
<entry></entry>
1307
1035
</row>
1308
1036
<row>
1309
1037
<entry><link linkend="ini.doc-root">doc_root</link></entry>
1310
1038
<entry>NULL</entry>
1311
-
<entry>PHP_INI_SYSTEM</entry>
1039
+
<entry><constant>INI_SYSTEM</constant></entry>
1312
1040
<entry></entry>
1313
1041
</row>
1314
1042
<row>
1315
1043
<entry><link linkend="ini.user-dir">user_dir</link></entry>
1316
1044
<entry>NULL</entry>
1317
-
<entry>PHP_INI_SYSTEM</entry>
1045
+
<entry><constant>INI_SYSTEM</constant></entry>
1318
1046
<entry></entry>
1319
1047
</row>
1320
1048
<row>
1321
1049
<entry><link linkend="ini.user-ini.cache-ttl">user_ini.cache_ttl</link></entry>
1322
1050
<entry>"300"</entry>
1323
-
<entry>PHP_INI_SYSTEM</entry>
1324
-
<entry>Available since PHP 5.3.0.</entry>
1051
+
<entry><constant>INI_SYSTEM</constant></entry>
1052
+
<entry></entry>
1325
1053
</row>
1326
1054
<row>
1327
1055
<entry><link linkend="ini.user-ini.filename">user_ini.filename</link></entry>
1328
1056
<entry>".user.ini"</entry>
1329
-
<entry>PHP_INI_SYSTEM</entry>
1330
-
<entry>Available since PHP 5.3.0.</entry>
1057
+
<entry><constant>INI_SYSTEM</constant></entry>
1058
+
<entry></entry>
1331
1059
</row>
1332
1060
<row>
1333
1061
<entry><link linkend="ini.extension-dir">extension_dir</link></entry>
1334
1062
<entry>"/path/to/php"</entry>
1335
-
<entry>PHP_INI_SYSTEM</entry>
1063
+
<entry><constant>INI_SYSTEM</constant></entry>
1336
1064
<entry></entry>
1337
1065
</row>
1338
1066
<row>
...
...
@@ -1347,77 +1075,59 @@
1347
1075
<entry>&php.ini; only</entry>
1348
1076
<entry></entry>
1349
1077
</row>
1350
-
<row>
1351
-
<entry><link linkend="ini.zend-extension-debug">zend_extension_debug</link></entry>
1352
-
<entry>NULL</entry>
1353
-
<entry>&php.ini; only</entry>
1354
-
<entry>Available before PHP 5.3.0.</entry>
1355
-
</row>
1356
-
<row>
1357
-
<entry><link linkend="ini.zend-extension-debug-ts">zend_extension_debug_ts</link></entry>
1358
-
<entry>NULL</entry>
1359
-
<entry>&php.ini; only</entry>
1360
-
<entry>Available before PHP 5.3.0.</entry>
1361
-
</row>
1362
-
<row>
1363
-
<entry><link linkend="ini.zend-extension-ts">zend_extension_ts</link></entry>
1364
-
<entry>NULL</entry>
1365
-
<entry>&php.ini; only</entry>
1366
-
<entry>Available before PHP 5.3.0.</entry>
1367
-
</row>
1368
1078
<row>
1369
1079
<entry><link linkend="ini.cgi.check-shebang-line">cgi.check_shebang_line</link></entry>
1370
1080
<entry>"1"</entry>
1371
-
<entry>PHP_INI_SYSTEM</entry>
1372
-
<entry>Available since PHP 5.2.0.</entry>
1081
+
<entry><constant>INI_SYSTEM</constant></entry>
1082
+
<entry></entry>
1373
1083
</row>
1374
1084
<row>
1375
1085
<entry><link linkend="ini.cgi.discard-path">cgi.discard_path</link></entry>
1376
1086
<entry>"0"</entry>
1377
-
<entry>PHP_INI_SYSTEM</entry>
1378
-
<entry>Available since PHP 5.3.0.</entry>
1087
+
<entry><constant>INI_SYSTEM</constant></entry>
1088
+
<entry></entry>
1379
1089
</row>
1380
1090
<row>
1381
1091
<entry><link linkend="ini.cgi.fix-pathinfo">cgi.fix_pathinfo</link></entry>
1382
1092
<entry>"1"</entry>
1383
-
<entry>PHP_INI_SYSTEM</entry>
1384
-
<entry>PHP_INI_ALL prior to PHP 5.2.1.</entry>
1093
+
<entry><constant>INI_SYSTEM</constant></entry>
1094
+
<entry></entry>
1385
1095
</row>
1386
1096
<row>
1387
1097
<entry><link linkend="ini.cgi.force-redirect">cgi.force_redirect</link></entry>
1388
1098
<entry>"1"</entry>
1389
-
<entry>PHP_INI_SYSTEM</entry>
1390
-
<entry>PHP_INI_ALL prior to PHP 5.2.1.</entry>
1099
+
<entry><constant>INI_SYSTEM</constant></entry>
1100
+
<entry></entry>
1391
1101
</row>
1392
1102
<row>
1393
1103
<entry><link linkend="ini.cgi.nph">cgi.nph</link></entry>
1394
1104
<entry>"0"</entry>
1395
-
<entry>PHP_INI_SYSTEM</entry>
1396
-
<entry>Available since PHP 5.3.0.</entry>
1105
+
<entry><constant>INI_SYSTEM</constant></entry>
1106
+
<entry></entry>
1397
1107
</row>
1398
1108
<row>
1399
1109
<entry><link linkend="ini.cgi.redirect-status-env">cgi.redirect_status_env</link></entry>
1400
1110
<entry>NULL</entry>
1401
-
<entry>PHP_INI_SYSTEM</entry>
1402
-
<entry>PHP_INI_ALL prior to PHP 5.2.1.</entry>
1111
+
<entry><constant>INI_SYSTEM</constant></entry>
1112
+
<entry></entry>
1403
1113
</row>
1404
1114
<row>
1405
1115
<entry><link linkend="ini.cgi.rfc2616-headers">cgi.rfc2616_headers</link></entry>
1406
1116
<entry>"0"</entry>
1407
-
<entry>PHP_INI_ALL</entry>
1117
+
<entry><constant>INI_ALL</constant></entry>
1408
1118
<entry></entry>
1409
1119
</row>
1410
1120
<row>
1411
1121
<entry><link linkend="ini.fastcgi.impersonate">fastcgi.impersonate</link></entry>
1412
1122
<entry>"0"</entry>
1413
-
<entry>PHP_INI_SYSTEM</entry>
1414
-
<entry>PHP_INI_ALL prior to PHP 5.2.1.</entry>
1123
+
<entry><constant>INI_SYSTEM</constant></entry>
1124
+
<entry></entry>
1415
1125
</row>
1416
1126
<row>
1417
1127
<entry><link linkend="ini.fastcgi.logging">fastcgi.logging</link></entry>
1418
1128
<entry>"1"</entry>
1419
-
<entry>PHP_INI_SYSTEM</entry>
1420
-
<entry>PHP_INI_ALL prior to PHP 5.2.1.</entry>
1129
+
<entry><constant>INI_SYSTEM</constant></entry>
1130
+
<entry></entry>
1421
1131
</row>
1422
1132
</tbody>
1423
1133
</tgroup>
...
...
@@ -1512,9 +1222,7 @@ include_path = ".:${USER}/pear/php"
1512
1222
<listitem>
1513
1223
<para>
1514
1224
Limit the files that can be accessed by PHP to the specified
1515
-
directory-tree, including the file itself. This directive
1516
-
is <emphasis>NOT</emphasis> affected by whether Safe Mode is
1517
-
turned On or Off.
1225
+
directory-tree, including the file itself.
1518
1226
</para>
1519
1227
<para>
1520
1228
When a script tries to access the filesystem, for example using
...
...
@@ -1552,26 +1260,26 @@ include_path = ".:${USER}/pear/php"
1552
1260
</para>
1553
1261
<para>
1554
1262
The restriction specified with <option>open_basedir</option> is a
1555
-
directory name since PHP 5.2.16 and 5.3.4. Previous versions used it
1556
-
as a prefix. This means that "<literal>open_basedir
1557
-
= /dir/incl</literal>" also allowed access to "<literal>/dir/include</literal>" and
1558
-
"<literal>/dir/incls</literal>" if they exist. When you want to restrict access
1559
-
to only the specified directory, end with a slash. For example:
1560
-
<literal>open_basedir = /dir/incl/</literal>
1263
+
directory name, not a prefix.
1561
1264
</para>
1562
1265
<para>
1563
1266
The default is to allow all files to be opened.
1564
1267
</para>
1565
1268
<note>
1566
-
<para>
1567
-
As of PHP 5.3.0 open_basedir can be tightened at run-time. This means
1269
+
<simpara>
1270
+
open_basedir can be tightened at run-time. This means
1568
1271
that if open_basedir is set to <literal>/www/</literal> in &php.ini;
1569
1272
a script can tighten the configuration to
1570
1273
<literal>/www/tmp/</literal> at run-time with
1571
1274
<function>ini_set</function>. When listing several directories, you
1572
1275
can use the <constant>PATH_SEPARATOR</constant> constant as a separator
1573
1276
regardless of the operating system.
1574
-
</para>
1277
+
</simpara>
1278
+
<simpara>
1279
+
As of PHP 8.3.0, <option>open_basedir</option> no longer accepts a
1280
+
paths containing the parent directory (<literal>..</literal>) when
1281
+
set at runtime using <function>ini_set</function>.
1282
+
</simpara>
1575
1283
</note>
1576
1284
<note>
1577
1285
<para>
...
...
@@ -1579,6 +1287,12 @@ include_path = ".:${USER}/pear/php"
1579
1287
to <literal>0</literal> and thus <emphasis>disable</emphasis> the realpath cache.
1580
1288
</para>
1581
1289
</note>
1290
+
<caution>
1291
+
<para>
1292
+
<literal>open_basedir</literal> is just an extra safety net, that is in no way
1293
+
comprehensive, and can therefore not be relied upon when security is needed.
1294
+
</para>
1295
+
</caution>
1582
1296
</listitem>
1583
1297
</varlistentry>
1584
1298
...
...
@@ -1603,7 +1317,7 @@ include_path = ".:${USER}/pear/php"
1603
1317
<varlistentry xml:id="ini.user-ini.cache-ttl">
1604
1318
<term>
1605
1319
<parameter>user_ini.cache_ttl</parameter>
1606
-
<type>integer</type>
1320
+
<type>int</type>
1607
1321
</term>
1608
1322
<listitem>
1609
1323
<para>
...
...
@@ -1644,7 +1358,7 @@ include_path = ".:${USER}/pear/php"
1644
1358
<listitem>
1645
1359
<para>
1646
1360
In what directory PHP should look for dynamically loadable
1647
-
extensions. See also: <link linkend="ini.enable-dl">enable_dl</link>,
1361
+
extensions. It is recommended to specify an absolute path. See also: <link linkend="ini.enable-dl">enable_dl</link>,
1648
1362
and <function>dl</function>.
1649
1363
</para>
1650
1364
</listitem>
...
...
@@ -1675,50 +1389,10 @@ include_path = ".:${USER}/pear/php"
1675
1389
</listitem>
1676
1390
</varlistentry>
1677
1391
1678
-
<varlistentry xml:id="ini.zend-extension-debug">
1679
-
<term>
1680
-
<parameter>zend_extension_debug</parameter>
1681
-
<type>string</type>
1682
-
</term>
1683
-
<listitem>
1684
-
<para>
1685
-
Variant of <link linkend="ini.zend-extension">zend_extension</link>
1686
-
for extensions compiled with debug info prior to PHP 5.3.0.
1687
-
</para>
1688
-
</listitem>
1689
-
</varlistentry>
1690
-
1691
-
<varlistentry xml:id="ini.zend-extension-debug-ts">
1692
-
<term>
1693
-
<parameter>zend_extension_debug_ts</parameter>
1694
-
<type>string</type>
1695
-
</term>
1696
-
<listitem>
1697
-
<para>
1698
-
Variant of <link linkend="ini.zend-extension">zend_extension</link>
1699
-
for extensions compiled with debug info and thread safety prior to PHP
1700
-
5.3.0.
1701
-
</para>
1702
-
</listitem>
1703
-
</varlistentry>
1704
-
1705
-
<varlistentry xml:id="ini.zend-extension-ts">
1706
-
<term>
1707
-
<parameter>zend_extension_ts</parameter>
1708
-
<type>string</type>
1709
-
</term>
1710
-
<listitem>
1711
-
<para>
1712
-
Variant of <link linkend="ini.zend-extension">zend_extension</link>
1713
-
for extensions compiled with thread safety prior to PHP 5.3.0.
1714
-
</para>
1715
-
</listitem>
1716
-
</varlistentry>
1717
-
1718
1392
<varlistentry xml:id="ini.cgi.check-shebang-line">
1719
1393
<term>
1720
1394
<parameter>cgi.check_shebang_line</parameter>
1721
-
<type>boolean</type>
1395
+
<type>bool</type>
1722
1396
</term>
1723
1397
<listitem>
1724
1398
<para>
...
...
@@ -1735,7 +1409,7 @@ include_path = ".:${USER}/pear/php"
1735
1409
<varlistentry xml:id="ini.cgi.discard-path">
1736
1410
<term>
1737
1411
<parameter>cgi.discard_path</parameter>
1738
-
<type>boolean</type>
1412
+
<type>bool</type>
1739
1413
</term>
1740
1414
<listitem>
1741
1415
<para>
...
...
@@ -1748,7 +1422,7 @@ include_path = ".:${USER}/pear/php"
1748
1422
<varlistentry xml:id="ini.cgi.fix-pathinfo">
1749
1423
<term>
1750
1424
<parameter>cgi.fix_pathinfo</parameter>
1751
-
<type>boolean</type>
1425
+
<type>bool</type>
1752
1426
</term>
1753
1427
<listitem>
1754
1428
<para>
...
...
@@ -1771,7 +1445,7 @@ include_path = ".:${USER}/pear/php"
1771
1445
<varlistentry xml:id="ini.cgi.force-redirect">
1772
1446
<term>
1773
1447
<parameter>cgi.force_redirect</parameter>
1774
-
<type>boolean</type>
1448
+
<type>bool</type>
1775
1449
</term>
1776
1450
<listitem>
1777
1451
<para>
...
...
@@ -1792,7 +1466,7 @@ include_path = ".:${USER}/pear/php"
1792
1466
<varlistentry xml:id="ini.cgi.nph">
1793
1467
<term>
1794
1468
<parameter>cgi.nph</parameter>
1795
-
<type>boolean</type>
1469
+
<type>bool</type>
1796
1470
</term>
1797
1471
<listitem>
1798
1472
<para>
...
...
@@ -1826,14 +1500,14 @@ include_path = ".:${USER}/pear/php"
1826
1500
<varlistentry xml:id="ini.cgi.rfc2616-headers">
1827
1501
<term>
1828
1502
<parameter>cgi.rfc2616_headers</parameter>
1829
-
<type>int</type>
1503
+
<type>bool</type>
1830
1504
</term>
1831
1505
<listitem>
1832
1506
<para>
1833
1507
Tells PHP what type of headers to use when sending HTTP response
1834
-
code. If it's set to 0, PHP sends a <link xlink:href="&url.rfc;3875">RFC 3875</link>
1508
+
code. If it is disabled, PHP sends a <link xlink:href="&url.rfc;3875">RFC 3875</link>
1835
1509
"Status:" header that is supported by Apache and other web servers. When this option
1836
-
is set to 1, PHP will send <link xlink:href="&url.rfc;2616">RFC 2616</link> compliant
1510
+
is enabled, PHP will send <link xlink:href="&url.rfc;2616">RFC 2616</link> compliant
1837
1511
headers.
1838
1512
</para>
1839
1513
<para>
...
...
@@ -1843,7 +1517,7 @@ include_path = ".:${USER}/pear/php"
1843
1517
you should use header("Status: 404 Not Found");
1844
1518
</para>
1845
1519
<para>
1846
-
Leave it set to 0 unless you know what you're doing.
1520
+
Leave it disabled unless you know what you're doing.
1847
1521
</para>
1848
1522
</listitem>
1849
1523
</varlistentry>
...
...
@@ -1851,7 +1525,7 @@ include_path = ".:${USER}/pear/php"
1851
1525
<varlistentry xml:id="ini.fastcgi.impersonate">
1852
1526
<term>
1853
1527
<parameter>fastcgi.impersonate</parameter>
1854
-
<type>string</type>
1528
+
<type>bool</type>
1855
1529
</term>
1856
1530
<listitem>
1857
1531
<para>
...
...
@@ -1859,7 +1533,7 @@ include_path = ".:${USER}/pear/php"
1859
1533
security tokens of the calling client. This allows IIS to define the
1860
1534
security context that the request runs under. mod_fastcgi under Apache
1861
1535
does not currently support this feature (03/17/2002)
1862
-
Set to 1 if running under IIS. Default is zero.
1536
+
Enable if running under IIS. Default is disabled.
1863
1537
</para>
1864
1538
</listitem>
1865
1539
</varlistentry>
...
...
@@ -1867,7 +1541,7 @@ include_path = ".:${USER}/pear/php"
1867
1541
<varlistentry xml:id="ini.fastcgi.logging">
1868
1542
<term>
1869
1543
<parameter>fastcgi.logging</parameter>
1870
-
<type>boolean</type>
1544
+
<type>bool</type>
1871
1545
</term>
1872
1546
<listitem>
1873
1547
<para>
...
...
@@ -1899,38 +1573,38 @@ include_path = ".:${USER}/pear/php"
1899
1573
<row>
1900
1574
<entry><link linkend="ini.file-uploads">file_uploads</link></entry>
1901
1575
<entry>"1"</entry>
1902
-
<entry>PHP_INI_SYSTEM</entry>
1576
+
<entry><constant>INI_SYSTEM</constant></entry>
1903
1577
<entry></entry>
1904
1578
</row>
1905
1579
<row>
1906
1580
<entry><link linkend="ini.upload-tmp-dir">upload_tmp_dir</link></entry>
1907
1581
<entry>NULL</entry>
1908
-
<entry>PHP_INI_SYSTEM</entry>
1582
+
<entry><constant>INI_SYSTEM</constant></entry>
1909
1583
<entry></entry>
1910
1584
</row>
1911
1585
<row>
1912
1586
<entry><link linkend="ini.max-input-nesting-level">max_input_nesting_level</link></entry>
1913
1587
<entry>64</entry>
1914
-
<entry>PHP_INI_PERDIR</entry>
1915
-
<entry>Available since PHP 5.3.9.</entry>
1588
+
<entry><constant>INI_PERDIR</constant></entry>
1589
+
<entry></entry>
1916
1590
</row>
1917
1591
<row>
1918
1592
<entry><link linkend="ini.max-input-vars">max_input_vars</link></entry>
1919
1593
<entry>1000</entry>
1920
-
<entry>PHP_INI_PERDIR</entry>
1921
-
<entry>Available since PHP 5.3.9.</entry>
1594
+
<entry><constant>INI_PERDIR</constant></entry>
1595
+
<entry></entry>
1922
1596
</row>
1923
1597
<row>
1924
1598
<entry><link linkend="ini.upload-max-filesize">upload_max_filesize</link></entry>
1925
1599
<entry>"2M"</entry>
1926
-
<entry>PHP_INI_PERDIR</entry>
1600
+
<entry><constant>INI_PERDIR</constant></entry>
1927
1601
<entry></entry>
1928
1602
</row>
1929
1603
<row>
1930
1604
<entry><link linkend="ini.max-file-uploads">max_file_uploads</link></entry>
1931
1605
<entry>20</entry>
1932
-
<entry>PHP_INI_SYSTEM</entry>
1933
-
<entry>Available since PHP 5.2.12.</entry>
1606
+
<entry><constant>INI_PERDIR</constant></entry>
1607
+
<entry></entry>
1934
1608
</row>
1935
1609
</tbody>
1936
1610
</tgroup>
...
...
@@ -1944,7 +1618,7 @@ include_path = ".:${USER}/pear/php"
1944
1618
<varlistentry xml:id="ini.file-uploads">
1945
1619
<term>
1946
1620
<parameter>file_uploads</parameter>
1947
-
<type>boolean</type>
1621
+
<type>bool</type>
1948
1622
</term>
1949
1623
<listitem>
1950
1624
<para>
...
...
@@ -1981,12 +1655,15 @@ include_path = ".:${USER}/pear/php"
1981
1655
<varlistentry xml:id="ini.upload-max-filesize">
1982
1656
<term>
1983
1657
<parameter>upload_max_filesize</parameter>
1984
-
<type>integer</type>
1658
+
<type>int</type>
1985
1659
</term>
1986
1660
<listitem>
1987
1661
<para>
1988
1662
The maximum size of an uploaded file.
1989
1663
</para>
1664
+
<para>
1665
+
<link linkend="ini.post-max-size">post_max_size</link> must be larger than this value.
1666
+
</para>
1990
1667
1991
1668
&ini.shorthandbytes;
1992
1669
...
...
@@ -1996,12 +1673,12 @@ include_path = ".:${USER}/pear/php"
1996
1673
<varlistentry xml:id="ini.max-file-uploads">
1997
1674
<term>
1998
1675
<parameter>max_file_uploads</parameter>
1999
-
<type>integer</type>
1676
+
<type>int</type>
2000
1677
</term>
2001
1678
<listitem>
2002
1679
<para>
2003
1680
The maximum number of files allowed to be uploaded simultaneously.
2004
-
Starting with PHP 5.3.4, upload fields left blank on submission do not
1681
+
Upload fields left blank on submission do not
2005
1682
count towards this limit.
2006
1683
</para>
2007
1684
</listitem>
...
...
@@ -2028,8 +1705,8 @@ include_path = ".:${USER}/pear/php"
2028
1705
<row>
2029
1706
<entry><link linkend="ini.sql.safe-mode">sql.safe_mode</link></entry>
2030
1707
<entry>"0"</entry>
2031
-
<entry>PHP_INI_SYSTEM</entry>
2032
-
<entry>Removed in PHP 7.2.0</entry>
1708
+
<entry><constant>INI_SYSTEM</constant></entry>
1709
+
<entry>Removed as of PHP 7.2.0</entry>
2033
1710
</row>
2034
1711
</tbody>
2035
1712
</tgroup>
...
...
@@ -2043,7 +1720,7 @@ include_path = ".:${USER}/pear/php"
2043
1720
<varlistentry xml:id="ini.sql.safe-mode">
2044
1721
<term>
2045
1722
<parameter>sql.safe_mode</parameter>
2046
-
<type>boolean</type>
1723
+
<type>bool</type>
2047
1724
</term>
2048
1725
<listitem>
2049
1726
<para>
...
...
@@ -2081,8 +1758,8 @@ include_path = ".:${USER}/pear/php"
2081
1758
<row>
2082
1759
<entry><link linkend="ini.windows-show-crt-warning">windows.show_crt_warning</link></entry>
2083
1760
<entry>"0"</entry>
2084
-
<entry>PHP_INI_ALL</entry>
2085
-
<entry>Available since PHP 5.4.0.</entry>
1761
+
<entry><constant>INI_ALL</constant></entry>
1762
+
<entry></entry>
2086
1763
</row>
2087
1764
</tbody>
2088
1765
</tgroup>
...
...
@@ -2096,12 +1773,11 @@ include_path = ".:${USER}/pear/php"
2096
1773
<varlistentry xml:id="ini.windows-show-crt-warning">
2097
1774
<term>
2098
1775
<parameter>windows.show_crt_warning</parameter>
2099
-
<type>boolean</type>
1776
+
<type>bool</type>
2100
1777
</term>
2101
1778
<listitem>
2102
1779
<para>
2103
-
This directive shows the Windows CRT warnings when enabled. These
2104
-
warnings were displayed by default until PHP 5.4.0.
1780
+
This directive shows the Windows CRT warnings when enabled.
2105
1781
</para>
2106
1782
</listitem>
2107
1783
</varlistentry>
2108
1784