[doc-en] master: Document DOM node collection cloning failure for PHP 8.5 (#5877)

Author: Louis-Arnaud (lacatoire) Committer: GitHub (web-flow) Pusher: lacatoire Date: 2026-09-24T22:57:00+02:00 Commit: https://github.com/php/doc-en/commit/38fcf6262ae5eceb1162dc271a510e882b1d4a13 Raw diff: https://github.com/php/doc-en/commit/38fcf6262ae5eceb1162dc271a510e882b1d4a13.diff Document DOM node collection cloning failure for PHP 8.5 (#5877) Add changelog entries noting that cloning DOMNamedNodeMap, DOMNodeList, Dom\NamedNodeMap, Dom\NodeList, Dom\HTMLCollection and Dom\DtdNamedNodeMap objects now fails. Changed paths: M reference/dom/dom/dom-dtdnamednodemap.xml M reference/dom/dom/dom-htmlcollection.xml M reference/dom/dom/dom-namednodemap.xml M reference/dom/dom/dom-nodelist.xml M reference/dom/domnamednodemap.xml M reference/dom/domnodelist.xml Diff: diff --git a/reference/dom/dom/dom-dtdnamednodemap.xml b/reference/dom/dom/dom-dtdnamednodemap.xml index b216788a576f..76c5c35972fe 100644 --- a/reference/dom/dom/dom-dtdnamednodemap.xml +++ b/reference/dom/dom/dom-dtdnamednodemap.xml @@ -10,7 +10,9 @@ &reftitle.intro; <simpara> Represents a named node map for entities and notation nodes of the - <acronym>DTD</acronym>. + <acronym>DTD</acronym>. It is similar to <classname>Dom\NamedNodeMap</classname>, + but restricted to <classname>Dom\Entity</classname> and + <classname>Dom\Notation</classname> nodes. </simpara> </section> @@ -59,6 +61,28 @@ </variablelist> </section> + <section 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> + Cloning a <classname>Dom\DtdNamedNodeMap</classname> object now fails. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </section> + </partintro> <!-- &reference.dom.dom.entities.dtdnamednodemap; --> diff --git a/reference/dom/dom/dom-htmlcollection.xml b/reference/dom/dom/dom-htmlcollection.xml index c356292664f1..1ffff1aa286f 100644 --- a/reference/dom/dom/dom-htmlcollection.xml +++ b/reference/dom/dom/dom-htmlcollection.xml @@ -9,7 +9,9 @@ <section xml:id="dom-htmlcollection.intro"> &reftitle.intro; <simpara> - Represents a static set of elements. + Represents a static set of elements. It is similar to + <classname>Dom\NodeList</classname>, but restricted to + <classname>Dom\Element</classname> nodes. </simpara> </section> @@ -56,6 +58,28 @@ </variablelist> </section> + <section 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> + Cloning a <classname>Dom\HTMLCollection</classname> object now fails. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </section> + <section role="notes"> &reftitle.notes; &dom.note.modern.utf8; diff --git a/reference/dom/dom/dom-namednodemap.xml b/reference/dom/dom/dom-namednodemap.xml index d4866224e908..5f57a721bb5a 100644 --- a/reference/dom/dom/dom-namednodemap.xml +++ b/reference/dom/dom/dom-namednodemap.xml @@ -9,7 +9,8 @@ <section xml:id="dom-namednodemap.intro"> &reftitle.intro; <simpara> - Represents the set of attributes on an element. + Represents the set of attributes on an element. This is the modern, + spec-compliant equivalent of <classname>DOMNamedNodeMap</classname>. </simpara> </section> @@ -56,6 +57,28 @@ </variablelist> </section> + <section 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> + Cloning a <classname>Dom\NamedNodeMap</classname> object now fails. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </section> + <section role="notes"> &reftitle.notes; &dom.note.modern.utf8; diff --git a/reference/dom/dom/dom-nodelist.xml b/reference/dom/dom/dom-nodelist.xml index c2e25101105c..006d0a71d047 100644 --- a/reference/dom/dom/dom-nodelist.xml +++ b/reference/dom/dom/dom-nodelist.xml @@ -52,6 +52,28 @@ </varlistentry> </variablelist> </section> + + <section 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> + Cloning a <classname>Dom\NodeList</classname> object now fails. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </section> </partintro> <!-- &reference.dom.dom.entities.nodelist; --> diff --git a/reference/dom/domnamednodemap.xml b/reference/dom/domnamednodemap.xml index ddca92b7890b..579d0a21f64f 100644 --- a/reference/dom/domnamednodemap.xml +++ b/reference/dom/domnamednodemap.xml @@ -84,6 +84,12 @@ Remove me once you perform substitutions </row> </thead> <tbody> + <row> + <entry>8.5.0</entry> + <entry> + Cloning a <classname>DOMNamedNodeMap</classname> object now fails. + </entry> + </row> <row> <entry>8.0.0</entry> <entry> diff --git a/reference/dom/domnodelist.xml b/reference/dom/domnodelist.xml index 360c159c1e3b..9ef5b32b01be 100644 --- a/reference/dom/domnodelist.xml +++ b/reference/dom/domnodelist.xml @@ -77,6 +77,12 @@ Remove me once you perform substitutions </row> </thead> <tbody> + <row> + <entry>8.5.0</entry> + <entry> + Cloning a <classname>DOMNodeList</classname> object now fails. + </entry> + </row> <row> <entry>8.0.0</entry> <entry>