Skip to content

Commit 1c3150c

Browse files
lacatoirelacatoire
authored
Sync EN: document FILTER_THROW_ON_FAILURE and Filter exception classes (#794)
1 parent 3c63a7a commit 1c3150c

4 files changed

Lines changed: 159 additions & 2 deletions

File tree

‎reference/filter/book.xml‎

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 53054bf8decc8648cf2e90a493692a161e2371af Maintainer: Marqitos Status: ready -->
3+
<!-- EN-Revision: 3d4ee5f40afbfe44db4f1b13a22a6a38d4b40c7b Maintainer: Marqitos Status: ready -->
44
<!-- Reviewed: no Maintainer: seros -->
55
<book xml:id="book.filter" xmlns="http://docbook.org/ns/docbook">
66
<?phpdoc extension-membership="bundled" ?>
@@ -54,6 +54,9 @@
5454
&reference.filter.examples;
5555
&reference.filter.reference;
5656

57+
&reference.filter.filter.filterexception;
58+
&reference.filter.filter.filterfailedexception;
59+
5760
</book>
5861
<!-- Keep this comment at the end of the file
5962
Local variables:

‎reference/filter/constants.xml‎

Lines changed: 20 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 525aa5f198d482c0d03be54ddee5af13b376ab99 Maintainer: PhilDaiguille Status: ready -->
2+
<!-- EN-Revision: 3d4ee5f40afbfe44db4f1b13a22a6a38d4b40c7b Maintainer: PhilDaiguille Status: ready -->
33
<!-- Reviewed: yes Maintainer: Marqitos -->
44
<!-- Generated by xml_proto.php v2.4. Found in /scripts directory of phpdoc. -->
55
<appendix xml:id="filter.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -156,6 +156,25 @@
156156
</simpara>
157157
</listitem>
158158
</varlistentry>
159+
<varlistentry xml:id="constant.filter-throw-on-failure">
160+
<term>
161+
<constant>FILTER_THROW_ON_FAILURE</constant>
162+
(<type>int</type>)
163+
</term>
164+
<listitem>
165+
<simpara>
166+
Lanza una <exceptionname>Filter\FilterFailedException</exceptionname> cuando un
167+
filtro de validación falla, en lugar de devolver &false;.
168+
</simpara>
169+
<simpara>
170+
Utilizable con cualquier filtro de validación
171+
<constant>FILTER_VALIDATE_<replaceable>*</replaceable></constant>.
172+
</simpara>
173+
<simpara>
174+
Disponible a partir de PHP 8.5.0.
175+
</simpara>
176+
</listitem>
177+
</varlistentry>
159178
</variablelist>
160179

161180
<variablelist xml:id="filter.constants.flags.sanitization">

‎reference/filter/filter.filterexception.xml‎

Lines changed: 67 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,67 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: 3d4ee5f40afbfe44db4f1b13a22a6a38d4b40c7b Maintainer: lacatoire Status: ready -->
3+
<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">
4+
<title>La clase Filter\FilterException</title>
5+
<titleabbrev>Filter\FilterException</titleabbrev>
6+
7+
<partintro>
8+
<section xml:id="filter-filterexception.intro">
9+
&reftitle.intro;
10+
<simpara>
11+
La clase base para las <type>Exception</type> lanzadas por la extensión Filter.
12+
</simpara>
13+
</section>
14+
15+
<section xml:id="filter-filterexception.synopsis">
16+
&reftitle.classsynopsis;
17+
18+
<packagesynopsis>
19+
<package>Filter</package>
20+
21+
<classsynopsis class="class">
22+
<ooexception>
23+
<exceptionname>FilterException</exceptionname>
24+
</ooexception>
25+
26+
<ooclass>
27+
<modifier>extends</modifier>
28+
<classname>Exception</classname>
29+
</ooclass>
30+
31+
<classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
32+
<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;']]))">
33+
<xi:fallback/>
34+
</xi:include>
35+
36+
<classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
37+
<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'])">
38+
<xi:fallback/>
39+
</xi:include>
40+
<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'])">
41+
<xi:fallback/>
42+
</xi:include>
43+
</classsynopsis>
44+
</packagesynopsis>
45+
</section>
46+
</partintro>
47+
</reference>
48+
<!-- Keep this comment at the end of the file
49+
Local variables:
50+
mode: sgml
51+
sgml-omittag:t
52+
sgml-shorttag:t
53+
sgml-minimize-attributes:nil
54+
sgml-always-quote-attributes:t
55+
sgml-indent-step:1
56+
sgml-indent-data:t
57+
indent-tabs-mode:nil
58+
sgml-parent-document:nil
59+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
60+
sgml-exposed-tags:nil
61+
sgml-local-catalogs:nil
62+
sgml-local-ecat-files:nil
63+
End:
64+
vim600: syn=xml fen fdm=syntax fdl=2 si
65+
vim: et tw=78 syn=sgml
66+
vi: ts=1 sw=1
67+
-->

‎reference/filter/filter.filterfailedexception.xml‎

Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: 3d4ee5f40afbfe44db4f1b13a22a6a38d4b40c7b Maintainer: lacatoire Status: ready -->
3+
<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">
4+
<title>La clase Filter\FilterFailedException</title>
5+
<titleabbrev>Filter\FilterFailedException</titleabbrev>
6+
7+
<partintro>
8+
<section xml:id="filter-filterfailedexception.intro">
9+
&reftitle.intro;
10+
<simpara>
11+
Lanzada cuando un filtro de validación falla y el indicador
12+
<constant>FILTER_THROW_ON_FAILURE</constant> está activado.
13+
</simpara>
14+
</section>
15+
16+
<section xml:id="filter-filterfailedexception.synopsis">
17+
&reftitle.classsynopsis;
18+
19+
<packagesynopsis>
20+
<package>Filter</package>
21+
22+
<classsynopsis class="class">
23+
<ooexception>
24+
<exceptionname>FilterFailedException</exceptionname>
25+
</ooexception>
26+
27+
<ooclass>
28+
<modifier>extends</modifier>
29+
<classname>Filter\FilterException</classname>
30+
</ooclass>
31+
32+
<classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
33+
<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;']]))">
34+
<xi:fallback/>
35+
</xi:include>
36+
37+
<classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
38+
<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'])">
39+
<xi:fallback/>
40+
</xi:include>
41+
<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'])">
42+
<xi:fallback/>
43+
</xi:include>
44+
</classsynopsis>
45+
</packagesynopsis>
46+
</section>
47+
</partintro>
48+
</reference>
49+
<!-- Keep this comment at the end of the file
50+
Local variables:
51+
mode: sgml
52+
sgml-omittag:t
53+
sgml-shorttag:t
54+
sgml-minimize-attributes:nil
55+
sgml-always-quote-attributes:t
56+
sgml-indent-step:1
57+
sgml-indent-data:t
58+
indent-tabs-mode:nil
59+
sgml-parent-document:nil
60+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
61+
sgml-exposed-tags:nil
62+
sgml-local-catalogs:nil
63+
sgml-local-ecat-files:nil
64+
End:
65+
vim600: syn=xml fen fdm=syntax fdl=2 si
66+
vim: et tw=78 syn=sgml
67+
vi: ts=1 sw=1
68+
-->

0 commit comments

Comments
 (0)