From 439db4db3969238be68dc35fa8c1da65a7d09afe Mon Sep 17 00:00:00 2001
From: lacatoire <la.catoire@gmail.com>
Date: Tue, 22 Sep 2026 09:05:43 +0200
Subject: [PATCH] docs(xsl): document and warn about registerPHPFunctions null
 default

---
 .../xsltprocessor/registerphpfunctions.xml    | 27 ++++++++++++-------
 1 file changed, 17 insertions(+), 10 deletions(-)

diff --git a/reference/xsl/xsltprocessor/registerphpfunctions.xml b/reference/xsl/xsltprocessor/registerphpfunctions.xml
index 3bd051f389..132b3754a3 100644
--- a/reference/xsl/xsltprocessor/registerphpfunctions.xml
+++ b/reference/xsl/xsltprocessor/registerphpfunctions.xml
@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 01904e809eaf0aa60e7ce0524400ddd5681c9541 Maintainer: yannick Status: ready -->
-<!-- Reviewed: yes -->
+<!-- EN-Revision: 8ab64588e7427274839714c8bd2ca2069e4a56c6 Maintainer: yannick Status: ready -->
 <refentry xml:id="xsltprocessor.registerphpfunctions" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
  <refnamediv>
   <refname>XSLTProcessor::registerPHPFunctions</refname>
@@ -12,10 +11,17 @@
    <modifier>public</modifier> <type>void</type><methodname>XSLTProcessor::registerPHPFunctions</methodname>
    <methodparam choice="opt"><type class="union"><type>array</type><type>string</type><type>null</type></type><parameter>functions</parameter><initializer>&null;</initializer></methodparam>
   </methodsynopsis>
-  <para>
+  <simpara>
    Cette méthode permet d'utiliser les fonctions PHP en tant que fonctions
    XSLT dans les feuilles de style XSL.
-  </para>
+  </simpara>
+  <warning>
+   <simpara>
+    <parameter>functions</parameter> vaut &null; par défaut, ce qui signifie
+    que par défaut, l'appel de cette méthode active l'accès à
+    <emphasis>toutes</emphasis> les fonctions PHP.
+   </simpara>
+  </warning>
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
@@ -24,17 +30,18 @@
     <varlistentry>
      <term><parameter>functions</parameter></term>
      <listitem>
-      <para>
+      <simpara>
        Utiliser ce paramètre pour restreindre les fonctions PHP accessibles
        depuis XSLT.
-      </para>
-      <para>
+      </simpara>
+      <simpara>
        Ce paramètre peut être l'un des suivants :
+       &null; pour indiquer que toutes les fonctions sont autorisées,
        un <type>string</type> (nom d'une fonction),
        un <type>array</type> indexé contenant des noms de fonctions,
        ou un <type>array</type> associatif où les clés représentent le nom de la fonction
        et la valeur associée est un <type>callable</type>.
-      </para>
+      </simpara>
      </listitem>
     </varlistentry>
    </variablelist>
@@ -45,9 +52,9 @@
 
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
-  <para>
+  <simpara>
    &return.void;
-  </para>
+  </simpara>
  </refsect1>
 
  <refsect1 role="changelog">