array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'uk', ), 'this' => array ( 0 => 'function.filter-input.php', 1 => 'filter_input', 2 => 'Gets a specific external variable by name and optionally filters it', ), 'up' => array ( 0 => 'ref.filter.php', 1 => 'Функції Filter', ), 'prev' => array ( 0 => 'function.filter-id.php', 1 => 'filter_id', ), 'next' => array ( 0 => 'function.filter-input-array.php', 1 => 'filter_input_array', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'en', 'path' => 'reference/filter/functions/filter-input.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

filter_input

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

filter_input — Gets a specific external variable by name and optionally filters it

Опис

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

Параметри

type
One of the INPUT_* constants.
Увага

The content of the superglobal that is being filtered is the original "raw" content provided by the SAPI, prior to any user modification to the superglobal. To filter a modified superglobal use filter_var() instead.

var_name
Name of a variable to filter inside the corresponding type superglobal.
filter
The filter to apply. Can be a validation filter by using one of the FILTER_VALIDATE_* constants, a sanitization filter by using one of the FILTER_SANITIZE_* or FILTER_UNSAFE_RAW, or a custom filter by using FILTER_CALLBACK.

Зауваження: The default is FILTER_DEFAULT, which is an alias of FILTER_UNSAFE_RAW. This will result in no filtering taking place by default.

options
Either an associative array of options, or a bitmask of filter flag constants FILTER_FLAG_*. If the filter accepts options, flags can be provided by using the "flags" field of array.

Значення, що повертаються

On success returns the filtered variable. If the variable is not set false is returned. On failure false is returned, unless the FILTER_NULL_ON_FAILURE flag is used, in which case null is returned.

Приклади

Приклад #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>";
?>

Поданий вище приклад виведе щось схоже на:

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

Прогляньте також