filter_input

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

filter_input — Принимает переменную извне PHP и, при необходимости, фильтрует её

Описание

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

Список параметров

type

Одна из констант INPUT_GET, INPUT_POST, INPUT_COOKIE, INPUT_SERVER или INPUT_ENV.

var_name

Имя получаемой переменной.

filter

Идентификатор (ID) применяемого фильтра. На странице Типы фильтров приведён список доступных фильтров.

Если не указан, то используется FILTER_DEFAULT, который равнозначен FILTER_UNSAFE_RAW. Это значит, что по умолчанию не применяется никакого фильтра.

options

Ассоциативный массив параметров или логическое ИЛИ флагов. Если фильтр принимает параметры, флаги могут быть указаны в элементе массива "flags".

Возвращаемые значения

Значение запрашиваемой переменной в случае успешного выполнения, false, если фильтрация завершилась неудачей, или null, если переменная var_name не определена. Если установлен флаг FILTER_NULL_ON_FAILURE, функция возвращает false, если переменная не определена и null, если фильтрация завершилась неудачей.

Примеры

Пример #1 Пример использования 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 "Вы искали $search_html.\n";
echo "<a href='?search=$search_url'>Искать снова.</a>";
?>

Результатом выполнения данного примера будет что-то подобное:

Вы искали Me &#38; son.
<a href='?search=Me%20%26%20son'>Искать снова.</a>

Смотрите также

filter_var() - Фильтрует переменную с помощью определённого фильтра
filter_input_array() - Получает несколько переменных извне PHP и, при необходимости, фильтрует их
filter_var_array() - Принимает несколько переменных и, при необходимости, фильтрует их
Типы фильтров