PHP filter_input_array() Fonction
Exemple
Utilisez la fonction filter_input_array() pour filtrer trois variables POST. Les variables POST reçues sont le nom, l'âge et l'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 ci-dessus sera :
Array
(
[name] => Peter
[age] => 41
[email] => peter@example.com
) Définition et Utilisation
La fonction filter_input_array() permet d'obtenir des variables externes (par exemple, à partir d'une entrée de formulaire) et de les filtrer éventuellement.
Cette fonction est utile pour récupérer ou filtrer plusieurs valeurs au lieu d'appeler filter_input() plusieurs fois.
Syntaxe
filter_input_array( type, definition, add_empty ) Valeurs des Paramètres
| Paramètre | Description |
|---|---|
| type | Requis. Le type d'entrée à vérifier. Peut être l'un des suivants :
|
| definition | Optionnel. Spécifie un tableau d'arguments de filtre. Une clé de tableau valide est un nom de variable, et une valeur valide est un nom ou un ID de filtre, ou un tableau spécifiant le filtre, les drapeaux et les options. Ce paramètre peut également être un seul nom ou ID de filtre ; dans ce cas, toutes les valeurs du tableau d'entrée sont filtrées par le filtre spécifié. |
| add_empty | Optionnel. Une valeur booléenne. TRUE ajoute les clés manquantes comme NULL à la valeur de retour. La valeur par défaut est TRUE. |
Détails Techniques
| Valeur de Retour : | Un tableau avec les valeurs des variables en cas de succès, FALSE en cas d'échec. |
|---|---|
| Version PHP : | 5.2+ |
| Journal des Modifications PHP : | PHP 5.4 - Le paramètre add_empty a été ajouté. |