(PHP 5 >= 5.2.0)
filter_input — Obtem a específica variável externa pelo nome e opcionalmente a filtra
type
Um dos INPUT_GET, INPUT_POST,
INPUT_COOKIE, INPUT_SERVER,
INPUT_ENV, INPUT_SESSION (não
implementado ainda) e INPUT_REQUEST (não
implementado ainda).
variable_name
Nome da variável a ser obtida.
filter
Filtro a ser aplicado. O padrão é FILTER_DEFAULT.
options
Array associativo de opções ou disjunção com operação binário dos flags. Se o filtro aceita opções, flags podem ser providas no campo "flags" da array.
Valor da requisitada variável em caso de sucesso, FALSE se o filtro falhar,
ou NULL se o parâmetro variable_name é um variável não definida.
Se a flag FILTER_NULL_ON_FAILURE é usada, ela
retorna FALSE se a variável não é definida e NULL se o filtro falhar.
Exemplo #1 Um exemplo da 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 "You have searched for $search_html.\n";
echo "<a href='?search=$search_url'>Search again.</a>";
?>
O exemplo acima irá imprimir algo similar à:
You have searched for Me & son. <a href='?search=Me%20%26%20son'>Search again.</a>