From bbf603a0c020700059999c15b93a18279bd474a1 Mon Sep 17 00:00:00 2001
From: lacatoire <la.catoire@gmail.com>
Date: Tue, 25 Aug 2026 11:05:33 +0200
Subject: [PATCH] [Sync EN] filter: version the FILTER_CALLBACK flags note

---
 reference/filter/constants.xml | 23 ++++++++++++++++-------
 1 file changed, 16 insertions(+), 7 deletions(-)

diff --git a/reference/filter/constants.xml b/reference/filter/constants.xml
index e9973a431..67ff73221 100644
--- a/reference/filter/constants.xml
+++ b/reference/filter/constants.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 911fe79de766ef4475bf22446903667a0f3a24d3 Maintainer: PhilDaiguille Status: ready -->
+<!-- EN-Revision: 1900175b061e4de78f5ba3e79874e457d7e710a1 Maintainer: PhilDaiguille Status: ready -->
 <!-- Reviewed: yes Maintainer: Marqitos -->
 <!-- Generated by xml_proto.php v2.4. Found in /scripts directory of phpdoc. -->
 <appendix xml:id="filter.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -719,9 +719,9 @@
     (<type>int</type>)
    </term>
    <listitem>
-    <para>
+    <simpara>
      Valida el valor como dirección IP.
-    </para>
+    </simpara>
     <variablelist xml:id="filter.constants.validation.ip.options">
      <title>Opciones disponibles</title>
      <varlistentry>
@@ -1231,12 +1231,21 @@ NULL
 ]]>
      </screen>
     </example>
-    <warning>
+    <note>
      <simpara>
-      Este filtro no puede usarse con ningún otro flag de filtro, por ejemplo,
-      <constant>FILTER_NULL_ON_FAILURE</constant>.
+      A partir de PHP 8.1.25 y 8.2.12, los flags estructurales
+      <constant>FILTER_REQUIRE_ARRAY</constant>,
+      <constant>FILTER_FORCE_ARRAY</constant> y
+      <constant>FILTER_REQUIRE_SCALAR</constant> se aplican a este filtro, y
+      <constant>FILTER_NULL_ON_FAILURE</constant> cambia la forma en que se
+      informa de tal fallo estructural. En versiones anteriores todos los flags
+      eran ignorados. Los flags específicos del filtro siempre son ignorados y,
+      dado que el valor devuelto por la retrollamada es el resultado, la
+      retrollamada en sí misma no puede fallar: ningún flag convierte un
+      <literal>false</literal> devuelto por la retrollamada en &null; o en una
+      excepción.
      </simpara>
-    </warning>
+    </note>
    </listitem>
   </varlistentry>
  </variablelist>