Skip to content

[Sync-En] filter: version the FILTER_CALLBACK flags note #1099

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
julionc merged 1 commit into from
Aug 26, 2026
+16 −7
Merged

[Sync-En] filter: version the FILTER_CALLBACK flags note #1099

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
23 changes: 16 additions & 7 deletions reference/filter/constants.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 911fe79de766ef4475bf22446903667a0f3a24d3 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 1900175b061e4de78f5ba3e79874e457d7e710a1 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes Maintainer: Marqitos -->
<!-- Generated by xml_proto.php v2.4. Found in /scripts directory of phpdoc. -->
<appendix xml:id="filter.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
Expand Down Expand Up @@ -719,9 +719,9 @@
(<type>int</type>)
</term>
<listitem>
<para>
<simpara>
Valida el valor como dirección IP.
</para>
</simpara>
<variablelist xml:id="filter.constants.validation.ip.options">
<title>Opciones disponibles</title>
<varlistentry>
Expand Down Expand Up @@ -1231,12 +1231,21 @@ NULL
]]>
</screen>
</example>
<warning>
<note>
<simpara>
Este filtro no puede usarse con ningún otro flag de filtro, por ejemplo,
<constant>FILTER_NULL_ON_FAILURE</constant>.
A partir de PHP 8.1.25 y 8.2.12, los flags estructurales
<constant>FILTER_REQUIRE_ARRAY</constant>,
<constant>FILTER_FORCE_ARRAY</constant> y
<constant>FILTER_REQUIRE_SCALAR</constant> se aplican a este filtro, y
<constant>FILTER_NULL_ON_FAILURE</constant> cambia la forma en que se
informa de tal fallo estructural. En versiones anteriores todos los flags
eran ignorados. Los flags específicos del filtro siempre son ignorados y,
dado que el valor devuelto por la retrollamada es el resultado, la
retrollamada en sí misma no puede fallar: ningún flag convierte un
<literal>false</literal> devuelto por la retrollamada en &null; o en una
excepción.
</simpara>
</warning>
</note>
</listitem>
</varlistentry>
</variablelist>
Expand Down