(PHP 5 >= 5.2.0, PHP 7)
filter_input — Récupère une variable externe et la filtre
type
Une constante parmi INPUT_GET
, INPUT_POST
,
INPUT_COOKIE
, INPUT_SERVER
ou
INPUT_ENV
.
variable_name
Nom de la variable à récupérer.
filter
L'ID du filtre à appliquer. La Types de filtres page du manuel liste les filtres disponibles.
Si non spécifié, FILTER_DEFAULT
sera utilisé, ce qui est équivalent à
FILTER_UNSAFE_RAW
.
Cela reviendra à n'avoir aucun filtre en place par défaut.
options
Tableau associatif d'options ou des drapeaux. Si le filtre accepte les options, les drapeaux peuvent être fournis dans le champ "flags" du tableau.
Valeur de la variable demandée en cas de succès, FALSE
si le filtre échoue,
ou NULL
si la variable variable_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.
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>";
?>
L'exemple ci-dessus va afficher quelque chose de similaire à :
Vous avez recherché Me & son. <a href='?search=Me%20%26%20son'>Nouvelle recherche.</a>