# filter_input

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

filter_input — Toma una variable externa concreta por su nombre y opcionalmente la filtra

### Descripción

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

### Parámetros

`type`

  Uno de los siguientes: `INPUT_GET`, `INPUT_POST`, `INPUT_COOKIE`, `INPUT_SERVER` o `INPUT_ENV`.

`variable_name`

  Nombre de la variable a escoger.

`filter`

  El ID del filtro a aplicar. La página Tipos de filtros del manual enumera los filtros disponibles.

  Si se omite, se utilizará `FILTER_DEFAULT`, que es equivalente a `FILTER_UNSAFE_RAW`. Esto resultará en que no se realice ningún tipo de filtro de forma predeterminada.

`options`

  Array asociativo de opciones o disyunción lógica de flags. Si el filtro acepta opciones, se pueden añadir flags en el array asociativo bajo la clave "flags".

### Valores devueltos

En caso de éxito, valor de la variable pedida, `false` si el filtro falla o `null` si la variable `variable_name` no está definida. Si se usa el flag `FILTER_NULL_ON_FAILURE`, retorna `false` si la variable no está definida y `null` si el filtro falla.

### Ejemplos

Ejemplo #1 Un ejemplo de filter_input()

`<?php
$buscar_html = filter_input(INPUT_GET, 'buscar', FILTER_SANITIZE_SPECIAL_CHARS);
$buscar_url = filter_input(INPUT_GET, 'buscar', FILTER_SANITIZE_ENCODED);
echo "Has buscado $buscar_html.\n";
echo "<a href='?buscar=$buscar_url'>Buscar de nuevo</a>";
?>`

El resultado del ejemplo sería algo similar a:

    Has buscado Yo & hijo.
    <a href='?buscar=Yo%20%26%20hijo'>Buscar de nuevo</a>

### Ver también

- filter_var() - Filtra una variable con el filtro que se indique
- filter_input_array() - Obtiene variables externas y opcionalmente las filtra
- filter_var_array() - Retorna múltiple variables y opcionalmente las filtra
- Tipos de filtros