filter_input

(PHP 5 >= 5.2.0)

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

Описание

mixed filter_input ( int $type , string $variable_name [, int $filter = FILTER_DEFAULT [, mixed $options ]] )

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

type -

Один из INPUT_GET, INPUT_POST, INPUT_COOKIE, INPUT_SERVER или INPUT_ENV.

variable_name -

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

filter -

Идентификатор применяемого фильтра. См.список допустимых значений в Константы filters

options -

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

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

Значение запрашиваемой переменной в случае успеха, FALSE, если фильтрация завершилась неудачей, или NULL, если переменная variable_name не определена. Если установлен флаг FILTER_NULL_ON_FAILURE, функция возвращает FALSE, если переменная не определена и NULL, если фильтрация завершилась неудачей.

Примеры

Пример #1 Пример использования filter_input()

$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() - Принимает несколько переменных и, при необходимости, фильтрует их
• Константы filters

Описание на ru2.php.net
Описание на php.ru