Фильтры валидации данных

Список фильтров валидации данных
ИдентификаторИмяПараметрыФлагиОписание
FILTER_VALIDATE_BOOLEAN, FILTER_VALIDATE_BOOL"boolean"defaultFILTER_NULL_ON_FAILURE

Возвращает true для значений «1», «true», «on» и «yes». Иначе возвращает false.

Если установлен флаг FILTER_NULL_ON_FAILURE, то false возвращается только для значений «0», «false», «off», «no» и «», а значение null будет возвращёно для нелогических значений.

Перед сравнением строковые значения обрезаются функцией trim().

FILTER_VALIDATE_DOMAIN"validate_domain"defaultFILTER_FLAG_HOSTNAME, FILTER_NULL_ON_FAILURE

Проверяет, допустимы ли длины меток доменного имени.

Проверяет доменные имена на соответствие стандартам RFC 1034, RFC 1035, RFC 952, RFC 1123, RFC 2732, RFC 2181 и RFC 1123. Необязательный флаг FILTER_FLAG_HOSTNAME отдельно проверяет имена хостов (стандарты разрешают именам начинаться с буквенно-цифрового символа и содержать только буквенно-цифровые символы или дефисы).

FILTER_VALIDATE_EMAIL"validate_email"defaultFILTER_FLAG_EMAIL_UNICODE, FILTER_NULL_ON_FAILURE

Проверяет, представляет ли собой значение действительный адрес электронной почты.

В общем, проверяет addr-spec-синтаксис адреса на соответствие стандарту с » RFC 822, за исключением того, что не поддерживаются комментарии, схлопывание пробельных символов и доменные имена без точек.

FILTER_VALIDATE_FLOAT"float"default, decimal, min_range, max_rangeFILTER_FLAG_ALLOW_THOUSAND, FILTER_NULL_ON_FAILURE

Проверяет значение на соответствие корректному числу с плавающей точкой, и, если нужно, входит в определённый диапазон, в случае успешной проверки преобразовывает в число с плавающей точкой.

Перед сравнением строковые значения обрезаются функцией trim().

FILTER_VALIDATE_INT"int"default, min_range, max_rangeFILTER_FLAG_ALLOW_OCTAL, FILTER_FLAG_ALLOW_HEX, FILTER_NULL_ON_FAILURE

Проверяет значение на соответствие корректному целому числу, и, если нужно, входит в определённый диапазон, в случае успешной проверки преобразовывает в целое число.

Перед сравнением строковые значения обрезаются функцией trim().

FILTER_VALIDATE_IP"validate_ip"defaultFILTER_FLAG_IPV4, FILTER_FLAG_IPV6, FILTER_FLAG_NO_PRIV_RANGE, FILTER_FLAG_NO_RES_RANGE, FILTER_FLAG_GLOBAL_RANGE, FILTER_NULL_ON_FAILURE Проверяет значение на соответствие корректному IP-адресу, и, если нужно, то только для протоколов IPv4 или IPv6, а также то, не входит ли адрес в частные или зарезервированные диапазоны.
FILTER_VALIDATE_MAC"validate_mac_address"defaultFILTER_NULL_ON_FAILUREПроверяет значение на соответствие корректному MAC-адресу.
FILTER_VALIDATE_REGEXP"validate_regexp"default, regexpFILTER_NULL_ON_FAILURE Проверяет значение на соответствие регулярному выражению regexp, Perl-совместимому регулярному выражению.
FILTER_VALIDATE_URL"validate_url"defaultFILTER_FLAG_SCHEME_REQUIRED, FILTER_FLAG_HOST_REQUIRED, FILTER_FLAG_PATH_REQUIRED, FILTER_FLAG_QUERY_REQUIRED, FILTER_NULL_ON_FAILUREПроверяет значение на соответствие корректному URL-адресу (по правилам стандарта » http://www.faqs.org/rfcs/rfc2396), если нужно, с необходимыми флагами. Осторожно, URL-адрес без протокола http:// признаётся допустимым, поэтому иногда требуется дополнительная проверка, которая определит, использует ли URL необходимый протокол, например ssh:// или mailto:. Функция признаёт допустимыми URL-адреса, которые состоят только из символов ASCII; интернациональные доменные имена не пройдут проверку.

Замечание:

Вместо значения, которое не прошло проверку, функция подставит значение по умолчанию, если в массиве параметров определена опция default.

Список изменений

ВерсияОписание
8.0.0 Флаги FILTER_FLAG_SCHEME_REQUIRED и FILTER_FLAG_HOST_REQUIRED для фильтра FILTER_VALIDATE_URL были удалены. Флаги scheme и host были и остаются обязательными.
8.0.0 Добавлена константа FILTER_VALIDATE_BOOL как псевдоним FILTER_VALIDATE_BOOLEAN. Лучше предпочесть FILTER_VALIDATE_BOOL.
7.4.0 Добавлены опции min_range и max_range для фильтра FILTER_VALIDATE_FLOAT.
7.0.0 Добавлен флаг FILTER_FLAG_HOSTNAME и фильтр FILTER_VALIDATE_DOMAIN.
To Top