Skip to content

Commit 5bcce7d

Browse files
committed
document PHP 8.5.0 ini directive deprecations and removals
1 parent 1786db6 commit 5bcce7d

File tree

5 files changed

+36
-14
lines changed

5 files changed

+36
-14
lines changed

appendices/ini.core.xml

Lines changed: 19 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,7 @@
6060
<entry><link linkend="ini.disable-classes">disable_classes</link></entry>
6161
<entry>""</entry>
6262
<entry>&php.ini; only</entry>
63-
<entry></entry>
63+
<entry>Removed as of PHP 8.5.0</entry>
6464
</row>
6565
<row>
6666
<entry><link linkend="ini.exit-on-timeout">exit_on_timeout</link></entry>
@@ -229,19 +229,24 @@
229229
<type>string</type>
230230
</term>
231231
<listitem>
232-
<para>
232+
<simpara>
233233
This directive allows certain classes to be disabled.
234234
It takes a comma-delimited list of class names.
235235
Disabling a class just prevents the class's instantiation.
236-
</para>
237-
<para>
236+
</simpara>
237+
<simpara>
238238
Only internal classes can be disabled using this directive.
239239
User-defined classes are unaffected.
240-
</para>
240+
</simpara>
241241
<simpara>
242242
This directive must be set in &php.ini;.
243243
It cannot be set in &httpd.conf;.
244244
</simpara>
245+
<warning>
246+
<simpara>
247+
This directive has been <emphasis>REMOVED</emphasis> as of PHP 8.5.0.
248+
</simpara>
249+
</warning>
245250
</listitem>
246251
</varlistentry>
247252

@@ -587,7 +592,7 @@ Fatal error: Maximum execution time of 30+2 seconds exceeded (terminated) in Unk
587592
<entry><link linkend="ini.register-argc-argv">register_argc_argv</link></entry>
588593
<entry>"1"</entry>
589594
<entry><constant>INI_PERDIR</constant></entry>
590-
<entry></entry>
595+
<entry>Deprecated as of PHP 8.5.0 and will be removed in the future</entry>
591596
</row>
592597
<row>
593598
<entry><link linkend="ini.enable-post-data-reading">enable_post_data_reading</link></entry>
@@ -777,6 +782,14 @@ Fatal error: Maximum execution time of 30+2 seconds exceeded (terminated) in Unk
777782
<simpara>
778783
See also <link linkend="features.commandline">command line</link>.
779784
</simpara>
785+
<warning>
786+
<simpara>
787+
This directive has been <emphasis>DEPRECATED</emphasis> as of PHP 8.5.0 and will be removed in the future.
788+
Configure <literal>register_argc_argv=0</literal> and switch to either <varname>$_GET</varname>
789+
or <varname>$_SERVER['QUERY_STRING']</varname> to access the information,
790+
after verifying that the usage is safe.
791+
</simpara>
792+
</warning>
780793
</listitem>
781794
</varlistentry>
782795

appendices/ini.list.xml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -207,7 +207,7 @@
207207
<entry><link linkend="ini.disable-classes">disable_classes</link></entry>
208208
<entry><literal>""</literal></entry>
209209
<entry>&php.ini; only</entry>
210-
<entry></entry>
210+
<entry>Removed as of PHP 8.5.0</entry>
211211
</row>
212212
<row>
213213
<entry><link linkend="ini.disable-functions">disable_functions</link></entry>
@@ -551,13 +551,13 @@
551551
<entry><link linkend="ini.register-argc-argv">register_argc_argv</link></entry>
552552
<entry><literal>"1"</literal></entry>
553553
<entry><constant>INI_PERDIR</constant></entry>
554-
<entry></entry>
554+
<entry>Deprecated as of PHP 8.5.0 and will be removed in the future</entry>
555555
</row>
556556
<row>
557557
<entry><link linkend="ini.report-memleaks">report_memleaks</link></entry>
558558
<entry><literal>"1"</literal></entry>
559559
<entry><constant>INI_ALL</constant></entry>
560-
<entry></entry>
560+
<entry>Deprecated as of PHP 8.5.0 and will be removed in the future</entry>
561561
</row>
562562
<row>
563563
<entry>report_zend_debug</entry>

features/commandline.xml

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -203,6 +203,11 @@ if (php_sapi_name() === 'cli') {
203203
</informalexample>
204204
</para>
205205
</warning>
206+
<warning>
207+
<simpara>
208+
This directive has been <emphasis>DEPRECATED</emphasis> as of PHP 8.5.0 and will be removed in the future.
209+
</simpara>
210+
</warning>
206211
</entry>
207212
</row>
208213
<row>

install/fpm/configuration.xml

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1027,8 +1027,7 @@ php_admin_value[memory_limit] = 32M
10271027
PHP settings passed with <literal>php_value</literal> or
10281028
<literal>php_flag</literal> will overwrite their previous value.
10291029
Please note that defining
1030-
<link linkend="ini.disable-functions">disable_functions</link> or
1031-
<link linkend="ini.disable-classes">disable_classes</link> will
1030+
<link linkend="ini.disable-functions">disable_functions</link> will
10321031
not overwrite previously defined <filename>php.ini</filename> values,
10331032
but will append the new value instead.
10341033
</para>

reference/errorfunc/ini.xml

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -64,7 +64,7 @@
6464
<entry><link linkend="ini.report-memleaks">report_memleaks</link></entry>
6565
<entry>"1"</entry>
6666
<entry><constant>INI_ALL</constant></entry>
67-
<entry></entry>
67+
<entry>Deprecated as of PHP 8.5.0 and will be removed in the future</entry>
6868
</row>
6969
<row>
7070
<entry><link linkend="ini.track-errors">track_errors</link></entry>
@@ -318,7 +318,7 @@
318318
<type>bool</type>
319319
</term>
320320
<listitem>
321-
<para>
321+
<simpara>
322322
If this parameter is set to On (the default), this parameter will show a
323323
report of memory leaks detected by the Zend memory manager. This report
324324
will be sent to stderr on Posix platforms. On Windows, it will be sent
@@ -327,7 +327,12 @@
327327
This parameter only has effect in a debug build and if
328328
error_reporting includes <constant>E_WARNING</constant> in the allowed
329329
list.
330-
</para>
330+
</simpara>
331+
<warning>
332+
<simpara>
333+
This directive has been <emphasis>DEPRECATED</emphasis> as of PHP 8.5.0 and will be removed in the future.
334+
</simpara>
335+
</warning>
331336
</listitem>
332337
</varlistentry>
333338

0 commit comments

Comments
 (0)