filter_input_array

(PHP 5 >= 5.2.0, PHP 7, PHP 8)

filter_input_array — Récupère plusieurs valeurs externes et les filtre

Description

filter_input_array(int $type, array|int $options = FILTER_DEFAULT, bool $add_empty = true): array|false|null

Cette fonction est utile pour récupérer plusieurs valeurs sans avoir à appeler plusieurs fois la fonction filter_input().

Liste de paramètres

type
Une des constantes INPUT_*.
Avertissement

Le contenu de la superglobale qui est filtrée est le contenu original "brut" fourni par le SAPI, avant toute modification utilisateur de la superglobale. Pour filtrer une superglobale modifiée utiliser filter_var_array() à la place.

options
Soit un array associatif d'option, soit un filtre à appliquer à chaque entrée, qui peut être un filtre de validation en utilisant une des constantes FILTER_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 comment 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.

Valeurs de retour

En cas de succès, un tableau contenant les valeurs des variables demandées.

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 manquantes du tableau d'entrée seront alimentées dans le tableau retourné si add_empty est true. Auquel cas, les entrées manquantes seront définies à null, sauf si le drapeau FILTER_NULL_ON_FAILURE est utilisé, dans quel cas ce sera 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.

Notes

Note:

Il n'y a pas de clé REQUEST_TIME dans le tableau INPUT_SERVER car elle est insérée dans la variable $_SERVER plus tard.

Voir aussi