[PHP 8.4] xml,xsl関連機能の翻訳

php · Nov 17, 2024 · bd60b41 · bd60b41
1 parent 8dd96e4
commit bd60b41
Show file tree

Hide file tree

Showing 20 changed files with 319 additions and 61 deletions.
diff --git a/reference/libxml/constants.xml b/reference/libxml/constants.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 8f6fd5c55ab10709a4ff8daf6140dea422c1363c Maintainer: takagi Status: ready -->
+<!-- EN-Revision: eae558e584a4e5f70e5d85b5cebc59e296399924 Maintainer: takagi Status: ready -->
 <!-- CREDITS: hirokawa,mumumu -->
 <appendix xml:id="libxml.constants" xmlns="http://docbook.org/ns/docbook">
  &reftitle.constants;
@@ -48,6 +48,12 @@
     <simpara>
      デフォルトのDTD属性
     </simpara>
+    <caution>
+     <simpara>
+      DTD属性の読み込みを有効にすると、外部エンティティの取得が可能になります。
+      これを防ぐために <constant>LIBXML_NO_XXE</constant> 定数を使用できます(PHP 8.4.0 以降、Libxml &gt;= 2.13.0 でのみ利用可能です)。
+     </simpara>
+    </caution>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.libxml-dtdload">
@@ -59,6 +65,12 @@
     <simpara>
      外部サブセットをロードする
     </simpara>
+    <caution>
+     <simpara>
+      外部サブセットの読み込みを有効にすると、外部エンティティの取得が可能になります。
+      これを防ぐために <constant>LIBXML_NO_XXE</constant> 定数を使用できます(PHP 8.4.0 以降、Libxml &gt;= 2.13.0 でのみ利用可能です)。
+     </simpara>
+    </caution>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.libxml-dtdvalid">
@@ -73,6 +85,7 @@
     <caution>
      <simpara>
       DTD の検証を有効にすると、XML外部エンティティ参照攻撃(XXE) を容易にしてしまうかもしれません。
+      これを防ぐために <constant>LIBXML_NO_XXE</constant> 定数を使用できます(PHP 8.4.0 以降、Libxml &gt;= 2.13.0 でのみ利用可能です)。
      </simpara>
     </caution>
    </listitem>
@@ -228,6 +241,22 @@
     </note>
    </listitem>
   </varlistentry>
+  <varlistentry xml:id="constant.libxml-no-xxe">
+   <term>
+    <constant>LIBXML_NO_XXE</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     エンティティ置換を行う際、XML外部エンティティ参照(XXE)を無効にします
+    </simpara>
+    <note>
+     <para>
+      PHP 8.4.0 以降、Libxml &gt;= 2.13.0 の場合のみ有効
+     </para>
+    </note>
+   </listitem>
+  </varlistentry>
   <varlistentry xml:id="constant.libxml-nsclean">
    <term>
     <constant>LIBXML_NSCLEAN</constant>
@@ -274,6 +303,22 @@
     </note>
    </listitem>
   </varlistentry>
+  <varlistentry xml:id="constant.libxml-recover">
+   <term>
+    <constant>LIBXML_RECOVER</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     ドキュメントをパースする際、リカバリモードを有効にする。
+    </simpara>
+    <note>
+     <para>
+      PHP 8.4.0 以降でのみ有効
+     </para>
+    </note>
+   </listitem>
+  </varlistentry>
   <varlistentry xml:id="constant.libxml-xinclude">
    <term>
     <constant>LIBXML_XINCLUDE</constant>

diff --git a/reference/libxml/functions/libxml-disable-entity-loader.xml b/reference/libxml/functions/libxml-disable-entity-loader.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: f3b5475eebc9a79088559e506d90cd648404bf33 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: eae558e584a4e5f70e5d85b5cebc59e296399924 Maintainer: takagi Status: ready -->
 <!-- Credits: mumumu -->
 
 <refentry xml:id="function.libxml-disable-entity-loader" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -23,11 +23,15 @@
    外部エンティティ読み込み機能の有効/無効を切り替えます。
    外部エンティティの読み込みを無効にすると、
    XML文書を読み込む際に問題が起こる可能性があることに注意して下さい。
-   しかし、libxml 2.9.0 以降では、エンティティの置換はデフォルトで無効になっているため、
-   <constant>LIBXML_NOENT</constant> を使って内部エンティティの参照を解決する必要がない限り、
+  </para>
+  <para>
+   libxml 2.9.0 以降では、エンティティの置換はデフォルトで無効になっているため、<constant>LIBXML_NOENT</constant>,
+   <constant>LIBXML_DTDVALID</constant>, or <constant>LIBXML_DTDLOAD</constant>.
+   を使って内部エンティティの参照を解決する必要がない限り、
    外部エンティティの読み込みを無効にする必要はありません。
    一般的には、外部エンティティの読み込みを抑制するのであれば、
    <function>libxml_set_external_entity_loader</function> を使うことが望ましいです。
+   <constant>LIBXML_NO_XXE</constant> 定数を使ってこれを防ぐこともできます (PHP 8.4.0 以降、Libxml &gt;= 2.13.0 でのみ利用可能)。
   </para>
  </refsect1>
 
