From dffc9e5c40109d1847e2d22ae019a2b8177fb81e Mon Sep 17 00:00:00 2001
From: "SUMIDA, Ippei" <ippey.s@gmail.com>
Date: Sun, 8 Dec 2024 17:49:06 +0900
Subject: [PATCH 1/3] =?UTF-8?q?request=5Fparse=5Fbody=E3=81=AE=E7=BF=BB?=
 =?UTF-8?q?=E8=A8=B3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 language/errors/php7.xml                      |   5 +-
 language/predefined/exceptions.xml            |   3 +-
 .../predefined/requestparsebodyexception.xml  |  65 +++++++++
 .../network/functions/request-parse-body.xml  | 136 ++++++++++++++++++
 4 files changed, 207 insertions(+), 2 deletions(-)
 create mode 100644 language/predefined/requestparsebodyexception.xml
 create mode 100644 reference/network/functions/request-parse-body.xml

diff --git a/language/errors/php7.xml b/language/errors/php7.xml
index de8d5e146c9..1e0d2439d4c 100644
--- a/language/errors/php7.xml
+++ b/language/errors/php7.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1f7a0e4af85d1b74595626afa1ca774c896e8388 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 4bf789e981af0836c41daa16e57ef86c21497faa Maintainer: takagi Status: ready -->
 <!-- Credits: mumumu -->
 
 <sect1 xml:id="language.errors.php7" xmlns="http://docbook.org/ns/docbook">
@@ -80,6 +80,9 @@
        <listitem>
         <simpara><classname>FiberError</classname></simpara>
        </listitem>
+       <listitem>
+        <simpara><classname>RequestParseBodyException</classname></simpara>
+       </listitem>
       </itemizedlist>
      </listitem>
      <listitem>
diff --git a/language/predefined/exceptions.xml b/language/predefined/exceptions.xml
index b4806681c2f..3ab289e4bf5 100644
--- a/language/predefined/exceptions.xml
+++ b/language/predefined/exceptions.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 49b7f738f43c1ea2113cc7931357a10224824539 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 4bf789e981af0836c41daa16e57ef86c21497faa Maintainer: takagi Status: ready -->
 <!-- Credits: mumumu -->
 
 <part xml:id="reserved.exceptions" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -29,6 +29,7 @@
  &language.predefined.valueerror;
  &language.predefined.unhandledmatcherror;
  &language.predefined.fibererror;
+ &language.predefined.requestparsebodyexception;
 </part>
 
 <!-- Keep this comment at the end of the file
