filter_input_array

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

filter_input_arrayRé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 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.

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 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.

Valeurs 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.

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