@@ -102,7 +106,9 @@
    <simplelist>
     <member><function>libxml_use_internal_errors</function></member>
     <member><function>libxml_set_external_entity_loader</function></member>
-    <member><link linkend="libxml.constants"><constant>LIBXML_NOENT</constant> 定数</link></member>
+    <member>The <constant>LIBXML_NOENT</constant> 定数</member>
+    <member>The <constant>LIBXML_DTDVALID</constant> 定数</member>
+    <member>The <constant>LIBXML_NO_XXE</constant> 定数</member>
    </simplelist>
   </para>
  </refsect1>

diff --git a/reference/libxml/functions/libxml-set-streams-context.xml b/reference/libxml/functions/libxml-set-streams-context.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: f90df97fa5ebfa6e7fcace04976900d6700467cc Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 81bc2b5f454f893206009e0e931a72c85a86ac63 Maintainer: hirokawa Status: ready -->
 <refentry xml:id="function.libxml-set-streams-context" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>libxml_set_streams_context</refname>
@@ -43,6 +43,39 @@
   </para>
  </refsect1>
 
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <simpara>
+   非ストリームリソースが <parameter>context</parameter> に渡された場合、
+   <classname>TypeError</classname> をスローします。
+  </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.4.0</entry>
+      <entry>
+       <function>libxml_set_streams_context</function> は、
+       <parameter>context</parameter> に非ストリームリソースが渡された場合、
+       コンテキストが実際に使用されたときではなく、その場で
+       <exceptionname>TypeError</exceptionname> をスローするようになりました。
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>

diff --git a/reference/libxml/setup.xml b/reference/libxml/setup.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 48ce43fe79fa0c9f31f187ea8ec995b4cb13037e Maintainer: takagi Status: ready -->
+<!-- EN-Revision: b8cefce03356afc96a205de76dac5c9770e78a9d Maintainer: takagi Status: ready -->
 <!-- CREDITS: hirokawa -->
 
 <chapter xml:id="libxml.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -10,8 +10,8 @@
  <section xml:id="libxml.requirements">
   &reftitle.required;
   <para>
-   この拡張モジュールは、PHP 8.0 以降では <link xlink:href="&url.libxml;">libxml</link> &gt;=
-   2.9.0 が必要です。PHP 8.0 より前のバージョンでは、libxml &gt;= 2.6.0 が必要です。
+   この拡張モジュールは、PHP 8.4.0 以降では <link xlink:href="&url.libxml;">libxml</link> &gt;=
+   2.9.4 が、PHP 8.4.0 より前のバージョンでは、libxml &gt;= 2.9.0 が、PHP 8.0.0 より前のバージョンでは libxml &gt;= 2.6.0 が必要です。
   </para>
  </section>
  <!-- }}} -->

diff --git a/reference/simplexml/functions/simplexml-import-dom.xml b/reference/simplexml/functions/simplexml-import-dom.xml
@@ -1,11 +1,11 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: d715365c098db000eaf7dcd987ee6093f6e83091 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 62514381ff35348ffc4061b691132e36adf96210 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka -->
 <refentry xml:id="function.simplexml-import-dom" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>simplexml_import_dom</refname>
-  <refpurpose>DOM ノードから <literal>SimpleXMLElement</literal> オブジェクトを取得する</refpurpose>
+  <refpurpose>XML または HTML ノードから <literal>SimpleXMLElement</literal> オブジェクトを取得する</refpurpose>
  </refnamediv>
  <refsect1 role="description">
   &reftitle.description;
@@ -56,6 +56,38 @@
   </para>
  </refsect1>
 
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <simpara>
+   非XMLまたは非HTMLの<parameter>node</parameter>が渡された場合、
+   <classname>TypeError</classname>をスローします。
+  </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.4.0</entry>
+      <entry>
+       この関数は、非XMLまたは非HTMLの<parameter>node</parameter>が渡された場合、
+       <classname>ValueError</classname> ではなく
+       <classname>TypeError</classname> をスローするようになりました。
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>

diff --git a/reference/xml/constants.xml b/reference/xml/constants.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 5e9500ddad6dbc2f1b01d7da8b53379c8b7c386c Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 9acfa18973f304f8f2d531f28dd12b12c2b84f8b Maintainer: takagi Status: ready -->
 <appendix xml:id="xml.constants" xmlns="http://docbook.org/ns/docbook">
  &reftitle.constants;
  &extension.constants;
@@ -258,6 +258,19 @@
     </simpara>
    </listitem>
   </varlistentry>
+  <varlistentry xml:id="constant.xml-option-parse-huge">
+   <term>
+    <constant>XML_OPTION_PARSE_HUGE</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     PHP 8.4.0 以降で利用可能です。
+     libxml2 &lt; 2.7.0 を利用している場合(例えは PHP 7.x)、
+     このオプションはデフォルトで有効となり、無効化できません。
+    </simpara>
+   </listitem>
+  </varlistentry>
   <varlistentry xml:id="constant.xml-option-target-encoding">
    <term>
     <constant>XML_OPTION_TARGET_ENCODING</constant>

