(PHP 5 >= 5.2.0)
filter_input — Принимает переменную извне PHP и, при необходимости, фильтрует ее
type
Один из INPUT_GET
, INPUT_POST
,
INPUT_COOKIE
, INPUT_SERVER
или
INPUT_ENV
.
variable_name
Имя получаемой переменной.
filter
Идентификатор применяемого фильтра. См.список допустимых значений в Types of filters
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>