From 48d26b2179a52c491cffa905008b9f16c423b0f9 Mon Sep 17 00:00:00 2001
From: lacatoire <la.catoire@gmail.com>
Date: Mon, 31 Aug 2026 12:14:07 +0200
Subject: [PATCH] filter/constants.xml: 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 a973855f3..c5b627f2e 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: shein Status: ready -->
+<!-- EN-Revision: 1900175b061e4de78f5ba3e79874e457d7e710a1 Maintainer: shein Status: ready -->
 <!-- Reviewed: no -->
 <appendix xml:id="filter.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.constants;
@@ -715,9 +715,9 @@
     (<type>int</type>)
    </term>
    <listitem>
-    <para>
+    <simpara>
      Фильтр проверяет значение как IP-адрес.
-    </para>
+    </simpara>
     <variablelist xml:id="filter.constants.validation.ip.options">
      <title>Available options</title>
      <varlistentry>
@@ -1226,12 +1226,21 @@ NULL
 ]]>
      </screen>
     </example>
-    <warning>
+    <note>
      <simpara>
-      Фильтр нельзя комбинировать с флагами,
-      включая флаг <constant>FILTER_NULL_ON_FAILURE</constant>.
+      Начиная с PHP 8.1.25 и 8.2.12 к этому фильтру применяются структурные
+      флаги <constant>FILTER_REQUIRE_ARRAY</constant>,
+      <constant>FILTER_FORCE_ARRAY</constant> и
+      <constant>FILTER_REQUIRE_SCALAR</constant>, а флаг
+      <constant>FILTER_NULL_ON_FAILURE</constant> меняет то, как сообщают
+      о такой структурной ошибке. В более ранних версиях все флаги
+      игнорировались. Флаги конкретных фильтров игнорируются всегда, а
+      поскольку результатом становится возвращаемое значение функции обратного
+      вызова, сама функция обратного вызова завершиться неудачей не может:
+      ни один флаг не превращает <literal>false</literal>, которое вернула
+      функция обратного вызова, в &null; или в исключение.
      </simpara>
-    </warning>
+    </note>
    </listitem>
   </varlistentry>
  </variablelist>