filter_input

(PHP 5 >= 5.2.0, PHP 7, PHP 8)

filter_inputGets a specific external variable by name and optionally filters it

Descrição

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

Parâmetros

type

One of INPUT_GET, INPUT_POST, INPUT_COOKIE, INPUT_SERVER, or INPUT_ENV.

var_name

Name of a variable to get.

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

Associative array of options or bitwise disjunction of flags. If filter accepts options, flags can be provided in "flags" field of array.

Valor Retornado

Value of the requested variable on success, false if the filter fails, or null if the var_name variable is not set. If the flag FILTER_NULL_ON_FAILURE is used, it returns false if the variable is not set and null if the filter fails.

Exemplos

Exemplo #1 A filter_input() example

<?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 produzirá algo semelhante a:

You have searched for Me &#38; son.
<a href='?search=Me%20%26%20son'>Search again.</a>

Veja Também