From cf696224661626226283cb5607b7aa0bcd96caaa Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E6=AD=A6=E7=94=B0=20=E6=86=B2=E5=A4=AA=E9=83=8E?=
 <takeda@youmind.jp>
Date: Thu, 29 Oct 2026 23:09:20 +0900
Subject: [PATCH] =?UTF-8?q?simplexml=20=E3=82=92=E5=8E=9F=E6=96=87?=
 =?UTF-8?q?=E3=81=AE=E5=A4=89=E6=9B=B4=E3=81=AB=E8=BF=BD=E5=BE=93=20(3?=
 =?UTF-8?q?=E3=83=95=E3=82=A1=E3=82=A4=E3=83=AB)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../functions/simplexml-import-dom.xml        | 14 +++----
 .../functions/simplexml-load-file.xml         | 38 +++++++++++++++++--
 .../functions/simplexml-load-string.xml       | 38 +++++++++++++++++--
 3 files changed, 77 insertions(+), 13 deletions(-)

diff --git a/reference/simplexml/functions/simplexml-import-dom.xml b/reference/simplexml/functions/simplexml-import-dom.xml
index cf609b3866..83215643e9 100644
--- a/reference/simplexml/functions/simplexml-import-dom.xml
+++ b/reference/simplexml/functions/simplexml-import-dom.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: c142be811735a5542c8a2e4c4ed2f81e8cc3acc6 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: c334a640e0361bba18b861ffe519fbc3faa544a5 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka -->
 <refentry xml:id="function.simplexml-import-dom" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -36,12 +36,12 @@
     <varlistentry>
      <term><parameter>class_name</parameter></term>
      <listitem>
-      <para>
+      <simpara>
        このオプションパラメータを使用すると、
        <function>simplexml_import_dom</function>
        は指定したクラスのオブジェクトを返します。このクラスは
        <type>SimpleXMLElement</type> を継承していなければなりません。
-      </para>
+      </simpara>
      </listitem>
     </varlistentry>
    </variablelist>
@@ -62,6 +62,10 @@
    非XMLまたは非HTMLの<parameter>node</parameter>が渡された場合、
    <classname>TypeError</classname>をスローします。
   </simpara>
+  <simpara>
+   <parameter>class_name</parameter> が <classname>SimpleXMLElement</classname>
+   でもそのサブクラスでもない場合、<exceptionname>TypeError</exceptionname> をスローします。
+  </simpara>
  </refsect1>
 
  <refsect1 role="changelog">
@@ -104,10 +108,6 @@
 <?php
 $dom = new DOMDocument;
 $dom->loadXML('<books><book><title>blah</title></book></books>');
-if (!$dom) {
-    echo 'ドキュメントのパース時にエラーが発生しました';
-    exit;
-}
 
 $s = simplexml_import_dom($dom);
 
diff --git a/reference/simplexml/functions/simplexml-load-file.xml b/reference/simplexml/functions/simplexml-load-file.xml
index 6cf4e5ecef..34dfbebfab 100644
--- a/reference/simplexml/functions/simplexml-load-file.xml
+++ b/reference/simplexml/functions/simplexml-load-file.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: c142be811735a5542c8a2e4c4ed2f81e8cc3acc6 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: c334a640e0361bba18b861ffe519fbc3faa544a5 Maintainer: takagi Status: ready -->
 <!-- CREDITS: hirokawa,shimooka,mumumu -->
 <refentry xml:id="function.simplexml-load-file" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -83,9 +83,14 @@
    &return.falseforfailure;。
   </para>
   &return.falseproblem;
+  <simpara>
+   <parameter>options</parameter> に <constant>LIBXML_RECOVER</constant> を指定した場合は、
+   空でない入力からルート要素を復元できなくても &false; を返しません。
+   代わりに、初期化されていない <classname>SimpleXMLElement</classname> を返します。
+  </simpara>
  </refsect1>
 
- <refsect1 role="errors"><!-- {{{ -->
+ <refsect1 role="errors">
   &reftitle.errors;
   <para>
    XML データ内でエラーが見つかるたびに <constant>E_WARNING</constant>
@@ -97,7 +102,34 @@
     後から <function>libxml_get_errors</function> で取得することもできます。
    </para>
   </tip>
- </refsect1><!-- }}} -->
+  <simpara>
+   <parameter>options</parameter> が <type>int</type> の範囲に収まらない場合、
+   <exceptionname>ValueError</exceptionname> をスローします。
+  </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.0.0</entry>
+      <entry>
+       <parameter>options</parameter> が <type>int</type> の範囲に収まらない場合、
+       <exceptionname>ValueError</exceptionname> をスローするようになりました。
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
  
  <refsect1 role="examples">
   &reftitle.examples;
diff --git a/reference/simplexml/functions/simplexml-load-string.xml b/reference/simplexml/functions/simplexml-load-string.xml
index ee8881a27b..3fab39bdda 100644
--- a/reference/simplexml/functions/simplexml-load-string.xml
+++ b/reference/simplexml/functions/simplexml-load-string.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 17c238517825dfb7ec3edfef5972acd944ffbc1e Maintainer: takagi Status: ready -->
+<!-- EN-Revision: c334a640e0361bba18b861ffe519fbc3faa544a5 Maintainer: takagi Status: ready -->
 <!-- CREDITS: hirokawa,shimooka,mumumu -->
 <refentry xml:id="function.simplexml-load-string" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -83,9 +83,14 @@
    &return.falseforfailure;。
   </para>
   &return.falseproblem;
+  <simpara>
+   <parameter>options</parameter> に <constant>LIBXML_RECOVER</constant> を指定した場合は、
+   空でない入力からルート要素を復元できなくても &false; を返しません。
+   代わりに、初期化されていない <classname>SimpleXMLElement</classname> を返します。
+  </simpara>
  </refsect1>
 
- <refsect1 role="errors"><!-- {{{ -->
+ <refsect1 role="errors">
   &reftitle.errors;
   <para>
    XML データ内でエラーが見つかるたびに <constant>E_WARNING</constant>
@@ -97,7 +102,34 @@
     後から <function>libxml_get_errors</function> で取得することもできます。
    </para>
   </tip>
- </refsect1><!-- }}} -->
+  <simpara>
+   <parameter>options</parameter> が <type>int</type> の範囲に収まらない場合、
+   <exceptionname>ValueError</exceptionname> をスローします。
+  </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.0.0</entry>
+      <entry>
+       <parameter>options</parameter> が <type>int</type> の範囲に収まらない場合、
+       <exceptionname>ValueError</exceptionname> をスローするようになりました。
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
 
  <refsect1 role="examples">
   &reftitle.examples;