A função filter_input_array() pega múltiplas entradas (como entradas de formulário) de fora do script e as filtra.
Esta função é útil para filtrar múltiplas variáveis de entrada sem chamar repetidamente filter_input().
Esta função pode receber informações de várias fontes:
INPUT_GET
INPUT_POST
INPUT_COOKIE
INPUT_ENV
INPUT_SERVER
INPUT_SESSION (ainda não implementado)
INPUT_REQUEST (ainda não implementado)
Se for bem-sucedido, os dados filtrados serão retornados como uma matriz. Se falhar, retorna FALSE.
filter_input_array(tipo_de_entrada, filter_args)
| parâmetro | descrever |
|---|---|
| tipo_de_entrada | Obrigatório. Especifica o tipo de entrada. Veja a lista de tipos possíveis acima. |
| filtro_args | Opcional. Especifica uma matriz de parâmetros de filtro. As chaves legais da matriz são nomes de variáveis, e os valores legais são IDs de filtro ou matrizes que especificam filtros, sinalizadores e opções. Este parâmetro também pode ser um único ID de filtro; nesse caso, todos os valores na matriz de entrada serão filtrados pelo filtro especificado. O ID do filtro pode ser um nome de ID (como FILTER_VALIDATE_EMAIL) ou um número de ID (como 274). |
Dica: Consulte o manual de referência completo do PHP Filter para ver os filtros que podem ser usados com esta função.
Neste exemplo, usamos a função filter_input_array() para filtrar três variáveis POST. As variáveis POST recebidas são nome, idade e endereço de e-mail:
<?php$filters = array ( "name" => array ( "filter"=>FILTER_CALLBACK, "flags"=>FILTER_FORCE_ARRAY, "options"=>"ucwords" ), "age" => array ( "filter"= >FILTER_VALIDATE_INT, "opções"=>array ( "min_range"=>1, "max_range"=>120 ) ), "email"=> FILTER_VALIDATE_EMAIL, );print_r(filter_input_array(INPUT_POST, $filtros));?>
A saída do código fica assim:
Array ( [nome] => Peter [idade] => 41 [email] => [email protected] )