(PHP 5 >= 5.2.0, PHP 7, PHP 8)
filter_input_array — Obtem variáveis externas e opcionalmente as filtra
$type
, array|int $options
= FILTER_DEFAULT
, bool $add_empty
= true
): array|false|nullEsta função é útil para receber muitos valores sem repetidamente chamar a função filter_input().
type
INPUT_*
.
O conteúdo da superglobal que está sendo filtrada é o conteúdo "bruto" original fornecido pela SAPI, antes de qualquer modificação de usuário na superglobal. Para filtrar uma superglobal modificada, use a função filter_var_array().
options
FILTER_VALIDATE_*
,
ou um filtro de sanitização, usando uma das
constantes
FILTER_SANITIZE_*
.
O array de opções é um array associativo onde a chave corresponde
a uma chave no array
de dados e o valor
associado é o filtro a ser aplicado a esta entrada
ou um array associativo descrevendo como e qual filtro deve ser
aplicado a esta entrada.
O array associativo que descreve como um filtro deve ser aplicado
deve conter a chave 'filter'
cujo valor associado
é o filtro a ser aplicado, que pode ser uma das constantes
FILTER_VALIDATE_*
,
FILTER_SANITIZE_*
,
FILTER_UNSAFE_RAW
ou
FILTER_CALLBACK
.
Opcionalmente, ele pode conter a chave 'flags'
que especifica os sinalizadores que se aplicam ao filtro,
e a chave 'options'
que especifica quaisquer opções
que se aplicam ao filtro.
add_empty
Adiciona chaves ausentes como null
ao valor de retorno.
Em caso de sucesso, um array contendo os valores das variáveis solicitadas.
Em caso de falha, retorna false
.
Exceto se a falha é aquela na qual o array de entrada designado por
type
não é populado onde null
é retornado
se a opção FILTER_NULL_ON_FAILURE
for utilizada.
Entradas faltantes do array de entrada serão populadas no
array retornado se add_empty
for true
.
Neste caso, entradas faltantes serão definidas para null
,
a menos que a opção FILTER_NULL_ON_FAILURE
seja usada,
que neste caso serão false
.
Uma entrada do array retornado será false
se o filtro falhar,
a menos que a opção FILTER_NULL_ON_FAILURE
seja usada,
que neste caso será null
.
Nota:
Não existe a chave
REQUEST_TIME
no arrayINPUT_SERVER
porque ela será inserida na variável $_SERVER mais tarde.
FILTER_VALIDATE_*
FILTER_SANITIZE_*