Skip to content

Update Filter to En #1484

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
mmalferov merged 5 commits into from
Jun 16, 2026
+163 −3
Merged

Update Filter to En #1484

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
0a4e179
Create filter.filterexception.xml
mmalferov Jun 16, 2026
617ef97
Update filter.filterexception.xml
mmalferov Jun 16, 2026
8466155
Create filter.filterfailedexception.xml
mmalferov Jun 16, 2026
dc3a8c1
Update book.xml to en
mmalferov Jun 16, 2026
b20eee2
Update constants.xml to en
mmalferov Jun 16, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 6 additions & 3 deletions reference/filter/book.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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>
Expand All @@ -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:
Expand Down
20 changes: 20 additions & 0 deletions reference/filter/constants.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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">
Expand Down
68 changes: 68 additions & 0 deletions reference/filter/filter.filterexception.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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>Исключение Filter\FilterException</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
-->
69 changes: 69 additions & 0 deletions reference/filter/filter.filterfailedexception.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
-->
Loading