Toma una variable externa concreta por nombre y opcionalmente la filtra

Descripción

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

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: ID del filtro a usar. La página del manual Tipos de filtros lista los filtros disponibles.
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='?search=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