Manuel PHP
Précédent |  | Suivant

# filter_input

(no version information, might be only in CVS)

filter_input -- Récupère une variable externe à PHP et la filtre

## Description

mixed filter_input ( int type, string variable_name [, int filter [, mixed options]] )

## Liste de paramètres

`type`

  Une constante parmi `INPUT_GET`, `INPUT_POST`, `INPUT_COOKIE`, `INPUT_SERVER`, `INPUT_ENV`, `INPUT_SESSION` (actuellement non implémenté) ou `INPUT_REQUEST` (actuellement non implémenté).

`variable_name`

  Nom de la variable à récupérer.

`filter`

  Filtre à appliquer. Par défaut, vaut `FILTER_DEFAULT`.

`options`

  Tableau associatif d'options ou des drappeaux. Si le filtre accepte les options, les drappeaux 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 drappeau `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()
filter_input_array()
filter_var_array()

Précédent | Sommaire | Suivant
filter_input_array | Niveau supérieur | filter_list