From 82a48b2ccda7f6c50e367cd8a67c5da1728fa2ee Mon Sep 17 00:00:00 2001
From: lacatoire <la.catoire@gmail.com>
Date: Mon, 19 Oct 2026 16:12:35 +0200
Subject: [PATCH] [Sync-En] Sync array_filter, php://input,
 call_user_func_array, object comparison and SessionHandlerInterface

---
 language/oop5/object-comparison.xml           |  4 +--
 language/wrappers/php.xml                     | 33 ++++++++++---------
 reference/array/functions/array-filter.xml    |  8 +++--
 .../functions/call-user-func-array.xml        |  3 +-
 reference/session/sessionhandlerinterface.xml | 15 ++++-----
 5 files changed, 34 insertions(+), 29 deletions(-)

diff --git a/language/oop5/object-comparison.xml b/language/oop5/object-comparison.xml
index e792261024..5e3486130a 100644
--- a/language/oop5/object-comparison.xml
+++ b/language/oop5/object-comparison.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: dff848b17dafaabfb7662ffb5fecfcb04e3b771d Maintainer: PhilDaiguille Status: ready -->
+<!-- EN-Revision: a2a11180e43d242a92dd299eab74b1ea68bb7de6 Maintainer: PhilDaiguille Status: ready -->
   <sect1 xml:id="language.oop5.object-comparison" xmlns="http://docbook.org/ns/docbook">
    <title>Comparación de objetos</title>
    <para>
@@ -30,7 +30,7 @@ function bool2str($bool)
     }
 }
 
-function compareObjects(&$o1, &$o2)
+function compareObjects($o1, $o2)
 {
     echo 'o1 == o2 : '.bool2str($o1 == $o2)."\n";
     echo 'o1 != o2 : '.bool2str($o1 != $o2)."\n";
diff --git a/language/wrappers/php.xml b/language/wrappers/php.xml
index 21ffcc175c..1867234f4d 100644
--- a/language/wrappers/php.xml
+++ b/language/wrappers/php.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: f56de7ebe7a1a85ce9e44a2bf6b77b07adfe3ae4 Maintainer: PhilDaiguille Status: ready -->
+<!-- EN-Revision: 6de6d6a839a44f594b4f82609bfafb95bdb3d3ff Maintainer: PhilDaiguille Status: ready -->
 <!-- Reviewed: no -->
 
 <refentry xml:id="wrappers.php" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" annotations="verify_info:false" role="stream_wrapper">
@@ -14,7 +14,7 @@
    PHP proporciona un número importante de flujos I/O que permiten acceder
    a los flujos de entrada y salida de PHP mismo, a los descriptores de ficheros
    de entrada, salida y error estándar, a flujos que representan
-   ficheros temporales en memoria viva o en disco, así como a filtros
+   ficheros temporales en memoria o en disco, así como a filtros
    que pueden manipular otros recursos de ficheros durante la lectura o escritura.
   </para>
 
@@ -43,6 +43,7 @@
    <simpara>
     <filename>php://input</filename> es un flujo de solo lectura que permite
     leer datos sin tratar desde el cuerpo de la petición.
+    Puede abrirse y leerse tantas veces como sea necesario.
     <filename>php://input</filename> no está disponible en las peticiones POST con
     <literal>enctype="multipart/form-data"</literal> si la opción
     <link linkend="ini.enable-post-data-reading">enable_post_data_reading</link>
@@ -78,7 +79,7 @@
     estos dos flujos es que <filename>php://memory</filename> almacenará siempre
     sus datos en memoria, mientras que <filename>php://temp</filename> utilizará un
     fichero temporal una vez que la cantidad de datos almacenados haya superado
-    un límite predefinido (por omisión, 2 Mo). La ubicación
+    un límite predefinido (por omisión, 2 MB). La ubicación
     de este fichero temporal se determina de la misma manera que para
     la función <function>sys_get_temp_dir</function>.
    </simpara>
@@ -171,7 +172,7 @@
   </refsect2>
  </refsect1>
 
- <refsect1 role="options"><!-- {{{ -->
+ <refsect1 role="options">
   &reftitle.options;
   <para>
    <table>
@@ -277,11 +278,11 @@
     </tgroup>
    </table>
   </para>
- </refsect1> <!-- }}} -->
+ </refsect1>
 
- <refsect1 role="examples"><!-- {{{ -->
+ <refsect1 role="examples">
   &reftitle.examples;
-  <example><!-- {{{ -->
+  <example>
    <title>php://temp/maxmemory</title>
    <para>
     Este parámetro opcional permite configurar el límite
@@ -291,7 +292,7 @@
    <programlisting role="php">
 <![CDATA[
 <?php
-// Define el límite a 5 Mo.
+// Define el límite a 5 MB.
 $fiveMBs = 5 * 1024 * 1024;
 $fp = fopen("php://temp/maxmemory:$fiveMBs", 'r+');
 
@@ -303,8 +304,8 @@ echo stream_get_contents($fp);
 ?>
 ]]>
    </programlisting>
-  </example><!-- }}} -->
-  <example><!-- {{{ -->
+  </example>
+  <example>
    <title>php://filter/resource=&lt;flujo a filtrar&gt;</title>
    <para>
     Este parámetro debe ser colocado al final de la especificación
@@ -322,8 +323,8 @@ readfile("php://filter/resource=http://www.example.com");
 ?>
 ]]>
    </programlisting>
-  </example><!-- }}} -->
-  <example><!-- {{{ -->
+  </example>
+  <example>
    <title>php://filter/read=&lt;lista de filtros a aplicar a la lectura&gt;</title>
    <para>
     Este parámetro toma uno o más nombres de filtros separados por
@@ -342,8 +343,8 @@ readfile("php://filter/read=string.toupper|string.rot13/resource=http://www.exam
 ?>
 ]]>
    </programlisting>
-  </example><!-- }}} -->
-  <example><!-- {{{ -->
+  </example>
+  <example>
    <title>php://filter/write=&lt;lista de filtros a aplicar a la escritura&gt;</title>
    <para>
     Este parámetro toma uno o más nombres de filtros separados por
@@ -359,7 +360,7 @@ file_put_contents("php://filter/write=string.rot13/resource=example.txt","Hello
 ?>
 ]]>
    </programlisting>
-  </example><!-- }}} -->
+  </example>
   <example>
    <title>php://memory y php://temp no son reutilizables</title>
    <para>
