filter_input_array
filter_list
Filter Functions
PHP Manual

# filter_input

(PHP 5 >= 5.2.0)

filter_input — Obtiene una variable desde afuera de PHP y opcionalmente la filtra

### Descripción

mixed filter_input ( int `$tipo` , string `$nombre_variable` [, int `$filtro` [, mixed `$opciones` ]] )

### Lista de parámetros

`tipo`

  Un valor entre `INPUT_GET`, `INPUT_POST`, `INPUT_COOKIE`, `INPUT_SERVER`, `INPUT_ENV`, `INPUT_SESSION` (aun no implementado) y `INPUT_REQUEST` (aun no implementado).

`nombre_variable`

  Nombre de una variable a obtener.

`filtro`

  Filtro a aplicar. Su valor predeterminado es `FILTER_DEFAULT`.

`opciones`

  Matriz asociativa de opciones o disyunción a nivel de bits de banderas. Si el filtro acepta opciones, las banderas pueden definirse en el campo "flags" de la matriz.

### Valores retornados

El valor de la variable solicitada en caso de éxito, `FALSE` si el filtro falla, o `NULL` si la variable `nombre_variable` no está definida. Si la bandera `FILTER_NULL_ON_FAILURE` es usada, se devuelve `FALSE` si la variable no está definida y `NULL` si el filtro falla.

### Ejemplos

Example #1 Un ejemplo de filter_input()

`<?php
$html_busqueda = filter_input(INPUT_GET, 'busqueda', FILTER_SANITIZE_SPECIAL_CHARS);
$url_busqueda = filter_input(INPUT_GET, 'busqueda', FILTER_SANITIZE_ENCODED);
echo "Ha realizado una búsqueda por $html_busqueda.\n";
echo "<a href='?buscar=$url_busqueda'>Buscar de nuevo.</a>";
?>`

El resultado del ejemplo seria algo similar a:

    Ha realizado una búsqueda por Me &#38; son.
    <a href='?buscar=Me%20%26%20son'>Buscar de nuevo.</a>

### Ver también

- filter_var() - Filtra una variable con un filtro específico
- filter_input_array() - Obtiene múltiples variables desde afuera de PHP y opcionalmente las filtra
- filter_var_array() - Obtiene múltiples variables y opcionalmente las filtra

filter_input_array
filter_list
Filter Functions
PHP Manual