diff --git a/language/predefined/requestparsebodyexception.xml b/language/predefined/requestparsebodyexception.xml
new file mode 100644
index 00000000000..184dd3c25cd
--- /dev/null
+++ b/language/predefined/requestparsebodyexception.xml
@@ -0,0 +1,65 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 4bf789e981af0836c41daa16e57ef86c21497faa Maintainer: ippey Status: ready -->
+<!-- Credits: ippey -->
+<reference xml:id="class.requestparsebodyexception" role="exception" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
+ <title>RequestParseBodyException</title>
+ <titleabbrev>RequestParseBodyException</titleabbrev>
+ <partintro>
+  <!-- {{{ Exception intro -->
+  <section xml:id="RequestParseBodyException.intro">
+   &reftitle.intro;
+   <simpara>
+    <classname>RequestParseBodyException</classname> は、 <function>request_parse_body</function> 内で
+    リクエストボディが無効な場合にスローされます。
+    これは、 <literal>Content-Type</literal> ヘッダーに基づいて判断されます。
+   </simpara>
+  </section>
+  <!-- }}} -->
+  <section xml:id="RequestParseBodyException.synopsis">
+   &reftitle.classsynopsis;
+   <!-- {{{ Synopsis -->
+   <classsynopsis class="class">
+    <ooexception>
+     <exceptionname>RequestParseBodyException</exceptionname>
+    </ooexception>
+    <ooclass>
+     <modifier>extends</modifier>
+     <classname>Exception</classname>
+    </ooclass>
+    <classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Properties;']]))">
+     <xi:fallback/>
+    </xi:include>
+    <classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='Exception'])">
+     <xi:fallback/>
+    </xi:include>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Exception'])">
+     <xi:fallback/>
+    </xi:include>
+   </classsynopsis>
+   <!-- }}} -->
+  </section>
+ </partintro>
+</reference>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/network/functions/request-parse-body.xml b/reference/network/functions/request-parse-body.xml
new file mode 100644
index 00000000000..e8435162b49
--- /dev/null
+++ b/reference/network/functions/request-parse-body.xml
@@ -0,0 +1,136 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 4bf789e981af0836c41daa16e57ef86c21497faa Maintainer: ippey Status: ready -->
+<!-- Credits: ippey -->
+<refentry xml:id="function.request-parse-body" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>request_parse_body</refname>
+  <refpurpose>リクエストボディを読み取り、解析して結果を返します</refpurpose>
+ </refnamediv>
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>array</type><methodname>request_parse_body</methodname>
+   <methodparam choice="opt"><type class="union"><type>array</type><type>null</type></type><parameter>options</parameter><initializer>&null;</initializer></methodparam>
+  </methodsynopsis>
+  <simpara>
+   この関数は リクエストボディを読み取り、<literal>Content-Type</literal> ヘッダーに基づき解析します。
+   現在、2つのコンテンツタイプをサポートしています:
+  </simpara>
+  <itemizedlist>
+   <listitem>
+    <simpara>
+     <literal>application/x-www-form-urlencoded</literal>
+    </simpara>
+   </listitem>
+   <listitem>
+    <simpara>
+     <literal>multipart/form-data</literal>
+    </simpara>
+   </listitem>
+  </itemizedlist>
+  <simpara>
+   この関数は、 <literal>POST</literal> 以外のHTTPメソッドで送信された <literal>multipart/form-data</literal> を解析するために使用されます。
+   これらのリクエストでは、スーパーグローバルの <varname>$_POST</varname> や <varname>$_FILES</varname> は自動的に設定されません。
+  </simpara>
+  <caution>
+   <simpara>
+    <function>request_parse_body</function> は、リクエストボディを <literal>php://input</literal> ストリームにバッファせずに処理します。
+   </simpara>
+  </caution>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>options</parameter></term>
+    <listitem>
+     <simpara>
+      <parameter>options</parameter> パラメータは連想配列を受け取り、
+      リクエストボディの解析に関連する以下のグローバル &php.ini; の設定を上書きします。
+     </simpara>
+     <itemizedlist>
+      <listitem><simpara><literal>max_file_uploads</literal></simpara></listitem>
+      <listitem><simpara><literal>max_input_vars</literal></simpara></listitem>
+      <listitem><simpara><literal>max_multipart_body_parts</literal></simpara></listitem>
+      <listitem><simpara><literal>post_max_size</literal></simpara></listitem>
+      <listitem><simpara><literal>upload_max_filesize</literal></simpara></listitem>
+     </itemizedlist>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <simpara>
+   <function>request_parse_body</function> は、 <varname>$_POST</varname> に相当するものを
+   インデックス <literal>0</literal> に、 <varname>$_FILES</varname> に相当するものを <literal>1</literal> に
+   持つ配列ペアを返します。
+  </simpara>
+ </refsect1>
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <simpara>
+   <literal>Content-Type</literal> ヘッダーに基づいて解析を試み、リクエストボディが無効な場合、
+   <exceptionname>RequestParseBodyException</exceptionname> をスローします。
+  </simpara>
+  <simpara>
+   <parameter>options</parameter> に無効なキーが含まれている、
+   または、対応するキーに無効な値が設定されている場合は、
+   <exceptionname>ValueError</exceptionname> をスローします。
+  </simpara>
+ </refsect1>
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example xml:id="function.request-parse-body.example.basic">
+   <title><function>request_parse_body</function> の例</title>
+   <programlisting role="php">
+    <![CDATA[
+<?php
+// Parse request and store result in the $_POST and $_FILES superglobals.
+[$_POST, $_FILES] = request_parse_body();
+// Echo the content of some transferred file
+echo file_get_contents($_FILES['file_name']['tmp_name']);
+?>
+]]>
+   </programlisting>
+  </example>
+  <example xml:id="function.request-parse-body.example.options">
+   <title>オプションを設定した <function>request_parse_body</function> の例</title>
+   <programlisting role="php">
+    <![CDATA[
+<?php
+// form.php
+assert_logged_in();
+// Only for this form, we allow a bigger upload size.
+[$_POST, $_FILES] = request_parse_body([
+    'post_max_size' => '10M',
+    'upload_max_filesize' => '10M',
+]);
+// Do something with the uploaded files.
+?>
+]]>
+   </programlisting>
+  </example>
+ </refsect1>
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->

