(PHP 5 >= 5.2.0, PHP 7, PHP 8)
filter_input — Obtém uma variável externa específica por nome e filtra-a opcionalmente
type
Uma das constantes INPUT_GET
, INPUT_POST
,
INPUT_COOKIE
, INPUT_SERVER
ou
INPUT_ENV
.
var_name
Nome de uma variável a ser obtida.
filter
O ID do filtro a ser aplicado. A página do manual Tipos de filtros lista os filtros disponíveis.
Se omitido, FILTER_DEFAULT
será usado, que é
equivalente a
FILTER_UNSAFE_RAW
.
Isso resultará em nenhuma filtragem ocorrendo por padrão.
options
Array associativo de opções ou disjunção binária de opções. Se o filtro aceitar opções, as opções podem ser fornecidas no campo "flags" do array.
Valor da variável requisitada em caso de sucesso, false
se o filtro falhar
ou null
se a variável var_name
não estiver definida.
Se a opção FILTER_NULL_ON_FAILURE
for usada, a função
retorna false
se a variável não estiver definida e null
se o filtro falhar.
Exemplo #1 Um exemplo de 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 "Você pesquisou por $search_html.\n";
echo "<a href='?search=$search_url'>Pesquise novamente.</a>";
?>
O exemplo acima produzirá algo semelhante a:
Você pesquisou por Me & son. <a href='?search=Me%20%26%20son'>Pesquise novamente.</a>