(PHP 5 >= 5.2.0, PHP 7, PHP 8)
filter_input — Récupère une variable externe et la filtre
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() à la place.
var_name
type
.
filter
FILTER_VALIDATE_*
,
un filtre de purification en utilisant une des constantes
FILTER_SANITIZE_*
,
ou FILTER_UNSAFE_RAW
, ou un filtre personalisé
en utilisant FILTER_CALLBACK
.
Note: Le filtre par défaut est
FILTER_DEFAULT
, qui est un alias deFILTER_UNSAFE_RAW
. Ceci resulte en aucun filtrage par default.
options
FILTER_FLAG_*
.
Si le filter
accepte des options,
les drapeaux peuvent être fournis en utilisant la clé
"flags"
du tableau.
Valeur de la variable demandée en cas de succès, false
si le filtre échoue,
ou null
si la variable var_name
n'est pas définie.
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.
En cas de succès retourne la variable filtré.
En cas d'échec false
est retourné,
sauf si le drapeau FILTER_NULL_ON_FAILURE
est utilisé,
dans ce cas là null
est retourné.
Exemple #1 Exemple avec filter_input()
<?php
$search_html = filter_input(INPUT_GET, 'search', FILTER_SANITIZE_SPECIAL_CHARS);
$search_url = filter_input(INPUT_GET, 'search', FILTER_SANITIZE_ENCODED);
echo "Vous avez recherché $search_html.\n";
echo "<a href='?search=$search_url'>Nouvelle recherche.</a>";
?>
Résultat de l'exemple ci-dessus est similaire à :
Vous avez recherché Me & son. <a href='?search=Me%20%26%20son'>Nouvelle recherche.</a>
FILTER_VALIDATE_*
FILTER_SANITIZE_*