From 0a4e179cf8b4f5bb61b82b2871cd455decb2d649 Mon Sep 17 00:00:00 2001
From: Mikhail Alferov <malferov@php.net>
Date: Tue, 16 Jun 2026 13:31:03 +0300
Subject: [PATCH 1/5] Create filter.filterexception.xml

---
 reference/filter/filter.filterexception.xml | 68 +++++++++++++++++++++
 1 file changed, 68 insertions(+)
 create mode 100644 reference/filter/filter.filterexception.xml

diff --git a/reference/filter/filter.filterexception.xml b/reference/filter/filter.filterexception.xml
new file mode 100644
index 0000000000..32cc40f0e0
--- /dev/null
+++ b/reference/filter/filter.filterexception.xml
@@ -0,0 +1,68 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 3d4ee5f40afbfe44db4f1b13a22a6a38d4b40c7b Maintainer: malferov Status: ready -->
+<!-- Reviewed: no -->
+<reference xml:id="class.filter-filterexception" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
+ <title>The Filter\FilterException class</title>
+ <titleabbrev>Filter\FilterException</titleabbrev>
+
+ <partintro>
+  <section xml:id="filter-filterexception.intro">
+   &reftitle.intro;
+   <simpara>
+    Подкласс <type>Exception</type> и базовый класс исключений модуля Filter.
+   </simpara>
+  </section>
+
+  <section xml:id="filter-filterexception.synopsis">
+   &reftitle.classsynopsis;
+
+   <packagesynopsis>
+    <package>Filter</package>
+
+    <classsynopsis class="class">
+     <ooexception>
+      <exceptionname>FilterException</exceptionname>
+     </ooexception>
+
+     <ooclass>
+      <modifier>extends</modifier>
+      <classname>Exception</classname>
+     </ooclass>
+
+     <classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
+     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Properties;']]))">
+      <xi:fallback/>
+     </xi:include>
+
+     <classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
+     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='Exception'])">
+      <xi:fallback/>
+     </xi:include>
+     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Exception'])">
+      <xi:fallback/>
+     </xi:include>
+    </classsynopsis>
+   </packagesynopsis>
+  </section>
+ </partintro>
+</reference>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->

From 617ef9770486d8cbd644ee5ac92301524811e7e1 Mon Sep 17 00:00:00 2001
From: Mikhail Alferov <malferov@php.net>
Date: Tue, 16 Jun 2026 13:54:11 +0300
Subject: [PATCH 2/5] Update filter.filterexception.xml

---
 reference/filter/filter.filterexception.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/filter/filter.filterexception.xml b/reference/filter/filter.filterexception.xml
index 32cc40f0e0..3772642874 100644
--- a/reference/filter/filter.filterexception.xml
+++ b/reference/filter/filter.filterexception.xml
@@ -2,7 +2,7 @@
 <!-- EN-Revision: 3d4ee5f40afbfe44db4f1b13a22a6a38d4b40c7b Maintainer: malferov Status: ready -->
 <!-- Reviewed: no -->
 <reference xml:id="class.filter-filterexception" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
- <title>The Filter\FilterException class</title>
+ <title>Исключение Filter\FilterException</title>
  <titleabbrev>Filter\FilterException</titleabbrev>
 
  <partintro>

From 84661555c43b536b3156e3d4b72f20518ccf49d0 Mon Sep 17 00:00:00 2001
From: Mikhail Alferov <malferov@php.net>
Date: Tue, 16 Jun 2026 14:43:39 +0300
Subject: [PATCH 3/5] Create filter.filterfailedexception.xml

---
 .../filter/filter.filterfailedexception.xml   | 69 +++++++++++++++++++
 1 file changed, 69 insertions(+)
 create mode 100644 reference/filter/filter.filterfailedexception.xml

