Récupère une variable externe et la filtre

# filter_input

(PHP 5 >= 5.2.0, PHP 7)

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

### Description

filter_input ( int `$type` , string `$variable_name` [, int `$filter` = FILTER_DEFAULT [, mixed `$options` ]] ) : mixed

### Liste de paramètres

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

### Valeurs de retour

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.

### 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>";
?>`

L'exemple ci-dessus va afficher quelque chose de similaire à :

    Vous avez recherché Me &#38; son.
    <a href='?search=Me%20%26%20son'>Nouvelle recherche.</a>

### Voir aussi

- filter_var() - Filtre une variable avec un filtre spécifique
- filter_input_array() - Récupère plusieurs valeurs externes et les filtre
- filter_var_array() - Récupère plusieurs variables et les filtre
- Types de filtres