filter_input

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

filter_inputRécupère une variable externe et la filtre

Description

filter_input(
    int $type,
    string $var_name,
    int $filter = FILTER_DEFAULT,
    array|int $options = 0
): mixed

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() à la place.

var_name
Nom d'une variable à filter contenue dans la superglobale correspondant à type.
filter
Le filtre à appliquer. Peut-être un filtre de validation en utilisant une des constantes 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 de FILTER_UNSAFE_RAW. Ceci resulte en aucun filtrage par default.

options
Soit un array associatif d'option, soit un masque de bit des constantes des drapeaux de filtrage FILTER_FLAG_*. Si le filter accepte des options, les drapeaux peuvent être fournis en utilisant la clé "flags" du tableau.

Valeurs de retour

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

Exemples

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 &#38; son.
<a href='?search=Me%20%26%20son'>Nouvelle recherche.</a>

Voir aussi