[doc-en] master: Document the behavior and precedence of host- and path-specific php.ini sections (#6010)

Author: KentarouTakeda (KentarouTakeda) Committer: GitHub (web-flow) Pusher: lacatoire Date: 2026-10-24T08:06:43+02:00 Commit: https://github.com/php/doc-en/commit/8a5e58e3c32ae67a444be6795dbf66f8df553c21 Raw diff: https://github.com/php/doc-en/commit/8a5e58e3c32ae67a444be6795dbf66f8df553c21.diff Document the behavior and precedence of host- and path-specific php.ini sections (#6010) Changed paths: M appendices/ini.sections.xml Diff: diff --git a/appendices/ini.sections.xml b/appendices/ini.sections.xml index e167ea61ea71..b233ae5f5a7a 100644 --- a/appendices/ini.sections.xml +++ b/appendices/ini.sections.xml @@ -17,6 +17,22 @@ <link linkend="ini.extension">extension</link> and <link linkend="ini.zend-extension">zend_extension</link> directives. </para> + <simpara> + Directives set in these sections cannot be overridden by + <link linkend="configuration.file.per-user">.user.ini</link> files + or at runtime, like those set with + <link linkend="configuration.changes.apache">php_admin_value</link>. + </simpara> + <simpara> + Regardless of their order in &php.ini;, + <link linkend="ini.per-path">[PATH=]</link> takes precedence over + <link linkend="ini.per-host">[HOST=]</link>, + and a deeper path over a shallower one. + With <link linkend="install.fpm">PHP-FPM</link>, + these sections also take precedence over the pool configuration + and FastCGI parameters, including <literal>php_admin_value</literal> + and <literal>PHP_ADMIN_VALUE</literal>. + </simpara> <para> <table> <title>Sections</title>