diff --git a/reference/xml/functions/xml-parser-get-option.xml b/reference/xml/functions/xml-parser-get-option.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 9fb00a4cf8563ea56d53cb1f72e2856b68899646 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 9acfa18973f304f8f2d531f28dd12b12c2b84f8b Maintainer: hirokawa Status: ready -->
 <!-- Credits: mumumu -->
 <refentry xml:id="function.xml-parser-get-option" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -37,6 +37,7 @@
      <listitem>
       <simpara>
        取得するオプション。<constant>XML_OPTION_CASE_FOLDING</constant>,
+       <constant>XML_OPTION_PARSE_HUGE</constant>,
        <constant>XML_OPTION_SKIP_TAGSTART</constant>, <constant>XML_OPTION_SKIP_WHITE</constant>
        あるいは <constant>XML_OPTION_TARGET_ENCODING</constant> が使用可能です。
        詳細は <function>xml_parser_set_option</function> を参照ください。

diff --git a/reference/xml/functions/xml-parser-set-option.xml b/reference/xml/functions/xml-parser-set-option.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 9fb00a4cf8563ea56d53cb1f72e2856b68899646 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 9acfa18973f304f8f2d531f28dd12b12c2b84f8b Maintainer: hirokawa Status: ready -->
 <refentry xml:id="function.xml-parser-set-option" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>xml_parser_set_option</refname>
@@ -59,6 +59,16 @@
             </link> を有効にするかどうかを制御する。デフォルトで有効。
            </entry>
           </row>
+          <row>
+           <entry><constant>XML_OPTION_PARSE_HUGE</constant></entry>
+           <entry>bool</entry>
+           <entry>
+            10 MB を超えるドキュメントの解析を許可する。
+            この設定は DoS 攻撃に繋がる可能性があるため、
+            ドキュメントサイズに制限を設けている場合にのみ有効にすべきです。
+            libxml2 を使用している場合のみ利用可能です。
+           </entry>
+          </row>
           <row>
            <entry><constant>XML_OPTION_SKIP_TAGSTART</constant></entry>
            <entry>integer</entry>
@@ -136,6 +146,12 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       <constant>XML_OPTION_PARSE_HUGE</constant> が追加されました。
+      </entry>
+     </row>
      <row>
       <entry>8.3.0</entry>
       <entry>

diff --git a/reference/xml/functions/xml-set-character-data-handler.xml b/reference/xml/functions/xml-set-character-data-handler.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 5a14f904d231d294e2e5b4fb5d2fc4d2fd9eddee Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 9cd8eb0f11edb4e59fd22f723137bbb91d6ab64f Maintainer: takagi Status: ready -->
 <!-- CREDITS: hirokawa -->
 <refentry xml:id="function.xml-set-character-data-handler" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -76,7 +76,8 @@
      </row>
     </thead>
     <tbody>
-      &xml.changelog.parser-param;
+     &xml.changelog.handler-param;
+     &xml.changelog.parser-param;
     </tbody>
    </tgroup>
   </informaltable>

diff --git a/reference/xml/functions/xml-set-default-handler.xml b/reference/xml/functions/xml-set-default-handler.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 5a14f904d231d294e2e5b4fb5d2fc4d2fd9eddee Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 9cd8eb0f11edb4e59fd22f723137bbb91d6ab64f Maintainer: takagi Status: ready -->
 <!-- CREDITS: hirokawa -->
 <refentry xml:id="function.xml-set-default-handler" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -76,7 +76,8 @@
      </row>
     </thead>
     <tbody>
-      &xml.changelog.parser-param;
+     &xml.changelog.handler-param;
+     &xml.changelog.parser-param;
     </tbody>
    </tgroup>
   </informaltable>

diff --git a/reference/xml/functions/xml-set-element-handler.xml b/reference/xml/functions/xml-set-element-handler.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 5a14f904d231d294e2e5b4fb5d2fc4d2fd9eddee Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 9cd8eb0f11edb4e59fd22f723137bbb91d6ab64f Maintainer: takagi Status: ready -->
 <!-- CREDITS: hirokawa,mumumu -->
 <refentry xml:id="function.xml-set-element-handler" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -124,7 +124,8 @@
      </row>
     </thead>
     <tbody>
-      &xml.changelog.parser-param;
+     &xml.changelog.handler-param;
+     &xml.changelog.parser-param;
     </tbody>
    </tgroup>
   </informaltable>

diff --git a/reference/xml/functions/xml-set-end-namespace-decl-handler.xml b/reference/xml/functions/xml-set-end-namespace-decl-handler.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 5a14f904d231d294e2e5b4fb5d2fc4d2fd9eddee Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 9cd8eb0f11edb4e59fd22f723137bbb91d6ab64f Maintainer: takagi Status: ready -->
 <!-- CREDITS: hirokawa -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id='function.xml-set-end-namespace-decl-handler'>
  <refnamediv>
@@ -81,7 +81,8 @@
      </row>
     </thead>
     <tbody>
-      &xml.changelog.parser-param;
+     &xml.changelog.handler-param;
+     &xml.changelog.parser-param;
     </tbody>
    </tgroup>
   </informaltable>