# filter_input

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

filter_input — Ré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

- filter_input_array() - Récupère plusieurs valeurs externes et les filtre
- filter_var() - Filtre une variable avec un filtre spécifique
- filter_var_array() - Récupère plusieurs variables et les filtre
- Les filtres de validation `FILTER_VALIDATE_*`
- Les filtres de purification `FILTER_SANITIZE_*`