Função PHP filter_input_array()
Exemplo
Use a função filter_input_array() para filtrar três variáveis POST. As variáveis POST recebidas são nome, idade e e-mail:
<?php
$filters = array (
"name" => array ("filter"=>FILTER_CALLBACK,
"flags"=>FILTER_FORCE_ARRAY,
"options"=>"ucwords"
),
"age" => array ( "filter"=>FILTER_VALIDATE_INT,
"options"=>array("min_range"=>1,"max_range"=>120)
),
"email" => FILTER_VALIDATE_EMAIL
);
print_r(filter_input_array(INPUT_POST, $filters));
?>
A saída do código acima será:
Definição e uso
A função filter_input_array() obtém variáveis externas (por exemplo, da entrada do formulário) e, opcionalmente, as filtra.
Esta função é útil para recuperar/filtrar muitos valores ao invés de chamar filter_input() muitas vezes.
Sintaxe
filter_input_array(type, definition, add_empty)
Valores de parâmetro
Parameter | Description |
---|---|
type | Required. The input type to check for. Can be one of the following:
|
definition | Optional. Specifies an array of filter arguments. A valid array key is a variable name, and a valid value is a filter name or ID, or an array specifying the filter, flags and options. This parameter can also be a single filter name/ID; then all values in the input array are filtered by the specified filter |
add_empty | Optional. A Boolean value. TRUE adds missing keys as NULL to the return value. Default value is TRUE |
Detalhes técnicos
Valor de retorno: | Um array com os valores das variáveis em caso de sucesso, FALSE em caso de falha |
---|---|
Versão do PHP: | 5.2+ |
Registro de alterações do PHP: | PHP 5.4 - O parâmetro add_empty foi adicionado |
❮ Referência completa do filtro PHP