filter_input

(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

Descrição

filter_input(
    int $type,
    string $var_name,
    int $filter = FILTER_DEFAULT,
    array|int $options = 0
): mixed

Parâmetros

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 Retornado

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.

Exemplos

Example #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 &#38; son.
<a href='?search=Me%20%26%20son'>Pesquise novamente.</a>

Veja Também