filter_input
(PHP 5 >= 5.2.0, PECL filter:0.11.0)
filter_input — Obtem a variável e opcionalmente a filtra
Descrição
Parâmetros
- 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 Retornado
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.
Exemplos
Example#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 a:
You have searched for Me & son. <a href='?search=Me%20%26%20son'>Search again.</a>