Remove obsolete PHP 5 specific info from appendices

This commit is contained in:
Christoph M. Becker 2021-05-23 16:50:50 +02:00
parent 24ea750d47
commit 6a5b42e0d3
No known key found for this signature in database
GPG key ID: D66C9593118BCCB6
5 changed files with 55 additions and 182 deletions

View file

@ -73,7 +73,7 @@
</term>
<listitem>
<para>
Enable phpdbg interactive debugger SAPI module support in PHP 5.6.x or later.
Enable phpdbg interactive debugger SAPI module support.
</para>
</listitem>
</varlistentry>
@ -112,100 +112,11 @@
Disable building CGI version of PHP.
</para>
<para>
As of PHP 5.3.0 this argument enables FastCGI which previously
had to be enabled using <literal>--enable-fastcgi</literal>.
This argument also enables FastCGI.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="configure.enable-force-cgi-redirect">
<term>
<option role="configure">--enable-force-cgi-redirect</option>
</term>
<listitem>
<para>
Enable the security check for internal server redirects. You should use
this if you are running the CGI version with Apache.
</para>
<para>
As of PHP 5.3.0 this argument is enabled by default and no longer
exists. To disable this, the
<link linkend="ini.cgi.force-redirect">cgi.force_redirect</link> ini directive
should be set to <literal>0</literal>.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="configure.enable-discard-path">
<term>
<option role="configure">--enable-discard-path</option>
</term>
<listitem>
<para>
If this is enabled, the PHP CGI binary can safely be placed outside of
the web tree and people will not be able to circumvent &htaccess;
security.
</para>
<para>
As of PHP 5.3.0 this argument is disabled by default and no longer
exists. To enable this feature the cgi.discard_path ini directive
must be set to <literal>1</literal>.
</para>
</listitem>
</varlistentry>
<!--<varlistentry xml:id="configure.disable-path-info-check">
<term>
<option role="configure">disable-path-info-check</option>
</term>
<listitem>
<para>
Disables path info checks, disabling paths such as
<literal>/file.php/test?a=b</literal>.
</para>
<para>
As of PHP 5.3.0 this argument is enabled by default and no longer
exists. To disable this, the
<link linkend="ini.cgi.fix-pathinfo">cgi.fix_pathinfo</link> ini directive
should be set to <literal>0</literal>.
</para>
</listitem>
</varlistentry> -->
<varlistentry xml:id="configure.enable-fastcgi">
<term>
<option role="configure">--enable-fastcgi</option>
</term>
<listitem>
<para>
If this is enabled, the CGI module will be built with support for FastCGI
also.
</para>
<para>
As of PHP 5.3.0 this argument no longer exists and is enabled by
<literal>--enable-cgi</literal> instead.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="configure.disable-path-info-check">
<term>
<option role="configure">--disable-path-info-check</option>
</term>
<listitem>
<para>
If this is disabled, paths such as <filename>/info.php/test?a=b</filename>
will fail to work. For more information see the
<link xlink:href="&url.apache.core;#acceptpathinfo">Apache Manual</link>.
</para>
<para>
As of PHP 5.3.0 this argument is enabled by default and no longer exists.
To disable this feature the <link
linkend="ini.cgi.fix-pathinfo">cgi.fix_pathinfo</link> ini directive must
be set to <literal>0</literal>.
</para>
</listitem>
</varlistentry>
</variablelist>
</sect3>

View file

@ -564,7 +564,7 @@ Fatal error: Maximum execution time of 30+2 seconds exceeded (terminated) in Unk
<entry><link linkend="ini.enable-post-data-reading">enable_post_data_reading</link></entry>
<entry>"1"</entry>
<entry>PHP_INI_PERDIR</entry>
<entry>Available as of PHP 5.4.0</entry>
<entry></entry>
</row>
<row>
<entry><link linkend="ini.post-max-size">post_max_size</link></entry>
@ -1643,7 +1643,7 @@ include_path = ".:${USER}/pear/php"
<listitem>
<para>
The maximum number of files allowed to be uploaded simultaneously.
Starting with PHP 5.3.4, upload fields left blank on submission do not
Upload fields left blank on submission do not
count towards this limit.
</para>
</listitem>

View file