From 5d896b9f198adca081aa86dda6be8f780eabe367 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: Sun, 8 Dec 2024 21:13:58 +0900
Subject: [PATCH 2/3] =?UTF-8?q?=E6=94=B9=E8=A1=8C=E3=82=84=E3=82=A4?=
 =?UTF-8?q?=E3=83=B3=E3=83=87=E3=83=B3=E3=83=88=E3=82=92=E5=8E=9F=E6=96=87?=
 =?UTF-8?q?=E3=81=A8=E6=8F=83=E3=81=88=E3=82=8B?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../predefined/requestparsebodyexception.xml  | 21 +++++++++++-----
 .../network/functions/request-parse-body.xml  | 24 ++++++++++++++-----
 2 files changed, 33 insertions(+), 12 deletions(-)

diff --git a/language/predefined/requestparsebodyexception.xml b/language/predefined/requestparsebodyexception.xml
index 184dd3c25cd..179733b9687 100644
--- a/language/predefined/requestparsebodyexception.xml
+++ b/language/predefined/requestparsebodyexception.xml
@@ -5,32 +5,39 @@
 <reference xml:id="class.requestparsebodyexception" role="exception" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
  <title>RequestParseBodyException</title>
  <titleabbrev>RequestParseBodyException</titleabbrev>
+
  <partintro>
-  <!-- {{{ Exception intro -->
+
+<!-- {{{ Exception intro -->
   <section xml:id="RequestParseBodyException.intro">
    &reftitle.intro;
    <simpara>
-    <classname>RequestParseBodyException</classname> は、 <function>request_parse_body</function> 内で
-    リクエストボディが無効な場合にスローされます。
+    <classname>RequestParseBodyException</classname> は、
+    <function>request_parse_body</function> 内でリクエストボディが無効な場合にスローされます。
     これは、 <literal>Content-Type</literal> ヘッダーに基づいて判断されます。
    </simpara>
   </section>
-  <!-- }}} -->
+<!-- }}} -->
+
   <section xml:id="RequestParseBodyException.synopsis">
    &reftitle.classsynopsis;
-   <!-- {{{ Synopsis -->
+
+<!-- {{{ Synopsis -->
    <classsynopsis class="class">
     <ooexception>
      <exceptionname>RequestParseBodyException</exceptionname>
     </ooexception>
+
     <ooclass>
      <modifier>extends</modifier>
      <classname>Exception</classname>
     </ooclass>
+
     <classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Properties;']]))">
      <xi:fallback/>
     </xi:include>
+
     <classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='Exception'])">
      <xi:fallback/>
@@ -39,7 +46,9 @@
      <xi:fallback/>
     </xi:include>
    </classsynopsis>
-   <!-- }}} -->
+
+<!-- }}} -->
+
   </section>
  </partintro>
 </reference>
diff --git a/reference/network/functions/request-parse-body.xml b/reference/network/functions/request-parse-body.xml
index e8435162b49..c43887b755a 100644
--- a/reference/network/functions/request-parse-body.xml
+++ b/reference/network/functions/request-parse-body.xml
@@ -7,6 +7,7 @@
   <refname>request_parse_body</refname>
   <refpurpose>リクエストボディを読み取り、解析して結果を返します</refpurpose>
  </refnamediv>
+
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
@@ -14,7 +15,8 @@
    <methodparam choice="opt"><type class="union"><type>array</type><type>null</type></type><parameter>options</parameter><initializer>&null;</initializer></methodparam>
   </methodsynopsis>
   <simpara>