diff --git a/reference/filter/filter.filterfailedexception.xml b/reference/filter/filter.filterfailedexception.xml
new file mode 100644
index 0000000000..07b02e6e1a
--- /dev/null
+++ b/reference/filter/filter.filterfailedexception.xml
@@ -0,0 +1,69 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 3d4ee5f40afbfe44db4f1b13a22a6a38d4b40c7b Maintainer: malferov Status: ready -->
+<!-- Reviewed: no -->
+<reference xml:id="class.filter-filterfailedexception" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
+ <title>Исключение Filter\FilterFailedException</title>
+ <titleabbrev>Filter\FilterFailedException</titleabbrev>
+
+ <partintro>
+  <section xml:id="filter-filterfailedexception.intro">
+   &reftitle.intro;
+   <simpara>
+    Исключение выбрасывается, когда значение не проходит проверку
+    при фильтрации в режиме <constant>FILTER_THROW_ON_FAILURE</constant>.
+   </simpara>
+  </section>
+
+  <section xml:id="filter-filterfailedexception.synopsis">
+   &reftitle.classsynopsis;
+
+   <packagesynopsis>
+    <package>Filter</package>
+
+    <classsynopsis class="class">
+     <ooexception>
+      <exceptionname>FilterFailedException</exceptionname>
+     </ooexception>
+
+     <ooclass>
+      <modifier>extends</modifier>
+      <classname>Filter\FilterException</classname>
+     </ooclass>
+
+     <classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
+     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Properties;']]))">
+      <xi:fallback/>
+     </xi:include>
+
+     <classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
+     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='Exception'])">
+      <xi:fallback/>
+     </xi:include>
+     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Exception'])">
+      <xi:fallback/>
+     </xi:include>
+    </classsynopsis>
+   </packagesynopsis>
+  </section>
+ </partintro>
+</reference>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->

From dc3a8c1758e43c74f117267e6c2eb4bedfb586e9 Mon Sep 17 00:00:00 2001
From: Mikhail Alferov <malferov@php.net>
Date: Tue, 16 Jun 2026 14:45:59 +0300
Subject: [PATCH 4/5] Update book.xml to en

---
 reference/filter/book.xml | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/reference/filter/book.xml b/reference/filter/book.xml
index f319d2a207..ca7f9ec4a3 100644
--- a/reference/filter/book.xml
+++ b/reference/filter/book.xml
@@ -33,11 +33,11 @@
    для адреса эл. почты символы. Обратите внимание,  очистка проверяет только символы, но не структуру адреса.
   </simpara>
   <simpara>
-   Большая часть фильтров поддерживают дополнительные <emphasis>флаги</emphasis>,
-   которые изменяют поведение фильтра.
+   Бо́льшая часть фильтров поддерживают дополнительные <emphasis>флаги</emphasis>,
+   которые изменяют поведение фильтрации.
    Флаги очистки обозначаются константами <constant>FILTER_FLAG_<replaceable>*</replaceable></constant>.
    Передача флага <constant>FILTER_FLAG_PATH_REQUIRED</constant> с фильтром <constant>FILTER_VALIDATE_URL</constant>
-   потребует, чтобы <acronym>URL</acronym>-адрес содержал компонент пути:
+   потребует, чтобы <acronym>URL</acronym>-адрес содержал путь:
    часть <literal>/foo</literal> в адресе
    <literal>https://example.org/foo</literal>.
   </simpara>
@@ -49,6 +49,9 @@
  &reference.filter.examples;
  &reference.filter.reference;
 
+ &reference.filter.filter.filterexception;
+ &reference.filter.filter.filterfailedexception;
+
 </book>
 <!-- Keep this comment at the end of the file
 Local variables:

From b20eee2e873d58b3cfe14377e6cf093929eb971c Mon Sep 17 00:00:00 2001
From: Mikhail Alferov <malferov@php.net>
Date: Tue, 16 Jun 2026 15:00:28 +0300
Subject: [PATCH 5/5] Update constants.xml to en

---
 reference/filter/constants.xml | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/reference/filter/constants.xml b/reference/filter/constants.xml
index 098174c3ab..3a2e414f22 100644
--- a/reference/filter/constants.xml
+++ b/reference/filter/constants.xml
@@ -155,6 +155,26 @@
     </simpara>
    </listitem>
   </varlistentry>
+  <varlistentry xml:id="constant.filter-throw-on-failure">
+   <term>
+    <constant>FILTER_THROW_ON_FAILURE</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     Флаг устанавливает режим фильтрации, в котором вместо возврата значения &false;
+     модуль выбрасывает исключение <exceptionname>Filter\FilterFailedException</exceptionname>,
+     когда значение не проходит проверку.
+    </simpara>
+    <simpara>
+     Флаг указывают при проверке значений фильтрами семейства
+     <constant>FILTER_VALIDATE_<replaceable>*</replaceable></constant>.
+    </simpara>
+    <simpara>
+     Флаг доступен с PHP 8.5.0.
+    </simpara>
+   </listitem>
+  </varlistentry>
  </variablelist>
 
  <variablelist xml:id="filter.constants.flags.sanitization">