(PHP 5 >= 5.2.0, PHP 7, PHP 8)
filter_input_array — Obtiene variables externas y opcionalmente las filtra
$type
, array|int $options
= FILTER_DEFAULT
, bool $add_empty
= true
): array|false|nullEsta función es útil para recuperar muchos valores sin necesidad de llamar repetidamente a filter_input().
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.
options
FILTER_VALIDATE_*
o un filtro de saneamiento mediante el uso de una de las constantes
FILTER_SANITIZE_*
.
La array de opciones es un array asociativo donde la clave corresponde
a una clave en la matriz de datos array
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
aplicar a esta entrada.
El array asociativo que describe cómo se debe aplicar un filtro
debe contener la clave 'filter'
cuyo valor asociado
es el filtro a aplicar, que puede ser uno de las constantes
FILTER_VALIDATE_*
,
FILTER_SANITIZE_*
,
FILTER_UNSAFE_RAW
, o
FILTER_CALLBACK
.
Opcionalmente, puede contener la clave 'flags'
,
que especifica los indicadores que se aplican al filtro,
y la clave 'options'
, que especifica las opciones
que se aplican al filtro.
add_empty
Añade claves faltantes como null
al valor devuelto.
En caso de éxito, un tableau que contiene los valores de las variables solicitadas.
En caso de fallo, se devuelve false
.
Excepto si el fallo es que el array de entrada designado por
type
no está poblado, donde se devuelve null
si se usa el flag FILTER_NULL_ON_FAILURE
.
Las entradas faltantes del array de entrada se rellenarán en el array
devuelto si add_empty
es true
.
En cuyo caso, las entradas faltantes se establecerán en null
,
a menos que se use el flag FILTER_NULL_ON_FAILURE
,
en cuyo caso será false
.
Un valor del array devuelto será false
si el filtro falla,
a menos que se use el flag FILTER_NULL_ON_FAILURE
,
en cuyo caso será null
.
Nota:
No hay una clave
REQUEST_TIME
en el arrayINPUT_SERVER
porque este valor es insertado en $_SERVER posteriormente.
FILTER_VALIDATE_*
FILTER_SANITIZE_*