Модуль предоставляет фильтры, которые можно использовать для проверки или очистки данных. Это особенно полезно, когда источник данных содержит неизвестные (или посторонние) данные, например данные, вводимые пользователем. Например, эти данные могут поступать из HTML-формы.
В основе лежат два типа фильтрации данных: проверка (валидация) и очистка (санация).
Проверка используется для определения соответствия данных определённым критериям.
Фильтры обозначаются константами FILTER_VALIDATE_*
.
Например, применение константы FILTER_VALIDATE_EMAIL
позволяет проверить,
являются ли введённые данные допустимым адресом электронной почты, однако, сами данные при этом
останутся нетронутыми.
Очистка используется для извлечения из данных нежелательных конструкций,
поэтому она может изменять входные данные, добавляя или удаляя символы.
Фильтры обозначаются константами FILTER_SANITIZE_*
.
Например, применение константы FILTER_SANITIZE_EMAIL
удалит все символы, которые
не должен содержать адрес электронной почты. То есть, проверки данных не происходит.
Большинство фильтров поддерживают дополнительные флаги,
которые могут изменять поведение фильтра.
Они обозначаются константами FILTER_FLAG_*
.
Например, передача флага FILTER_FLAG_PATH_REQUIRED
при фильтрации
URL установит необходимым условием наличие пути
в ссылке (например, /foo
в
https://example.org/foo
).