PHP filter_input()Функции

PHP Filter 参考手册Полное справочное руководство по фильтрам PHP

Определение и использование

Функция filter_input() получает входные данные извне скрипта (например, данные формы) и фильтрует их.

Эта функция используется для проверки переменных из небезопасных источников, таких как пользовательский ввод.

Эта функция может получать входные данные из различных источников:

  • INPUT_GET
  • INPUT_POST
  • INPUT_COOKIE
  • INPUT_ENV
  • INPUT_SERVER
  • INPUT_SESSION (еще не реализовано)
  • INPUT_REQUEST (ещё не реализовано)

В случае успеха возвращаются отфильтрованные данные. В случае неудачи возвращается FALSE. Если параметр "variable" не задан, возвращается NULL.

Синтаксис

filter_input(input_type, variable, filter, options)

Параметр Описание
input_type Обязательный. Указывает тип ввода. Возможные типы см. в списке выше.
variable Обязательный. Задает переменную для фильтрации.
filter Необязательный. Указывает ID фильтра для использования. По умолчанию — FILTER_SANITIZE_STRING. См.Полное справочное руководство по фильтрам PHP, чтобы узнать о возможных фильтрах.

ID фильтра может быть именем ID (например, FILTER_VALIDATE_EMAIL) или числовым ID (например, 274).
options Необязательно. Задает ассоциативный массив, содержащий флаги/опции или один флаг/опцию. Проверьте каждый фильтр на возможные флаги и опции.

Примеры

В этом примере мы используем функцию filter_input() для фильтрации переменной POST. Полученная переменная POST является допустимым адресом электронной почты:

<?php
if (!filter_input(INPUT_POST, 'email', FILTER_VALIDATE_EMAIL))
{
echo "E-Mail is not valid";
}
else
{
echo "E-Mail is valid";
}
?>

Вывод кода показан ниже:

Адрес электронной почты действителен

PHP Filter 参考手册Полное справочное руководство по фильтрам PHP Другие расширения