Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
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
36 changes: 35 additions & 1 deletion reference/filter/functions/filter-has-var.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 627f933cfe6a033dccac32982cd68e7c1b86927f Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: d5e14b9107cacb7d7257ebcf4beec48e0ea741bc Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.filter-has-var">
<refnamediv>
Expand Down Expand Up @@ -44,6 +44,40 @@
</para>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
Lanza una <exceptionname>ValueError</exceptionname> si
<parameter>input_type</parameter> no es una de las constantes
<constant>INPUT_<replaceable>*</replaceable></constant>.
</simpara>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
Ahora se lanza una <exceptionname>ValueError</exceptionname> si
<parameter>input_type</parameter> no es una de las constantes
<constant>INPUT_<replaceable>*</replaceable></constant>;
anteriormente, se devolvía &false;.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>

</refentry>
<!-- Keep this comment at the end of the file
Local variables:
Expand Down
62 changes: 61 additions & 1 deletion reference/filter/functions/filter-input-array.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 85264ba268a398c4b90c1948839d54ce688dd5cd Maintainer: Marqitos Status: ready -->
<!-- EN-Revision: d5e14b9107cacb7d7257ebcf4beec48e0ea741bc Maintainer: Marqitos Status: ready -->
<refentry xml:id="function.filter-input-array" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
<refnamediv>
<refname>filter_input_array</refname>
Expand Down Expand Up @@ -73,6 +73,66 @@
</simpara>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
Lanza una <exceptionname>ValueError</exceptionname> si
<parameter>type</parameter> no es una de las constantes
<constant>INPUT_<replaceable>*</replaceable></constant>.
</simpara>
<simpara>
Si el array de entrada designado por <parameter>type</parameter> está
poblado, lanza una <exceptionname>TypeError</exceptionname> si
<parameter>options</parameter> es un &array; con una clave que no es un
&string;, y una <exceptionname>ValueError</exceptionname> si tiene una clave
vacía.
</simpara>
<simpara>
A partir de PHP 8.5.0, lanza una
<exceptionname>Filter\FilterFailedException</exceptionname> si se utiliza el
flag <constant>FILTER_THROW_ON_FAILURE</constant> para una entrada
presente en el array de entrada y su filtro falla,
y una <exceptionname>ValueError</exceptionname> si ese flag se utiliza junto
con <constant>FILTER_NULL_ON_FAILURE</constant> para dicha entrada.
</simpara>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
Ahora se lanza una <exceptionname>ValueError</exceptionname> si
<parameter>type</parameter> no es una de las constantes
<constant>INPUT_<replaceable>*</replaceable></constant>;
anteriormente, el array de entrada se trataba como no poblado.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Si el array de entrada designado por <parameter>type</parameter> está
poblado, ahora se lanza una <exceptionname>TypeError</exceptionname> si
<parameter>options</parameter> tiene una clave que no es un &string;,
y una <exceptionname>ValueError</exceptionname> si tiene una clave vacía;
anteriormente, se emitía un <constant>E_WARNING</constant> y se devolvía
&false;.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<example>
Expand Down
54 changes: 46 additions & 8 deletions reference/filter/functions/filter-input.xml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: f7e68a1a35d622977d1a1c2155795204243ec3f1 Maintainer: Marqitos Status: ready -->
<!-- EN-Revision: d5e14b9107cacb7d7257ebcf4beec48e0ea741bc Maintainer: Marqitos Status: ready -->
<!-- Reviewed: no -->
<!-- Generated by xml_proto.php v2.4. Found in /scripts directory of phpdoc. -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xml:id="function.filter-input">
Expand Down Expand Up @@ -34,7 +34,7 @@
"sin procesar" proporcionado por <acronym>SAPI</acronym>,
antes de cualquier modificación del usuario a la superglobal.
Para filtrar una superglobal modificada, utilice
<function>filter_var_array</function> en su lugar.
<function>filter_var</function> en su lugar.
</simpara>
</warning>
</listitem>
Expand All @@ -48,12 +48,8 @@
</simpara>
</listitem>
</varlistentry>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('function.filter-var')/db:refsect1[@role='parameters']//db:varlistentry[db:term[db:parameter[text()='filter']]]/.)">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('function.filter-var')/db:refsect1[@role='parameters']//db:varlistentry[db:term[db:parameter[text()='options']]]/.)">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('function.filter-var')/db:refsect1[@role='parameters']//db:varlistentry[db:term[db:parameter[text()='filter']]]/.)"/>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('function.filter-var')/db:refsect1[@role='parameters']//db:varlistentry[db:term[db:parameter[text()='options']]]/.)"/>
</variablelist>
</refsect1>

