From a811ff39eb3d858e3fde3b99600230938686ebf3 Mon Sep 17 00:00:00 2001
From: Louis-Arnaud <la.catoire@gmail.com>
Date: Fri, 10 Jul 2026 12:13:10 +0200
Subject: [PATCH] ext/simplexml: Document that get methods and string casts no
 longer implicitly rewind

---
 reference/simplexml/simplexmlelement.xml        | 12 ++++++++++++
 reference/simplexml/simplexmlelement/rewind.xml | 11 +++++++++++
 2 files changed, 23 insertions(+)

diff --git a/reference/simplexml/simplexmlelement.xml b/reference/simplexml/simplexmlelement.xml
index 244271b92601..7d901c0388b2 100644
--- a/reference/simplexml/simplexmlelement.xml
+++ b/reference/simplexml/simplexmlelement.xml
@@ -56,6 +56,18 @@
       </row>
      </thead>
      <tbody>
+      <row>
+       <entry>8.4.0</entry>
+       <entry>
+        Get methods (such as
+        <methodname>SimpleXMLElement::asXML</methodname> or
+        <methodname>SimpleXMLElement::getName</methodname>) and casting a
+        <classname>SimpleXMLElement</classname> to a &string; no longer
+        implicitly rewind the iterator.
+        The iterator must now be rewound explicitly, using
+        <methodname>SimpleXMLElement::rewind</methodname>, where needed.
+       </entry>
+      </row>
       <row>
        <entry>8.0.0</entry>
        <entry>
diff --git a/reference/simplexml/simplexmlelement/rewind.xml b/reference/simplexml/simplexmlelement/rewind.xml
index 8caf94997d8f..1a73c2710751 100644
--- a/reference/simplexml/simplexmlelement/rewind.xml
+++ b/reference/simplexml/simplexmlelement/rewind.xml
@@ -22,6 +22,17 @@
   <para>
    This method rewinds the <classname>SimpleXMLElement</classname> to the first element.
   </para>
+
+  <note>
+   <simpara>
+    As of PHP 8.4.0, calling get methods (such as
+    <methodname>SimpleXMLElement::asXML</methodname> or
+    <methodname>SimpleXMLElement::getName</methodname>) or casting a
+    <classname>SimpleXMLElement</classname> to a &string; no longer
+    implicitly rewinds the iterator. Where required, the iterator must be
+    rewound explicitly by calling this method.
+   </simpara>
+  </note>
  </refsect1>
 
  <refsect1 role="parameters">