(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().
type
INPUT_*
.
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
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.
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_TIME
dans le tableauINPUT_SERVER
car elle est insérée dans la variable $_SERVER plus tard.
FILTER_VALIDATE_*
FILTER_SANITIZE_*