@ -16,12 +16,9 @@
<simpara>
These words have special meaning in PHP. Some of them represent things
which look like functions, some look like constants, and so on - but
they're not, really: they are language constructs. You cannot use any
of the following words as constants, class names, function or method names.
Using them as variable names is generally OK, but could lead to confusion.
</simpara>
<simpara>
As of PHP 7.0.0 these keywords are allowed as property, constant, and
they're not, really: they are language constructs.
The following words cannot be used as constants, class names, function or method names.
They are, however, allowed as property, constant, and
method names of classes, interfaces and traits, except that
<literal>class</literal> may not be used as constant name.
</simpara>
@ -52,7 +49,7 @@
<link linkend="control-structures.break">break</link>
</entry>
<entry>
<link linkend="language.types.callable">callable</link> (as of PHP 5.4)
<link linkend="language.types.callable">callable</link>
</entry>
<entry>
<link linkend="control-structures.switch">case</link>
@ -137,7 +134,7 @@
<link linkend="language.oop5.final">final</link>
</entry>
<entry>
<link linkend="language.exceptions">finally</link> (as of PHP 5.5)
<link linkend="language.exceptions">finally</link>
</entry>
<entry>
<link linkend="functions.arrow">fn</link> (as of PHP 7.4)
@ -157,7 +154,7 @@
<link linkend="language.variables.scope">global</link>
</entry>
<entry>
<link linkend="control-structures.goto">goto</link> (as of PHP 5.3)
<link linkend="control-structures.goto">goto</link>
</entry>
<entry>
<link linkend="control-structures.if">if</link>
@ -177,7 +174,7 @@
<link linkend="language.operators.type">instanceof</link>
</entry>
<entry>
<link linkend="language.oop5.traits.conflict">insteadof</link> (as of PHP 5.4)
<link linkend="language.oop5.traits.conflict">insteadof</link>
</entry>
<entry>
<link linkend="language.oop5.interfaces">interface</link>
@ -194,7 +191,7 @@
<link linkend="control-structures.match">match</link> (as of PHP 8.0)
</entry>
<entry>
<link linkend="language.namespaces">namespace</link> (as of PHP 5.3)
<link linkend="language.namespaces">namespace</link>
</entry>
<entry>
<link linkend="language.oop5.basic.new">new</link>
@ -239,7 +236,7 @@
<link linkend="language.exceptions">throw</link>
</entry>
<entry>
<link linkend="language.oop5.traits">trait</link> (as of PHP 5.4)
<link linkend="language.oop5.traits">trait</link>
</entry>
<entry>
<link linkend="language.exceptions">try</link>
@ -262,10 +259,10 @@
<link linkend="language.operators.logical">xor</link>
</entry>
<entry>
<link linkend="language.generators">yield</link> (as of PHP 5.5)
<link linkend="language.generators">yield</link>
</entry>
<entry>
<link linkend="control-structures.yield.from">yield from</link> (as of PHP 7.0)
<link linkend="control-structures.yield.from">yield from</link>
</entry>
</row>
</tbody>
@ -281,7 +278,7 @@
<link linkend="language.constants.predefined">__CLASS__</link>
</entry>
<entry>
<link linkend="language.constants.predefined">__DIR__</link> (as of PHP 5.3)
<link linkend="language.constants.predefined">__DIR__</link>
</entry>
<entry>
<link linkend="language.constants.predefined">__FILE__</link>
@ -298,10 +295,10 @@
</row>
<row>
<entry>
<link linkend="language.namespaces.nsconstants">__NAMESPACE__</link> (as of PHP 5.3)
<link linkend="language.namespaces.nsconstants">__NAMESPACE__</link>
</entry>
<entry>
<link linkend="language.constants.predefined">__TRAIT__</link> (as of PHP 5.4)
<link linkend="language.constants.predefined">__TRAIT__</link>
</entry>
<entry>
</entry>
@ -358,18 +355,6 @@
</simpara>
</listitem>
</varlistentry>
</variablelist>
</sect2>
<sect2 xml:id="reserved.classes.php5">
<title>Predefined classes as of PHP 5</title>
<simpara>
These additional predefined classes were introduced in
PHP 5.0.0.
</simpara>
<variablelist>
<varlistentry>
<term><classname>Exception</classname></term>
<listitem>
@ -392,46 +377,26 @@
</simpara>
</listitem>
</varlistentry>
</variablelist>
</sect2>
<sect2 xml:id="reserved.classes.closure">
<title>Closure</title>
<simpara>
The predefined final class <classname>Closure</classname> was introduced
in PHP 5.3.0. It is used for representing <link
linkend="functions.anonymous">anonymous functions</link>.
</simpara>
<simpara>
For more information, see its <link linkend="class.closure">class
page</link>.
</simpara>
</sect2>
<sect2 xml:id="reserved.classes.generator">
<title>Generator</title>
<simpara>
The predefined final class <classname>Generator</classname> was introduced
in PHP 5.5.0. It is used for representing <link
linkend="language.generators">generators</link>.
</simpara>
<simpara>
For more information, see its <link linkend="class.generator">class
page</link>.
</simpara>
</sect2>
<sect2 xml:id="reserved.classes.php7">
<title>Predefined interfaces and classes as of PHP 7</title>
<simpara>
These additional predefined interfaces and classes were introduced in
PHP 7.0.0.
</simpara>
<variablelist>
<varlistentry>
<term><classname>Closure</classname></term>
<listitem>
<simpara>
The predefined final class <classname>Closure</classname>
is used for representing <link
linkend="functions.anonymous">anonymous functions</link>.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><classname>Generator</classname></term>
<listitem>
<simpara>
The predefined final class <classname>Generator</classname>
is used for representing <link
linkend="language.generators">generators</link>.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><classname>ArithmeticError</classname></term>
<listitem>
@ -538,27 +503,27 @@
<tbody>
<row>
<entry>
int (as of PHP 7)
int
</entry>
<entry>
float (as of PHP 7)
float
</entry>
<entry>
bool (as of PHP 7)
bool
</entry>
<entry>
string (as of PHP 7)
string
</entry>
</row>
<row>
<entry>
true (as of PHP 7)
true
</entry>
<entry>
false (as of PHP 7)
false
</entry>
<entry>
null (as of PHP 7)
null
</entry>
<entry>
void (as of PHP 7.1)
@ -589,13 +554,13 @@
<tbody>
<row>
<entry>
resource (as of PHP 7)
resource
</entry>
<entry>
mixed (as of PHP 7)
mixed
</entry>
<entry>
numeric (as of PHP 7)
numeric
</entry>
<entry>
</entry>