-   この関数は リクエストボディを読み取り、<literal>Content-Type</literal> ヘッダーに基づき解析します。
+   この関数は リクエストボディを読み取り、
+   <literal>Content-Type</literal> ヘッダーに基づき解析します。
    現在、2つのコンテンツタイプをサポートしています:
   </simpara>
   <itemizedlist>
@@ -30,15 +32,19 @@
    </listitem>
   </itemizedlist>
   <simpara>
-   この関数は、 <literal>POST</literal> 以外のHTTPメソッドで送信された <literal>multipart/form-data</literal> を解析するために使用されます。
-   これらのリクエストでは、スーパーグローバルの <varname>$_POST</varname> や <varname>$_FILES</varname> は自動的に設定されません。
+   この関数は、 <literal>POST</literal> 以外のHTTPメソッドで送信された
+   <literal>multipart/form-data</literal> を解析するために使用されます。
+   これらのリクエストでは、スーパーグローバルの
+   <varname>$_POST</varname> や <varname>$_FILES</varname> は自動的に設定されません。
   </simpara>
   <caution>
    <simpara>
-    <function>request_parse_body</function> は、リクエストボディを <literal>php://input</literal> ストリームにバッファせずに処理します。
+    <function>request_parse_body</function> は、リクエストボディを
+    <literal>php://input</literal> ストリームにバッファせずに処理します。
    </simpara>
   </caution>
  </refsect1>
+
  <refsect1 role="parameters">
   &reftitle.parameters;
   <variablelist>
@@ -60,6 +66,7 @@
    </varlistentry>
   </variablelist>
  </refsect1>
+
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <simpara>
@@ -68,6 +75,7 @@
    持つ配列ペアを返します。
   </simpara>
  </refsect1>
+
  <refsect1 role="errors">
   &reftitle.errors;
   <simpara>
@@ -80,12 +88,13 @@
    <exceptionname>ValueError</exceptionname> をスローします。
   </simpara>
  </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <example xml:id="function.request-parse-body.example.basic">
    <title><function>request_parse_body</function> の例</title>
    <programlisting role="php">
-    <![CDATA[
+<![CDATA[
 <?php
 // Parse request and store result in the $_POST and $_FILES superglobals.
 [$_POST, $_FILES] = request_parse_body();
@@ -98,15 +107,18 @@ echo file_get_contents($_FILES['file_name']['tmp_name']);
   <example xml:id="function.request-parse-body.example.options">
    <title>オプションを設定した <function>request_parse_body</function> の例</title>
    <programlisting role="php">
-    <![CDATA[
+<![CDATA[
 <?php
 // form.php
+
 assert_logged_in();
+
 // Only for this form, we allow a bigger upload size.
 [$_POST, $_FILES] = request_parse_body([
     'post_max_size' => '10M',
     'upload_max_filesize' => '10M',
 ]);
+
 // Do something with the uploaded files.
 ?>
 ]]>

From df696b8b7cf1a16a63511da766c87480a25bd6e7 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: Sun, 8 Dec 2024 21:14:36 +0900
Subject: [PATCH 3/3] =?UTF-8?q?=E8=A6=8B=E5=87=BA=E3=81=97=E6=96=87?=
 =?UTF-8?q?=E7=AB=A0=E3=81=AE=E8=A8=80=E3=81=84=E5=9B=9E=E3=81=97=E3=82=92?=
 =?UTF-8?q?=E4=BB=96=E3=81=A8=E7=B5=B1=E4=B8=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 reference/network/functions/request-parse-body.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/network/functions/request-parse-body.xml b/reference/network/functions/request-parse-body.xml
index c43887b755a..00e30cc3e33 100644
--- a/reference/network/functions/request-parse-body.xml
+++ b/reference/network/functions/request-parse-body.xml
@@ -5,7 +5,7 @@
 <refentry xml:id="function.request-parse-body" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>request_parse_body</refname>
-  <refpurpose>リクエストボディを読み取り、解析して結果を返します</refpurpose>
+  <refpurpose>リクエストボディを読み取り、解析して結果を返す</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">