(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
typeINPUT_*.
O conteúdo da superglobal que está sendo filtrada é o conteúdo "bruto" original fornecido pela SAPI, antes de qualquer modificação de usuário na superglobal. Para filtrar uma superglobal modificada, use a função filter_var().
var_nametype
correspondente.
filterFILTER_VALIDATE_*,
um filtro de sanitização pelo uso de uma das constantes
FILTER_SANITIZE_*
ou de FILTER_UNSAFE_RAW, ou um filtro cutomizado com o uso de
FILTER_CALLBACK.
Nota: O padrão é
FILTER_DEFAULT, que é um sinônimo deFILTER_UNSAFE_RAW. Isto resultará em nenhuma filtragem por padrão.
optionsFILTER_FLAG_*.
Se filter aceitar opções,
elas podem ser fornecidas pelo uso do campo "flags" do array.
Em caso de sucesso retorna a variável filtrada.
Se a variável não estiver definida, retorna false.
Em caso de falha, retorna false,
a não ser que a opção FILTER_NULL_ON_FAILURE seja usada,
neste caso retorna null.
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>
FILTER_VALIDATE_*
FILTER_SANITIZE_*