@@ -396,7 +397,7 @@ print_r($json_array);
 ]]>
    </programlisting>
   </example>
- </refsect1><!-- }}} -->
+ </refsect1>
 </refentry>
 
 <!-- Keep this comment at the end of the file
diff --git a/reference/array/functions/array-filter.xml b/reference/array/functions/array-filter.xml
index 9592cc30b9..303893fc05 100644
--- a/reference/array/functions/array-filter.xml
+++ b/reference/array/functions/array-filter.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 596c11440dc232b8ed1836d7e3afe2ed5b225a7b Maintainer: PhilDaiguille Status: ready -->
+<!-- EN-Revision: 00eb00696f9e9989ffa539be35571429b25333b8 Maintainer: PhilDaiguille Status: ready -->
 <!-- Reviewed: yes -->
 <refentry xml:id="function.array-filter" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -77,6 +77,10 @@
        </itemizedlist>
        Por omisión <literal>0</literal>, que pasará el valor como único argumento de <parameter>callback</parameter>.
       </para>
+      <simpara>
+       Si <parameter>callback</parameter> es &null;, <parameter>mode</parameter>
+       se ignora y solo se comprueban los valores.
+      </simpara>
      </listitem>
     </varlistentry>
 
@@ -166,7 +170,7 @@ Array
     </screen>
    </example>
    <example>
-    <title>Ejemplo con <function>array_filter</function>
+    <title>Ejemplo con <function>array_filter</function> sin
     <parameter>callback</parameter></title>
     <programlisting role="php">
 <![CDATA[
diff --git a/reference/funchand/functions/call-user-func-array.xml b/reference/funchand/functions/call-user-func-array.xml
index 0031493dc4..e3cdbc19a8 100644
--- a/reference/funchand/functions/call-user-func-array.xml
+++ b/reference/funchand/functions/call-user-func-array.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 5832a97c699c5e1bc808ee900447fe751af0d540 Maintainer: PhilDaiguille Status: ready -->
+<!-- EN-Revision: 0c5d173aa7bec12135c8a42bced037f8850e4610 Maintainer: PhilDaiguille Status: ready -->
 <!-- Reviewed: yes -->
 <refentry xml:id="function.call-user-func-array" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -249,6 +249,7 @@ Fatal error: Uncaught Error: Cannot use positional argument after named argument
   <para>
    <simplelist>
     <member><function>call_user_func</function></member>
+    <member><link linkend="functions.variable-arg-list">Desempaquetado de argumentos</link></member>
     <member><methodname>ReflectionFunction::invokeArgs</methodname></member>
     <member><methodname>ReflectionMethod::invokeArgs</methodname></member>
    </simplelist>
diff --git a/reference/session/sessionhandlerinterface.xml b/reference/session/sessionhandlerinterface.xml
index 5d07e8e7a4..67540a9f20 100644
--- a/reference/session/sessionhandlerinterface.xml
+++ b/reference/session/sessionhandlerinterface.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 8859c8b96cd9e80652813f7bcf561432a5e9f934 Maintainer: seros Status: ready -->
+<!-- EN-Revision: a5b4d03a0135c5feb0beec7d7b99effaacab0505 Maintainer: seros Status: ready -->
 <!-- Reviewed: yes Maintainer: julionc -->
 <reference xml:id="class.sessionhandlerinterface" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
 
@@ -34,9 +34,7 @@
     </oointerface>
 
     <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
-    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.sessionhandlerinterface')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='SessionHandlerInterface'])">
-     <xi:fallback/>
-    </xi:include>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.sessionhandlerinterface')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='SessionHandlerInterface'])"/>
    </classsynopsis>
    <!-- }}} -->
 
@@ -114,13 +112,14 @@ class MySessionHandler implements SessionHandlerInterface
     #[\ReturnTypeWillChange]
     public function gc($maxlifetime)
     {
+        $deleted = 0;
         foreach (glob("$this->savePath/sess_*") as $file) {
-            if (filemtime($file) + $maxlifetime < time() && file_exists($file)) {
-                unlink($file);
+            if (filemtime($file) + $maxlifetime < time() && file_exists($file) && unlink($file)) {
+                $deleted++;
             }
         }
 
-        return true;
+        return $deleted;
     }
 }
 
@@ -128,7 +127,7 @@ $handler = new MySessionHandler();
 session_set_save_handler($handler, true);
 session_start();
 
-// proceed to set and retrieve values by key from $_SESSION
+// proceder a establecer y recuperar valores por clave desde $_SESSION
 ]]>
     </programlisting>
    </example>