Функция PHP filter_input()

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

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

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

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

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

Если успешно, возвращается фильтрованные данные, если не удалось, возвращается false, если переменная Если параметры не установлены, возвращается NULL.

Синтаксис

filter_input(тип_ввода, переменная, фильтр, опции)
Параметры Описание
тип_ввода Обязательный. Определяет тип ввода. См.上面的 список возможных типов.
переменная Определяет переменную, которую нужно фильтровать.
фильтр

Опционально. Определяет ID фильтра, который нужно использовать. По умолчанию это FILTER_SANITIZE_STRING.

См. полное руководство по PHP Filter Functions для получения возможных фильтров.

ID фильтра может быть именем ID (например, FILTER_VALIDATE_EMAIL) или ID номером (например, 274).

опции Определяем массив, содержащий знаки и опции. Проверяем каждый фильтр на возможные знаки и опции.

Пример

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

<?php
if (!filter_input(INPUT_POST, 'email', FILTER_VALIDATE_EMAIL))
 {
 echo "E-Mail не валидный";
 }
else
 {
 echo "E-Mail валидный";
 }
?>

Вывод аналогичен:

E-Mail валидный