(PHP 5 >= 5.2.0, PHP 7, PHP 8)
filter_input_array — Récupère plusieurs valeurs externes et les filtre
$type, array|int $options = FILTER_DEFAULT, bool $add_empty = true): array|false|nullCette fonction est utile pour récupérer plusieurs valeurs sans avoir à appeler plusieurs fois la fonction filter_input().
typeINPUT_*.
Le contenue de la superglobale qui est filtrée est le contenue original "brut" fournit par le SAPI, antérieur à toute modification utilisateur de la superglobale. Pour filter une superglobale modifié utilisez filter_var_array() à la place.
optionsFILTER_VALIDATE_*,
un filtre de purification en utilisant une des constantes
FILTER_SANITIZE_*.
Le tableau d'options est un tableau associatif où les clés correspondent
à une clé dans les données array et la valeur
associée est soit le filtre à appliquer à cette entrée,
soit un tableau associatif qui décrit comment et quel filtre devrait
être appliqué à cette entrée.
Le tableau associatif qui décrit comme un filtre devrait être appliqué
doit contenir la clé 'filter' dont sa valeur associée
est le filtre à appliquer, qui peut être une des constantes
FILTER_VALIDATE_*,
FILTER_SANITIZE_*,
FILTER_UNSAFE_RAW, ou
FILTER_CALLBACK.
Il peut contenir facultativement la clé 'flags'
qui spécifie les drapeaux à appliquer au filtre,
et la clé 'options' qui spécifie toute option
qui s'applique au filtre.
add_empty
Ajoute les clés manquantes en tant que null dans la valeur de retour.
Un tableau contenant les valeurs des variables demandées en cas de succès.
Si le tableau d'entrée désigné par type n'est pas populé,
la fonction retourne null si le drapeau FILTER_NULL_ON_FAILURE
n'est pas donnée, sinon false dans le cas contraire. Pour les autres échecs, false est retourné.
Un tableau de valeurs peut valoir false si le filtre échoue,
ou null si la variable n'est pas définie. Ou, si le drapeau
FILTER_NULL_ON_FAILURE est utilisé, la fonction retournera
false si la variable n'est pas définie et null si le filtre échoue.
Si le paramètre add_empty est false,
aucun élément du tableau sera ajouté pour les variables non définie.
En cas de succès, un tableau contenant les valeurs des variables demandés.
En cas d'échec, false est retourné.
Sauf si l'échec est que le tableau d'entrée désigné par
type n'est pas alimenté, auquel cas null est retourné
si le drapeau FILTER_NULL_ON_FAILURE est utilisé.
Les entrèes manquante du tableau d'entrée seront alimenté dans le tableau
retourné si add_empty est true.
Auquel cas, les entrées manquantes seront définie à null,
sauf si le drapeau FILTER_NULL_ON_FAILURE est utilisé,
dans quel cas ils seront false.
Une entrée dans le tableau retourné sera false si le filtre échoue,
sauf si le drapeau FILTER_NULL_ON_FAILURE est utilisé,
dans ce cas ça sera null.
Note:
Il n'y a pas de clé
REQUEST_TIMEdans le tableauINPUT_SERVERcar elle est insérée dans la variable $_SERVER plus tard.
FILTER_VALIDATE_*
FILTER_SANITIZE_*