filter_input - Принимает переменную извне PHP и, при необходимости, фильтрует ее
Вернуться к: Фильтрация данных
filter_input
(PHP 5 >= 5.2.0, PHP 7)
filter_input — Принимает переменную извне PHP и, при необходимости, фильтрует ее
Описание
Список параметров
-
type
-
Один из
INPUT_GET
,INPUT_POST
,INPUT_COOKIE
,INPUT_SERVER
илиINPUT_ENV
. -
variable_name
-
Имя получаемой переменной.
-
filter
-
Идентификатор (ID) применяемого фильтра. На странице Types of filters приведен список доступных фильтров.
Если не указан, то используется
FILTER_DEFAULT
, который равнозначенFILTER_UNSAFE_RAW
. Это значит, что по умолчанию не применяется никакого фильтра. -
options
-
Ассоциативный массив параметров либо логическое ИЛИ флагов. Если фильтр принимает параметры, флаги могут быть указаны в элементе массива "flags".
Возвращаемые значения
Значение запрашиваемой переменной в случае успеха, FALSE
, если фильтрация завершилась неудачей,
или NULL
, если переменная variable_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 & son. <a href='?search=Me%20%26%20son'>Искать снова.</a>
Смотрите также
- filter_var() - Фильтрует переменную с помощью определенного фильтра
- filter_input_array() - Принимает несколько переменных извне PHP и, при необходимости, фильтрует их
- filter_var_array() - Принимает несколько переменных и, при необходимости, фильтрует их
- Types of filters
Вернуться к: Фильтрация данных