Expand All @@ -69,6 +65,48 @@
</simpara>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
Lanza una <exceptionname>ValueError</exceptionname> si
<parameter>type</parameter> no es una de las constantes
<constant>INPUT_<replaceable>*</replaceable></constant>.
</simpara>
<simpara>
A partir de PHP 8.5.0, lanza una
<exceptionname>Filter\FilterFailedException</exceptionname> si se utiliza el
flag <constant>FILTER_THROW_ON_FAILURE</constant> y el filtro falla o la
variable <parameter>var_name</parameter> no está definida,
y una <exceptionname>ValueError</exceptionname> si ese flag se utiliza junto
con <constant>FILTER_NULL_ON_FAILURE</constant>.
</simpara>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
Ahora se lanza una <exceptionname>ValueError</exceptionname> si
<parameter>type</parameter> no es una de las constantes
<constant>INPUT_<replaceable>*</replaceable></constant>;
anteriormente, la variable se trataba como no definida.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<example>
Expand Down
54 changes: 49 additions & 5 deletions reference/filter/functions/filter-var-array.xml
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 85264ba268a398c4b90c1948839d54ce688dd5cd Maintainer: Marqitos Status: ready -->
<!-- EN-Revision: d5e14b9107cacb7d7257ebcf4beec48e0ea741bc Maintainer: Marqitos Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.filter-var-array">
<refnamediv>
<refname>filter_var_array</refname>
<refpurpose>Obtiene múltiple variables y opcionalmente las filtra</refpurpose>
<refpurpose>Obtiene múltiples variables y opcionalmente las filtra</refpurpose>
</refnamediv>

<refsect1 role="description">
Expand All @@ -20,7 +20,7 @@
<constant>FILTER_VALIDATE_<replaceable>*</replaceable></constant>,
filtros de saneación
<constant>FILTER_SANITIZE_<replaceable>*</replaceable></constant>,
o filtros definidos por el usuario
o filtros definidos por el usuario.
</simpara>
</refsect1>

