filter_input
(PHP 5 >= 5.2.0, PHP 7)
filter_input — Принимает переменную извне PHP и, при необходимости, фильтрует ее
Описание
$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 & son. <a href='?search=Me%20%26%20son'>Искать снова.</a>
Смотрите также
- filter_var() - Фильтрует переменную с помощью определенного фильтра
- filter_input_array() - Получает несколько переменных извне PHP и, при необходимости, фильтрует их
- filter_var_array() - Принимает несколько переменных и, при необходимости, фильтрует их
- Типы фильтров