La fonction filter_input_array() prend plusieurs entrées (telles que les entrées de formulaire) en dehors du script et les filtre.
Cette fonction est utile pour filtrer plusieurs variables d'entrée sans appeler à plusieurs reprises filter_input().
Cette fonction peut recevoir des entrées de diverses sources :
INPUT_GET
INPUT_POST
INPUT_COOKIE
INPUT_ENV
INPUT_SERVEUR
INPUT_SESSION (pas encore implémenté)
INPUT_REQUEST (pas encore implémenté)
En cas de succès, les données filtrées sont renvoyées sous forme de tableau. En cas d'échec, renvoie FALSE.
filtre_input_array(input_type, filter_args)
| paramètre | décrire |
|---|---|
| type_entrée | Requis. Spécifie le type d'entrée. Voir la liste des types possibles ci-dessus. |
| filtre_args | Facultatif. Spécifie un tableau de paramètres de filtre. Les clés de tableau légales sont des noms de variables et les valeurs légales sont des ID de filtre ou des tableaux spécifiant des filtres, des indicateurs et des options. Ce paramètre peut également être un ID de filtre unique, si tel est le cas, toutes les valeurs du tableau d'entrée sont filtrées par le filtre spécifié. L'ID du filtre peut être un nom d'ID (tel que FILTER_VALIDATE_EMAIL) ou un numéro d'ID (tel que 274). |
Astuce : Consultez le manuel de référence complet des filtres PHP pour voir les filtres pouvant être utilisés avec cette fonction.
Dans cet exemple, nous utilisons la fonction filter_input_array() pour filtrer trois variables POST. Les variables POST reçues sont le nom, l'âge et l'adresse 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));?>
La sortie du code ressemble à ceci :
Tableau ( [nom] => Peter [âge] => 41 [email] => [email protected] )