From ac733a2b6ff4b446e232818c52563cf7a1d9b03a Mon Sep 17 00:00:00 2001
From: "SUMIDA, Ippei" <ippey.s@gmail.com>
Date: Mon, 10 Feb 2025 16:05:35 +0900
Subject: [PATCH 1/2] =?UTF-8?q?registerPhpFunctions=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

---
 .../dom/domxpath/registerphpfunctions.xml     | 63 ++++++++++++++++++-
 .../xsltprocessor/registerphpfunctions.xml    | 38 ++++++++++-
 2 files changed, 96 insertions(+), 5 deletions(-)

diff --git a/reference/dom/domxpath/registerphpfunctions.xml b/reference/dom/domxpath/registerphpfunctions.xml
index f93263b637..2da0076cd9 100644
--- a/reference/dom/domxpath/registerphpfunctions.xml
+++ b/reference/dom/domxpath/registerphpfunctions.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 4f5e2b22575131fa5e9c3004b1c874e1acb06573 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 2bd9a67c8c6c5961189f868364837a5c3ba7e063 Maintainer: takagi Status: ready -->
 
 <refentry xml:id="domxpath.registerphpfunctions" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -31,7 +31,10 @@
        このパラメータを使って、特定の関数のみを XPath からコールできるように制限することができます。
       </para>
       <para>
-       このパラメータには、文字列 (関数名) あるいは関数名の配列を指定します。
+       このパラメータは、以下のいずれかになります:
+       <type>文字列</type> (関数名),
+       関数名の <type>配列</type>,
+       関数名がキーで <type>callable</type> な値を持つ連想配列。
       </para>
      </listitem>
     </varlistentry>
@@ -46,6 +49,29 @@
   </para>
  </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>
+       <parameter>restrict</parameter> を <type>配列</type> にする際、
+       コールバックとして <type>callable</type> を使用できるようになりました。
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+ 
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -145,6 +171,38 @@ foreach ($books as $book) {
     echo $book->getElementsByTagName("title")->item(0)->nodeValue . "\n";
 }
 
+?>
+]]>
+    </programlisting>
+    &example.outputs.similar;
+    <screen>
+     <![CDATA[
+Books with multiple authors:
+PHP Basics
+]]>
+    </screen>
+   </example>
+  </para>
+  <para>
+   <example>
+    <title><methodname>DOMXPath::registerPHPFunctions</methodname> with a <type>callable</type></title>
+    <programlisting role="php">
+     <![CDATA[
+<?php
+$doc = new DOMDocument;
+$doc->load('book.xml');
+$xpath = new DOMXPath($doc);
+// 名前空間 php: を登録します (必須)
+$xpath->registerNamespace("php", "http://php.net/xpath");
+// PHP の関数を登録します (has_multiple 限定)
+$xpath->registerPHPFunctions(["has_multiple" => fn ($nodes) => count($nodes) > 1]);
+// 複数の author がいる book のみを取り出します
+$books = $xpath->query('//book[php:function("has_multiple", author)]');
+echo "Books with multiple authors:\n";
+foreach ($books as $book) {
+    echo $book->getElementsByTagName("title")->item(0)->nodeValue . "\n";
+}
+
 ?>
 ]]>
     </programlisting>
@@ -166,6 +224,7 @@ PHP Basics
     <member><methodname>DOMXPath::registerNamespace</methodname></member>
     <member><methodname>DOMXPath::query</methodname></member>
     <member><methodname>DOMXPath::evaluate</methodname></member>
+    <member><methodname>XSLTProcessor::registerPHPFunctions</methodname></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/xsl/xsltprocessor/registerphpfunctions.xml b/reference/xsl/xsltprocessor/registerphpfunctions.xml
index 2613586975..17aeef9d59 100644
--- a/reference/xsl/xsltprocessor/registerphpfunctions.xml
+++ b/reference/xsl/xsltprocessor/registerphpfunctions.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8" ?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1d574504ad4c2a183f6f858694b35168af23de46 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 2bd9a67c8c6c5961189f868364837a5c3ba7e063 Maintainer: takagi Status: ready -->
 <!-- Credits: mumumu -->
 <refentry xml:id="xsltprocessor.registerphpfunctions" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -29,8 +29,10 @@
        このパラメータは、XSLT からコールされる信頼できる関数のみを許可します。
       </para>
       <para>
-       このパラメータには文字列 (関数名)
-       あるいは関数の配列のいずれかを指定します。
+       このパラメータは、以下のいずれかになります:
+       <type>文字列</type> (関数名),
+       関数名の <type>配列</type>,
+       関数名がキーで <type>callable</type> な値を持つ連想配列。
       </para>
      </listitem>
     </varlistentry>
@@ -43,6 +45,28 @@
    &return.void;
   </para>
  </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>
+       <parameter>restrict</parameter> を <type>配列</type> にする際、
+       コールバックとして <type>callable</type> を使用できるようになりました。
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -93,6 +117,14 @@ echo $proc->transformToXML($xmldoc);
     </example>
   </para>
  </refsect1>
+ 
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member><methodname>DOMXPath::registerPhpFunctions</methodname></member>
+  </simplelist>
+ </refsect1>
+ 
 </refentry>
 <!-- Keep this comment at the end of the file
 Local variables:

From 0a1a88ae178f9769ab88f10d39e7a95be01337cc 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: Tue, 11 Feb 2025 16:39:35 +0900
Subject: [PATCH 2/2] =?UTF-8?q?=E5=9E=8B=E5=90=8D=E3=82=92=E6=AD=A3?=
 =?UTF-8?q?=E5=BC=8F=E5=8C=96?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 reference/dom/domxpath/registerphpfunctions.xml      | 4 ++--
 reference/xsl/xsltprocessor/registerphpfunctions.xml | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/reference/dom/domxpath/registerphpfunctions.xml b/reference/dom/domxpath/registerphpfunctions.xml
index 2da0076cd9..47703748e9 100644
--- a/reference/dom/domxpath/registerphpfunctions.xml
+++ b/reference/dom/domxpath/registerphpfunctions.xml
@@ -32,8 +32,8 @@
       </para>
       <para>
        このパラメータは、以下のいずれかになります:
-       <type>文字列</type> (関数名),
-       関数名の <type>配列</type>,
+       <type>string</type> (関数名),
+       関数名の <type>array</type>,
        関数名がキーで <type>callable</type> な値を持つ連想配列。
       </para>
      </listitem>
diff --git a/reference/xsl/xsltprocessor/registerphpfunctions.xml b/reference/xsl/xsltprocessor/registerphpfunctions.xml
index 17aeef9d59..66e4c6a8bd 100644
--- a/reference/xsl/xsltprocessor/registerphpfunctions.xml
+++ b/reference/xsl/xsltprocessor/registerphpfunctions.xml
@@ -30,8 +30,8 @@
       </para>
       <para>
        このパラメータは、以下のいずれかになります:
-       <type>文字列</type> (関数名),
-       関数名の <type>配列</type>,
+       <type>string</type> (関数名),
+       関数名の <type>array</type>,
        関数名がキーで <type>callable</type> な値を持つ連想配列。
       </para>
      </listitem>