# Модуль фильтрации данных

# Введение

Модуль предоставляет фильтры для проверки или очистки данных. Фильтры полезны, когда источник содержит неизвестные или посторонние данные наподобие данных пользовательского ввода, которые поступили из HTML-формы.

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

Проверка определяет соответствие данных конкретным критериям. Фильтры проверки обозначаются константами `FILTER_VALIDATE_*`. Фильтр `FILTER_VALIDATE_EMAIL`, например, проверяет, соответствует ли входное значение допустимому адресу электронной почты, однако сами данные при этом не изменяются.

Очистка удаляет из данных нежелательные конструкции, поэтому изменяет входные данные: добавляет или удаляет символы. Фильтры очистки обозначаются константами `FILTER_SANITIZE_*`. Константа `FILTER_SANITIZE_EMAIL`, например, удалит недопустимые для адреса эл. почты символы. Обратите внимание, очистка проверяет только символы, но не структуру адреса.

Бо́льшая часть фильтров поддерживают дополнительные флаги, которые изменяют поведение фильтрации. Флаги очистки обозначаются константами `FILTER_FLAG_*`. Передача флага `FILTER_FLAG_PATH_REQUIRED` с фильтром `FILTER_VALIDATE_URL` потребует, чтобы URL-адрес содержал путь: часть `/foo` в адресе `https://example.org/foo`.

- Установка и настройка
  - Установка
  - Настройка во время выполнения
- Предопределённые константы
- Примеры
  - Проверка (валидация)
  - Очистка (нормализация)
- Функции фильтрации данных
  - filter_has_var — Проверяет, содержит ли суперглобальный массив заданного типа переменную с конкретным названием
  - filter_id — Возвращает идентификатор, принадлежащий именованному фильтру
  - filter_input — Получает конкретную внешнюю переменную по имени и, если нужно, фильтрует значение переменной
  - filter_input_array — Получает несколько переменных извне PHP и, при необходимости, фильтрует их
  - filter_list — Возвращает список всех поддерживаемых фильтров
  - filter_var — Фильтрует переменную
  - filter_var_array — Принимает несколько переменных и, при необходимости, фильтрует их
- Filter\FilterException — Исключение Filter\FilterException
- Filter\FilterFailedException — Исключение Filter\FilterFailedException

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open