(PHP 5 >= 5.2.0, PHP 7, PHP 8)
filter_input — Toma una variable externa concreta por su nombre y opcionalmente la filtra
type
INPUT_*
.
El contenido de la superglobal que se está filtrando es el original "sin procesar" proporcionado por SAPI, antes de cualquier modificación del usuario a la superglobal. Para filtrar una superglobal modificada, utilice filter_var_array() en su lugar.
var_name
type
.
filter
FILTER_VALIDATE_*
,
un filtro de saneamiento usando una de las constantes
FILTER_SANITIZE_*
o FILTER_UNSAFE_RAW
, o un filtro personalizado usando
FILTER_CALLBACK
.
Nota: Por omisión es
FILTER_DEFAULT
, que es un alias deFILTER_UNSAFE_RAW
. Esto resultará en que no se aplique ningún filtro por omisión.
options
FILTER_FLAG_*
.
Si el filter
acepta opciones,
los indicadores pueden ser proporcionados usando el campo "flags"
del array.
En caso de éxito devuelve la variable filtrada.
Si la variable no está definida se devuelve false
.
En caso de fallo se devuelve false
,
a menos que se use el flag FILTER_NULL_ON_FAILURE
,
en cuyo caso se devuelve null
.
Ejemplo #1 Un ejemplo de filter_input()
<?php
$search_html = filter_input(INPUT_GET, 'search', FILTER_SANITIZE_SPECIAL_CHARS);
$search_url = filter_input(INPUT_GET, 'search', FILTER_SANITIZE_ENCODED);
echo "Has buscado $search_html.\n";
echo "<a href='?search=$search_url'>Busca de nuevo.</a>";
?>
El resultado del ejemplo sería algo similar a:
Has buscado Me & son. <a href='?search=Me%20%26%20son'>Busca de nuevo.</a>
FILTER_VALIDATE_*
FILTER_SANITIZE_*