reference/info/ini.xml
d4d5216e7a965ca194f6b1c9dee84cecab2674e5
d4d5216e7a965ca194f6b1c9dee84cecab2674e5
...
...
@@ -5,7 +5,7 @@
5
5
&extension.runtime;
6
6
<para>
7
7
<table>
8
-
<title>PHP Options/Inf Configuration Options</title>
8
+
<title>PHP Options/Info Configuration Options</title>
9
9
<tgroup cols="4">
10
10
<thead>
11
11
<row>
...
...
@@ -19,86 +19,85 @@
19
19
<row>
20
20
<entry><link linkend="ini.assert.active">assert.active</link></entry>
21
21
<entry>"1"</entry>
22
-
<entry>PHP_INI_ALL</entry>
23
-
<entry></entry>
22
+
<entry><constant>INI_ALL</constant></entry>
23
+
<entry>
24
+
Deprecated as of PHP 8.3.0
25
+
</entry>
24
26
</row>
25
27
<row>
26
28
<entry><link linkend="ini.assert.bail">assert.bail</link></entry>
27
29
<entry>"0"</entry>
28
-
<entry>PHP_INI_ALL</entry>
29
-
<entry></entry>
30
+
<entry><constant>INI_ALL</constant></entry>
31
+
<entry>
32
+
Deprecated as of PHP 8.3.0
33
+
</entry>
30
34
</row>
31
35
<row>
32
36
<entry><link linkend="ini.assert.warning">assert.warning</link></entry>
33
37
<entry>"1"</entry>
34
-
<entry>PHP_INI_ALL</entry>
35
-
<entry></entry>
38
+
<entry><constant>INI_ALL</constant></entry>
39
+
<entry>
40
+
Deprecated as of PHP 8.3.0
41
+
</entry>
36
42
</row>
37
43
<row>
38
44
<entry><link linkend="ini.assert.callback">assert.callback</link></entry>
39
45
<entry>NULL</entry>
40
-
<entry>PHP_INI_ALL</entry>
41
-
<entry></entry>
46
+
<entry><constant>INI_ALL</constant></entry>
47
+
<entry>
48
+
Deprecated as of PHP 8.3.0
49
+
</entry>
42
50
</row>
43
51
<row>
44
52
<entry><link linkend="ini.assert.quiet-eval">assert.quiet_eval</link></entry>
45
53
<entry>"0"</entry>
46
-
<entry>PHP_INI_ALL</entry>
47
-
<entry></entry>
54
+
<entry><constant>INI_ALL</constant></entry>
55
+
<entry>Removed as of PHP 8.0.0</entry>
48
56
</row>
49
57
<row>
50
58
<entry><link linkend="ini.assert.exception">assert.exception</link></entry>
51
-
<entry>"0"</entry>
52
-
<entry>PHP_INI_ALL</entry>
53
-
<entry>Available since PHP 7.0.0.</entry>
59
+
<entry>"1"</entry>
60
+
<entry><constant>INI_ALL</constant></entry>
61
+
<entry>
62
+
Prior to PHP 8.0.0, defaults to <literal>"0"</literal>.
63
+
Deprecated as of PHP 8.3.0
64
+
</entry>
54
65
</row>
55
66
<row>
56
67
<entry><link linkend="ini.enable-dl">enable_dl</link></entry>
57
68
<entry>"1"</entry>
58
-
<entry>PHP_INI_SYSTEM</entry>
69
+
<entry><constant>INI_SYSTEM</constant></entry>
59
70
<entry>&removed.php.future;</entry>
60
71
</row>
61
72
<row>
62
73
<entry><link linkend="ini.max-execution-time">max_execution_time</link></entry>
63
74
<entry>"30"</entry>
64
-
<entry>PHP_INI_ALL</entry>
75
+
<entry><constant>INI_ALL</constant></entry>
65
76
<entry></entry>
66
77
</row>
67
78
<row>
68
79
<entry><link linkend="ini.max-input-time">max_input_time</link></entry>
69
80
<entry>"-1"</entry>
70
-
<entry>PHP_INI_PERDIR</entry>
71
-
<entry>Available since PHP 4.3.0.</entry>
81
+
<entry><constant>INI_PERDIR</constant></entry>
82
+
<entry></entry>
72
83
</row>
73
84
<row>
74
85
<entry><link linkend="ini.max-input-nesting-level">max_input_nesting_level</link></entry>
75
86
<entry>"64"</entry>
76
-
<entry>PHP_INI_PERDIR</entry>
77
-
<entry>Available since PHP 4.4.8 and PHP 5.2.3.</entry>
87
+
<entry><constant>INI_PERDIR</constant></entry>
88
+
<entry></entry>
78
89
</row>
79
90
<row>
80
91
<entry><link linkend="ini.max-input-vars">max_input_vars</link></entry>
81
92
<entry>1000</entry>
82
-
<entry>PHP_INI_PERDIR</entry>
83
-
<entry>Available since PHP 5.3.9.</entry>
84
-
</row>
85
-
<row>
86
-
<entry><link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link></entry>
87
-
<entry>"1"</entry>
88
-
<entry>PHP_INI_PERDIR</entry>
89
-
<entry>PHP_INI_ALL in PHP <= 4.2.3. Removed in PHP 5.4.0.</entry>
90
-
</row>
91
-
<row>
92
-
<entry><link linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link></entry>
93
-
<entry>"0"</entry>
94
-
<entry>PHP_INI_ALL</entry>
95
-
<entry>Removed in PHP 5.4.0.</entry>
93
+
<entry><constant>INI_PERDIR</constant></entry>
94
+
<entry></entry>
96
95
</row>
97
96
<row>
98
97
<entry><link linkend="ini.zend.enable-gc">zend.enable_gc</link></entry>
99
98
<entry>"1"</entry>
100
-
<entry>PHP_INI_ALL</entry>
101
-
<entry>Available since PHP 5.3.0.</entry>
99
+
<entry><constant>INI_ALL</constant></entry>
100
+
<entry></entry>
102
101
</row>
103
102
</tbody>
104
103
</tgroup>
...
...
@@ -113,36 +112,41 @@
113
112
<varlistentry xml:id="ini.assert.active">
114
113
<term>
115
114
<parameter>assert.active</parameter>
116
-
<type>boolean</type>
115
+
<type>bool</type>
117
116
</term>
118
117
<listitem>
119
118
<para>
120
119
Enable <function>assert</function> evaluation.
120
+
<link linkend="ini.zend.assertions">zend.assertions</link> should be
121
+
used instead to control the behaviour of <function>assert</function>.
121
122
</para>
123
+
&warn.deprecated.feature-8-3-0;
122
124
</listitem>
123
125
</varlistentry>
124
126
125
127
<varlistentry xml:id="ini.assert.bail">
126
128
<term>
127
129
<parameter>assert.bail</parameter>
128
-
<type>boolean</type>
130
+
<type>bool</type>
129
131
</term>
130
132
<listitem>
131
133
<para>
132
134
Terminate script execution on failed assertions.
133
135
</para>
136
+
&warn.deprecated.feature-8-3-0;
134
137
</listitem>
135
138
</varlistentry>
136
139
137
140
<varlistentry xml:id="ini.assert.warning">
138
141
<term>
139
142
<parameter>assert.warning</parameter>
140
-
<type>boolean</type>
143
+
<type>bool</type>
141
144
</term>
142
145
<listitem>
143
146
<para>
144
147
Issue a PHP warning for each failed assertion.
145
148
</para>
149
+
&warn.deprecated.feature-8-3-0;
146
150
</listitem>
147
151
</varlistentry>
148
152
...
...
@@ -155,15 +159,17 @@
155
159
<para>
156
160
User function to call on failed assertions.
157
161
</para>
162
+
&warn.deprecated.feature-8-3-0;
158
163
</listitem>
159
164
</varlistentry>
160
165
161
166
<varlistentry xml:id="ini.assert.quiet-eval">
162
167
<term>
163
168
<parameter>assert.quiet_eval</parameter>
164
-
<type>boolean</type>
169
+
<type>bool</type>
165
170
</term>
166
171
<listitem>
172
+
&warn.feature.removed-8-0-0;
167
173
<para>
168
174
Use the current setting of <function>error_reporting</function> during
169
175
assertion expression evaluation. If enabled, no errors are shown
...
...
@@ -176,35 +182,33 @@
176
182
<varlistentry xml:id="ini.assert.exception">
177
183
<term>
178
184
<parameter>assert.exception</parameter>
179
-
<type>boolean</type>
185
+
<type>bool</type>
180
186
</term>
181
187
<listitem>
182
188
<para>
183
189
Issue an <classname>AssertionError</classname> exception for the failed
184
190
assertion.
185
191
</para>
192
+
&warn.deprecated.feature-8-3-0;
186
193
</listitem>
187
194
</varlistentry>
188
195
189
196
<varlistentry xml:id="ini.enable-dl">
190
197
<term>
191
198
<parameter>enable_dl</parameter>
192
-
<type>boolean</type>
199
+
<type>bool</type>
193
200
</term>
194
201
<listitem>
195
202
<para>
196
-
This directive is really only useful in the Apache module
197
-
version of PHP. You can turn dynamic loading of
203
+
This directive allows to turn dynamic loading of
198
204
PHP extensions with <function>dl</function> on and
199
-
off per virtual server or per directory.
205
+
off.
200
206
</para>
201
207
<para>
202
208
The main reason for turning dynamic loading off is
203
209
security. With dynamic loading, it's possible to ignore all
204
210
<link linkend="ini.open-basedir">open_basedir</link> restrictions.
205
-
The default is to allow dynamic loading, except when using
206
-
&safemode;. In &safemode;, it's
207
-
always impossible to use <function>dl</function>.
211
+
The default is to allow dynamic loading.
208
212
</para>
209
213
</listitem>
210
214
</varlistentry>
...
...
@@ -212,7 +216,7 @@
212
216
<varlistentry xml:id="ini.max-execution-time">
213
217
<term>
214
218
<parameter>max_execution_time</parameter>
215
-
<type>integer</type>
219
+
<type>int</type>
216
220
</term>
217
221
<listitem>
218
222
<para>
...
...
@@ -224,17 +228,12 @@
224
228
line</link> the default setting is <literal>0</literal>.
225
229
</para>
226
230
<para>
227
-
The maximum execution time is not affected by system calls,
231
+
On non Windows systems, the maximum execution time is not affected by system calls,
228
232
stream operations etc. Please see the
229
233
<function>set_time_limit</function> function for more
230
234
details.
231
235
</para>
232
236
<para>
233
-
You can not change this setting with <function>ini_set</function> when
234
-
running in &safemode;. The only workaround is to turn off safe mode or
235
-
by changing the time limit in the &php.ini;.
236
-
</para>
237
-
<para>
238
237
Your web server can have other timeout configurations that may
239
238
also interrupt PHP execution. Apache has a
240
239
<literal>Timeout</literal> directive and IIS has a CGI timeout
...
...
@@ -247,13 +246,16 @@
247
246
<varlistentry xml:id="ini.max-input-time">
248
247
<term>
249
248
<parameter>max_input_time</parameter>
250
-
<type>integer</type>
249
+
<type>int</type>
251
250
</term>
252
251
<listitem>
253
252
<para>
254
253
This sets the maximum time in seconds a script is allowed to
255
254
parse input data, like POST and GET. Timing begins at the moment PHP
256
255
is invoked at the server and ends when execution begins.
256
+
The default setting is <literal>-1</literal>, which means that
257
+
<link linkend="ini.max-execution-time">max_execution_time</link>
258
+
is used instead. Set to <literal>0</literal> to allow unlimited time.
257
259
</para>
258
260
</listitem>
259
261
</varlistentry>
...
...
@@ -261,7 +263,7 @@
261
263
<varlistentry xml:id="ini.max-input-nesting-level">
262
264
<term>
263
265
<parameter>max_input_nesting_level</parameter>
264
-
<type>integer</type>
266
+
<type>int</type>
265
267
</term>
266
268
<listitem>
267
269
<para>
...
...
@@ -275,7 +277,7 @@
275
277
<varlistentry xml:id="ini.max-input-vars">
276
278
<term>
277
279
<parameter>max_input_vars</parameter>
278
-
<type>integer</type>
280
+
<type>int</type>
279
281
</term>
280
282
<listitem>
281
283
<para>
...
...
@@ -290,114 +292,10 @@
290
292
</listitem>
291
293
</varlistentry>
292
294
293
-
<varlistentry xml:id="ini.magic-quotes-gpc">
294
-
<term>
295
-
<parameter>magic_quotes_gpc</parameter>
296
-
<type>boolean</type>
297
-
</term>
298
-
<listitem>
299
-
&warn.deprecated.feature-5-3-0.removed-5-4-0;
300
-
<para>
301
-
Sets the magic_quotes state for GPC (Get/Post/Cookie)
302
-
operations. When magic_quotes are on, all ' (single-quote),
303
-
" (double quote), \ (backslash) and NUL's are escaped
304
-
with a backslash automatically.
305
-
</para>
306
-
<note>
307
-
<para>
308
-
In PHP 4, also <varname>$_ENV</varname>
309
-
variables are escaped.
310
-
</para>
311
-
</note>
312
-
<note>
313
-
<para>
314
-
If the <link linkend="ini.magic-quotes-sybase">
315
-
magic_quotes_sybase</link> directive is also ON it will
316
-
completely override magic_quotes_gpc. Having both directives
317
-
enabled means only single quotes are escaped as
318
-
<emphasis>''</emphasis>. Double quotes, backslashes and
319
-
NUL's will remain untouched and unescaped.
320
-
</para>
321
-
</note>
322
-
<para>
323
-
See also <function>get_magic_quotes_gpc</function>
324
-
</para>
325
-
</listitem>
326
-
</varlistentry>
327
-
328
-
<varlistentry xml:id="ini.magic-quotes-runtime">
329
-
<term>
330
-
<parameter>magic_quotes_runtime</parameter>
331
-
<type>boolean</type>
332
-
</term>
333
-
<listitem>
334
-
&warn.deprecated.feature-5-3-0.removed-5-4-0;
335
-
<para>
336
-
If <parameter>magic_quotes_runtime</parameter> is enabled,
337
-
most functions that return data from any sort of external
338
-
source including databases and text files will have quotes
339
-
escaped with a backslash. If
340
-
<link linkend="ini.magic-quotes-sybase">magic_quotes_sybase</link>
341
-
is also on, a single-quote is escaped with a single-quote instead
342
-
of a backslash.
343
-
</para>
344
-
<para>
345
-
Functions affected by <parameter>magic_quotes_runtime</parameter>
346
-
(does not include functions from PECL):
347
-
<simplelist>
348
-
<member><function>get_meta_tags</function></member>
349
-
<member><function>file_get_contents</function></member>
350
-
<member><function>file</function></member>
351
-
<member><function>fgets</function></member>
352
-
<member><function>fwrite</function></member>
353
-
<member><function>fread</function></member>
354
-
<member><function>fputcsv</function></member>
355
-
<member><function>stream_socket_recvfrom</function></member>
356
-
<member><function>exec</function></member>
357
-
<member><function>system</function></member>
358
-
<member><function>passthru</function></member>
359
-
<member><function>stream_get_contents</function></member>
360
-
<member><function>bzread</function></member>
361
-
<member><function>gzfile</function></member>
362
-
<member><function>gzgets</function></member>
363
-
<member><function>gzwrite</function></member>
364
-
<member><function>gzread</function></member>
365
-
<member><function>exif_read_data</function></member>
366
-
<member><function>dba_insert</function></member>
367
-
<member><function>dba_replace</function></member>
368
-
<member><function>dba_fetch</function></member>
369
-
<member><function>ibase_fetch_row</function></member>
370
-
<member><function>ibase_fetch_assoc</function></member>
371
-
<member><function>ibase_fetch_object</function></member>
372
-
<member><function>mssql_fetch_row</function></member>
373
-
<member><function>mssql_fetch_object</function></member>
374
-
<member><function>mssql_fetch_array</function></member>
375
-
<member><function>mssql_fetch_assoc</function></member>
376
-
<member><function>mysqli_fetch_row</function></member>
377
-
<member><function>mysqli_fetch_array</function></member>
378
-
<member><function>mysqli_fetch_assoc</function></member>
379
-
<member><function>mysqli_fetch_object</function></member>
380
-
<member><function>pg_fetch_row</function></member>
381
-
<member><function>pg_fetch_assoc</function></member>
382
-
<member><function>pg_fetch_array</function></member>
383
-
<member><function>pg_fetch_object</function></member>
384
-
<member><function>pg_fetch_all</function></member>
385
-
<member><function>pg_select</function></member>
386
-
<member><function>sybase_fetch_object</function></member>
387
-
<member><function>sybase_fetch_array</function></member>
388
-
<member><function>sybase_fetch_assoc</function></member>
389
-
<member><function>SplFileObject::fgets</function></member>
390
-
<member><function>SplFileObject::fgetcsv</function></member>
391
-
<member><function>SplFileObject::fwrite</function></member>
392
-
</simplelist>
393
-
</para>
394
-
</listitem>
395
-
</varlistentry>
396
-
397
295
<varlistentry xml:id="ini.zend.enable-gc">
398
296
<term>
399
297
<parameter>zend.enable_gc</parameter>
400
-
<type>boolean</type>
298
+
<type>bool</type>
401
299
</term>
402
300
<listitem>
403
301
<para>
404
302