Récupère une variable externe et la filtre

# filter_input

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

filter_input — Récupère une variable externe et la filtre

### Description

function 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 contenu de la superglobale qui est filtrée est le contenu original "brut" fourni par le SAPI, avant toute modification utilisateur de la superglobale. Pour filtrer une superglobale modifiée, utiliser filter_var() à la place.

`var_name`
  Nom d'une variable à filtrer 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 personnalisé en utilisant `FILTER_CALLBACK`.

  > Note: Le filtre par défaut est `FILTER_DEFAULT`, qui est un alias de `FILTER_UNSAFE_RAW`. Ceci résulte en aucun filtrage par défaut.

`options`
  Soit un array associatif d'options, 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é, `false` est retourné si la variable n'est pas définie et `null` si le filtre échoue.

### 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_*`

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open