From b44b09eed1cc21fdef710b901e37f98ab2409c0d 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, 20 Sep 2026 13:09:01 +0900
Subject: [PATCH] =?UTF-8?q?forward=5Fstatic=5Fcall()=20=E3=81=A8=20forward?=
 =?UTF-8?q?=5Fstatic=5Fcall=5Farray()=20=E3=81=AE=E8=AA=AC=E6=98=8E?=
 =?UTF-8?q?=E3=81=AE=E8=AA=A4=E3=82=8A=E3=82=92=E5=8E=9F=E6=96=87=E3=81=AB?=
 =?UTF-8?q?=E5=90=88=E3=82=8F=E3=81=9B=E3=81=A6=E4=BF=AE=E6=AD=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

php/doc-en@846dfb87da (php/doc-en#5241) と php/doc-en@17ddeefd65 (php/doc-en#5784)
に追従します。

forward_static_call_array() を「メソッドのコンテキストでコールしなければならない」
としていた誤りが削除され、クラス外では遅延静的束縛なしの call_user_func_array() と
同じ挙動になること、forward_static_call() 側はクラススコープを必要とするという
非対称性が追記されました。

## 対象ファイル (2件)

- reference/funchand/functions/forward-static-call.xml
- reference/funchand/functions/forward-static-call-array.xml
---
 .../functions/forward-static-call-array.xml   | 45 ++++++++++++-------
 .../functions/forward-static-call.xml         | 21 +++++----
 2 files changed, 41 insertions(+), 25 deletions(-)

diff --git a/reference/funchand/functions/forward-static-call-array.xml b/reference/funchand/functions/forward-static-call-array.xml
index 1269ecfc87c..7ae7a01b9e6 100644
--- a/reference/funchand/functions/forward-static-call-array.xml
+++ b/reference/funchand/functions/forward-static-call-array.xml
@@ -1,11 +1,11 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: c6fb604f39a0fa7bf1ae872064b2a3a24f23d855 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 17ddeefd6592d09dd9abcf185f56b5befc7b2d6d Maintainer: takagi Status: ready -->
 <!-- Credits: mumumu -->
 <refentry xml:id="function.forward-static-call-array" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>forward_static_call_array</refname>
-  <refpurpose>static メソッドをコールし、引数を配列で渡す</refpurpose>
+  <refpurpose>現在呼び出されたクラスを保持したまま、パラメータの配列を指定してコールバックをコールする</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -15,14 +15,25 @@
    <methodparam><type>callable</type><parameter>callback</parameter></methodparam>
    <methodparam><type>array</type><parameter>args</parameter></methodparam>
   </methodsynopsis>
-  <para>
-   <parameter>callback</parameter> パラメータで指定したユーザー定義の関数あるいはメソッドをコールします。
-   この関数はメソッドのコンテキストでコールしなければなりません。
-   クラスの外部で使用することはできません。
-   この関数は <link linkend="language.oop5.late-static-bindings">遅延静的束縛</link> を使います。
-   転送先のメソッドへのすべての引数は値渡しで、
-   <function>call_user_func_array</function> と同様に配列で指定します。
-  </para>
+  <simpara>
+   <parameter>callback</parameter> パラメータで指定したユーザー定義の関数あるいはメソッドを、
+   <function>call_user_func_array</function> と同様に引数を配列で渡してコールします。
+   メソッドのコンテキスト内でコールし、かつコールバックがメソッドの場合は
+   <link linkend="language.oop5.late-static-bindings">転送コール</link> となるため、
+   そのメソッド内の <literal>static::</literal> は、
+   転送元での <literal>static::</literal> と同じクラスに解決されます。
+   これは、<literal>self::</literal> や <literal>parent::</literal>
+   のように振る舞わせたい static メソッドをコールバックとして渡す場合に便利です。
+  </simpara>
+  <note>
+   <simpara>
+    <function>forward_static_call</function> とは異なり、
+    この関数は有効なクラススコープを必要としません。
+    クラスの外部でコールした場合、<function>forward_static_call</function> は
+    <exceptionname>Error</exceptionname> をスローしますが、
+    この関数はスローしません。
+   </simpara>
+  </note>
  </refsect1>
 
  <refsect1 role="parameters">
@@ -41,14 +52,14 @@
     <varlistentry>
      <term><parameter>args</parameter></term>
      <listitem>
-      <para>
-       このひとつのパラメータに、メソッドに渡すすべてのパラメータを配列で指定します。
-      </para>
+      <simpara>
+       コールバックに渡すパラメータを配列で指定します。
+      </simpara>
       <note>
-       <para>
-        <function>forward_static_call_array</function>
-        へのパラメータは参照渡しではないことに注意しましょう。
-       </para>
+       <simpara>
+        パラメータを参照渡しするには、
+        <parameter>args</parameter> の対応する要素が参照である必要があります。
+       </simpara>
       </note>
      </listitem>
     </varlistentry>
diff --git a/reference/funchand/functions/forward-static-call.xml b/reference/funchand/functions/forward-static-call.xml
index 202974018c5..53828ced1e6 100644
--- a/reference/funchand/functions/forward-static-call.xml
+++ b/reference/funchand/functions/forward-static-call.xml
@@ -1,11 +1,11 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 17ddeefd6592d09dd9abcf185f56b5befc7b2d6d Maintainer: takagi Status: ready -->
 <!-- Credits: mumumu -->
 <refentry xml:id="function.forward-static-call" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>forward_static_call</refname>
-  <refpurpose>static メソッドをコールする</refpurpose>
+  <refpurpose>現在呼び出されたクラスを保持したままコールバックをコールする</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -15,12 +15,17 @@
    <methodparam><type>callable</type><parameter>callback</parameter></methodparam>
    <methodparam rep="repeat"><type>mixed</type><parameter>args</parameter></methodparam>
   </methodsynopsis>
-  <para>
+  <simpara>
    <parameter>callback</parameter> パラメータで指定したユーザー定義の関数あるいはメソッドを、
    それに続く引数を指定してコールします。この関数はメソッドのコンテキストでコールしなければなりません。
    クラスの外部で使用することはできません。
-   この関数は <link linkend="language.oop5.late-static-bindings">遅延静的束縛</link> を使います。
-  </para>
+   コールバックがメソッドの場合は
+   <link linkend="language.oop5.late-static-bindings">転送コール</link> となるため、
+   そのメソッド内の <literal>static::</literal> は、
+   転送元での <literal>static::</literal> と同じクラスに解決されます。
+   これは、<literal>self::</literal> や <literal>parent::</literal>
+   のように振る舞わせたい static メソッドをコールバックとして渡す場合に便利です。
+  </simpara>
  </refsect1>
 
  <refsect1 role="parameters">
@@ -39,9 +44,9 @@
     <varlistentry>
      <term><parameter>args</parameter></term>
      <listitem>
-      <para>
-       関数に渡したいパラメータ。
-      </para>
+      <simpara>
+       コールバックに渡す、ゼロ個以上のパラメータ。
+      </simpara>
      </listitem>
     </varlistentry>
    </variablelist>