View file

@ -19,10 +19,8 @@
<para>
T_* constants values are automatically generated based on PHP's underlying parser infrastructure.
This means that the concrete value of a token may change between two PHP
versions. For example the <constant>T_FILE</constant> constant is
<literal>365</literal> in PHP 5.3, while the same value refers now to
<constant>T_TRAIT</constant> in PHP 5.4 and the value of <constant>T_FILE</constant>
is <literal>369</literal>. This means that your code should never rely directly
versions.
This means that your code should never rely directly
on the original T_* values taken from PHP version X.Y.Z, to provide some compatibility
across multiple PHP versions.
</para>

View file

@ -84,9 +84,9 @@
these configuration options. If your web server does not allow
you to do redirects, or the server does not have a way to
communicate to the PHP binary that the request is a safely
redirected request, you can specify the option <link
linkend="configure.enable-force-cgi-redirect">--enable-force-cgi-redirect</link>
to the configure script. You still have to make sure your PHP
redirected request, you can enable the
<link linkend="ini.cgi.force-redirect">cgi.force_redirect</link>
ini directive. You still have to make sure your PHP
scripts do not rely on one or another way of calling the script,
neither by directly <filename
role="php">http://my.host/cgi-bin/php/dir/script.php</filename>
@ -216,9 +216,8 @@ AddHandler php-script .php
<para>
To get PHP to handle <envar>PATH_INFO</envar> and
<envar>PATH_TRANSLATED</envar> information correctly with this
setup, the PHP parser should be compiled with the <link
linkend="configure.enable-discard-path">--enable-discard-path</link>
configure option.
setup, the <link linkend="ini.cgi.discard-path">cgi.discard_path</link>
ini directive has to be enabled.
</para>
</sect1>