[doc-en] master: xsl: document the namespace argument of XSLTProcessor parameter methods in PHP 8.5 (#5903)

From: Date: Fri, 02 Oct 2026 20:58:23 +0000
Subject: [doc-en] master: xsl: document the namespace argument of XSLTProcessor parameter methods in PHP 8.5 (#5903)
Groups: php.doc.cvs 
Request: Send a blank email to doc-cvs+get-23806@lists.php.net to get a copy of this message
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>


Thread (1 message)

  • Louis-Arnaud via GitHub
« previous php.doc.cvs (#23806) next »