Author: Louis-Arnaud (lacatoire)
Committer: GitHub (web-flow)
Pusher: lacatoire
Date: 2026-10-02T22:58:20+02:00
Commit: https://github.com/php/doc-en/commit/81c6888bd2e0894ff5e7804f10e165ed83ee06ed
Raw diff: https://github.com/php/doc-en/commit/81c6888bd2e0894ff5e7804f10e165ed83ee06ed.diff
xsl: document the namespace argument of XSLTProcessor parameter methods in PHP 8.5 (#5903)
Changed paths:
M reference/xsl/xsltprocessor/getparameter.xml
M reference/xsl/xsltprocessor/removeparameter.xml
M reference/xsl/xsltprocessor/setparameter.xml
Diff:
diff --git a/reference/xsl/xsltprocessor/getparameter.xml
b/reference/xsl/xsltprocessor/getparameter.xml
index ec94906bda51..3403055ff214 100644
--- a/reference/xsl/xsltprocessor/getparameter.xml
+++ b/reference/xsl/xsltprocessor/getparameter.xml
@@ -46,6 +46,40 @@
The value of the parameter (as a string), or &false; if it's not set.
</para>
</refsect1>
+ <refsect1 role="errors">
+ &reftitle.errors;
+ <simpara>
+ Throws a <exceptionname>ValueError</exceptionname> if
+ <parameter>namespace</parameter> is not empty and
<parameter>name</parameter>
+ uses Clark notation or is a QName.
+ </simpara>
+ </refsect1>
+
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>8.5.0</entry>
+ <entry>
+ The <parameter>namespace</parameter> argument now takes effect;
+ previously it was ignored.
+ A <exceptionname>ValueError</exceptionname> is now thrown if
+ <parameter>namespace</parameter> is not empty and
<parameter>name</parameter>
+ uses Clark notation or is a QName.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
diff --git a/reference/xsl/xsltprocessor/removeparameter.xml
b/reference/xsl/xsltprocessor/removeparameter.xml
index 7ecaab42efc8..9cc0c13461da 100644
--- a/reference/xsl/xsltprocessor/removeparameter.xml
+++ b/reference/xsl/xsltprocessor/removeparameter.xml
@@ -46,6 +46,40 @@
&return.success;
</para>
</refsect1>
+ <refsect1 role="errors">
+ &reftitle.errors;
+ <simpara>
+ Throws a <exceptionname>ValueError</exceptionname> if
+ <parameter>namespace</parameter> is not empty and
<parameter>name</parameter>
+ uses Clark notation or is a QName.
+ </simpara>
+ </refsect1>
+
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>8.5.0</entry>
+ <entry>
+ The <parameter>namespace</parameter> argument now takes effect;
+ previously it was ignored.
+ A <exceptionname>ValueError</exceptionname> is now thrown if
+ <parameter>namespace</parameter> is not empty and
<parameter>name</parameter>
+ uses Clark notation or is a QName.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
diff --git a/reference/xsl/xsltprocessor/setparameter.xml
b/reference/xsl/xsltprocessor/setparameter.xml
index 0bede24ffe69..1418ae4cbcba 100644
--- a/reference/xsl/xsltprocessor/setparameter.xml
+++ b/reference/xsl/xsltprocessor/setparameter.xml
@@ -76,6 +76,11 @@
Throws a <exceptionname>ValueError</exceptionname> if any of the arguments
contain null bytes.
</simpara>
+ <simpara>
+ Throws a <exceptionname>ValueError</exceptionname> if
+ <parameter>namespace</parameter> is not empty and
<parameter>name</parameter>
+ (or one of its keys, if it is an array) uses Clark notation or is a QName.
+ </simpara>
</refsect1>
<refsect1 role="changelog">
@@ -89,6 +94,16 @@
</row>
</thead>
<tbody>
+ <row>
+ <entry>8.5.0</entry>
+ <entry>
+ The <parameter>namespace</parameter> argument now takes effect;
+ previously it was ignored.
+ A <exceptionname>ValueError</exceptionname> is now thrown if
+ <parameter>namespace</parameter> is not empty and
<parameter>name</parameter>
+ (or one of its keys, if it is an array) uses Clark notation or is a QName.
+ </entry>
+ </row>
<row>
<entry>8.4.0</entry>
<entry>