Expand All @@ -47,7 +47,7 @@
<constant>FILTER_SANITIZE_<replaceable>*</replaceable></constant>.
</simpara>
<simpara>
La array de opciones es un array asociativo donde la clave corresponde
El array de opciones es un array asociativo donde la clave corresponde
a una clave del array de entrada y el valor
asociado es el filtro a aplicar a esta entrada,
o un array asociativo que describe cómo y qué filtro se debe
Expand All @@ -56,7 +56,7 @@
<simpara>
El array asociativo que describe cómo se debe aplicar un filtro
debe contener la clave <literal>'filter'</literal> cuyo valor asociado
es el filtro a aplicar, que puede ser uno de las constantes
es el filtro a aplicar, que puede ser una de las constantes
<constant>FILTER_VALIDATE_<replaceable>*</replaceable></constant>,
<constant>FILTER_SANITIZE_<replaceable>*</replaceable></constant>,
<constant>FILTER_UNSAFE_RAW</constant>, o
Expand Down Expand Up @@ -102,6 +102,50 @@
</simpara>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
Lanza una <exceptionname>TypeError</exceptionname> si
<parameter>options</parameter> es un &array; con una clave que no es un
&string;, y una <exceptionname>ValueError</exceptionname> si tiene una clave
vacía.
</simpara>
<simpara>
A partir de PHP 8.5.0, lanza una
<exceptionname>Filter\FilterFailedException</exceptionname> si se utiliza el
flag <constant>FILTER_THROW_ON_FAILURE</constant> para una entrada
presente en <parameter>array</parameter> y su filtro falla,
y una <exceptionname>ValueError</exceptionname> si ese flag se utiliza junto
con <constant>FILTER_NULL_ON_FAILURE</constant> para dicha entrada.
</simpara>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
Ahora se lanza una <exceptionname>TypeError</exceptionname> si
<parameter>options</parameter> tiene una clave que no es un &string;,
y una <exceptionname>ValueError</exceptionname> si tiene una clave vacía;
anteriormente, se emitía un <constant>E_WARNING</constant> y se devolvía
&false;.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<example>
Expand Down
13 changes: 12 additions & 1 deletion reference/filter/functions/filter-var.xml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 83dd6312885d60196054b02bbaa339cfd33c2d9c Maintainer: Marqitos Status: ready -->
<!-- EN-Revision: d5e14b9107cacb7d7257ebcf4beec48e0ea741bc Maintainer: Marqitos Status: ready -->
<!-- Reviewed: no -->
<!-- Generated by xml_proto.php v2.4. Found in /scripts directory of phpdoc. -->
<refentry xml:id="function.filter-var" xmlns="http://docbook.org/ns/docbook">
Expand Down Expand Up @@ -92,6 +92,17 @@
</simpara>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
A partir de PHP 8.5.0, lanza una
<exceptionname>Filter\FilterFailedException</exceptionname> si se utiliza el
flag <constant>FILTER_THROW_ON_FAILURE</constant> y el filtro falla,
y una <exceptionname>ValueError</exceptionname> si ese flag se utiliza junto
con <constant>FILTER_NULL_ON_FAILURE</constant>.
</simpara>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<example>
Expand Down
43 changes: 42 additions & 1 deletion reference/stream/functions/stream-context-create.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: c49274b06187db6cf96df8a48e5a3b92d1b56b16 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e01174bde78948fb9cdc50933039754ccade11aa Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->

<refentry xml:id="function.stream-context-create" xmlns="http://docbook.org/ns/docbook">
Expand Down Expand Up @@ -61,6 +61,27 @@
</para>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
Lanza una <exceptionname>ValueError</exceptionname> si
<parameter>options</parameter>, o la entrada <literal>options</literal> de
<parameter>params</parameter>, no tiene el formato
<literal>$arr['wrapper']['option'] = $value</literal>,
es decir, si uno de sus elementos no es un array o tiene una clave entera.
</simpara>
<simpara>
Lanza una <exceptionname>TypeError</exceptionname> si la entrada
<literal>options</literal> de <parameter>params</parameter>
no es un array.
</simpara>
<simpara>
Lanza una <exceptionname>TypeError</exceptionname> si la entrada
<literal>notification</literal> de <parameter>params</parameter>
no es un callback válido.
</simpara>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
Expand All @@ -72,12 +93,32 @@
</row>
</thead>
<tbody>
<row>
<entry>8.5.0</entry>
<entry>
Ahora lanza una <exceptionname>TypeError</exceptionname> si la entrada
<literal>notification</literal> de <parameter>params</parameter>
no es un callback válido.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
<parameter>options</parameter> y <parameter>params</parameter> ahora son nullable.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Ahora lanza una <exceptionname>ValueError</exceptionname> si
<parameter>options</parameter>, o la entrada <literal>options</literal> de
<parameter>params</parameter>, no tiene el formato esperado,
y una <exceptionname>TypeError</exceptionname> si la entrada
<literal>options</literal> de <parameter>params</parameter>
no es un array.
Anteriormente, se emitía un <constant>E_WARNING</constant>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
Expand Down
Loading
Loading