[doc-en] master: [fpm] Document PHP 8.5 FPM changes: fastcgi.script_path_encoded and access log limit (#5855)

Author: Louis-Arnaud (lacatoire) Committer: GitHub (web-flow) Pusher: lacatoire Date: 2026-11-02T10:07:09+01:00 Commit: https://github.com/php/doc-en/commit/5b4bfdfc809de5b31fcce97b2c9ee19a9c518fd8 Raw diff: https://github.com/php/doc-en/commit/5b4bfdfc809de5b31fcce97b2c9ee19a9c518fd8.diff [fpm] Document PHP 8.5 FPM changes: fastcgi.script_path_encoded and access log limit (#5855) * [fpm] Document PHP 8.5 FPM changes: fastcgi.script_path_encoded and access log limit * Link ProxyPass to the Apache documentation * Use a url.apache.proxy entity for the ProxyPass link Changed paths: M appendices/migration85/other-changes.xml M entities/entities.url.ent M install/fpm/configuration.xml Diff: diff --git a/appendices/migration85/other-changes.xml b/appendices/migration85/other-changes.xml index 4f5669fee068..503855ef7757 100644 --- a/appendices/migration85/other-changes.xml +++ b/appendices/migration85/other-changes.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<sect1 xml:id="migration85.other-changes"> +<sect1 xml:id="migration85.other-changes" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Other Changes</title> <sect2 xml:id="migration85.other-changes.core"> @@ -67,9 +67,12 @@ <title>FPM</title> <simpara> - FPM with httpd ProxyPass optionally decodes the full script path. Added - <!-- <link linkend="ini.fastcgi.script_path_encoded"-->fastcgi.script_path_encoded<!-- </link> --> - INI setting to prevent this new behavior. + FPM with httpd + <link xlink:href="&url.apache.proxy;#proxypass"><literal>ProxyPass</literal></link> + can optionally decode the full script path as of PHP 8.5.0. + The new <link linkend="ini.fastcgi.script-path-encoded">fastcgi.script_path_encoded</link> + <literal>INI</literal> setting controls this behavior; it defaults to <literal>1</literal> to preserve + the previous behavior of not decoding the path. </simpara> <simpara> diff --git a/entities/entities.url.ent b/entities/entities.url.ent index e4c2c69d39ae..4cd079c9c60c 100644 --- a/entities/entities.url.ent +++ b/entities/entities.url.ent @@ -39,6 +39,7 @@ URLs, other addresses and external references. <entity name="url.apache.cgi">https://httpd.apache.org/docs/current/howto/cgi.html</entity> <entity name="url.apache.core">https://httpd.apache.org/docs/current/mod/core.html</entity> <entity name="url.apache.fcgid">https://httpd.apache.org/mod_fcgid/</entity> +<entity name="url.apache.proxy">https://httpd.apache.org/docs/current/mod/mod_proxy.html</entity> <entity name="url.apache.source">https://httpd.apache.org/download.cgi</entity> <entity name="url.apache2.docs">https://httpd.apache.org/docs/current/</entity> <entity name="url.apache2.mpm">https://httpd.apache.org/docs/current/mpm.html</entity> diff --git a/install/fpm/configuration.xml b/install/fpm/configuration.xml index 566e07378c7d..e45f610e4631 100644 --- a/install/fpm/configuration.xml +++ b/install/fpm/configuration.xml @@ -808,10 +808,32 @@ <type>string</type> </term> <listitem> - <para> + <simpara> The access log file. - Default value: not set - </para> + Default value: not set. + </simpara> + <simpara> + As of PHP 8.5.0, the access log line length limit respects the + global <link linkend="log-limit">log_limit</link> setting. + </simpara> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.fastcgi.script-path-encoded"> + <term> + <parameter>fastcgi.script_path_encoded</parameter> + <type>bool</type> + </term> + <listitem> + <simpara> + When enabled (<literal>1</literal>, the default as of PHP 8.5.0), + FPM does not URL-decode the <literal>SCRIPT_FILENAME</literal> sent + by httpd + <link xlink:href="&url.apache.proxy;#proxypass"><literal>ProxyPass</literal></link>, + preserving the previous behavior. + Set to <literal>0</literal> to opt into the new behavior where FPM + URL-decodes the full script path. + Available as of PHP 8.5.0. + </simpara> </listitem> </varlistentry> <varlistentry xml:id="access-format">