Обзор стандартных валидаторов

9.2. Обзор стандартных валидаторов

Стандартные валидаторы ZF3 предоставлены компонентом Zend\Validator ²⁹. Диаграмма наследования классов стандартных валидаторов показана на рисунке 9.1. Как видите из рисунка, большинство из них наследуется от базового класса AbstractValidator.

²⁹⁾ В этом разделе мы считаем стандартными только те валидаторы, которые принадлежат пространству имен Zend\Validator. Однако существуют и другие валидаторы, которые можно считать стандартными. Мы рассмотрим их в следующих главах.

Рисунок 9.1. Наследование классов валидаторов

Стандартные валидаторы вместе с их кратким описанием перечислены в таблице 9.1. Как видите из этой таблицы, стандартные валидаторы можно приблизительно разделить на следующие группы:

валидаторы для проверки соответствия значения определенному формату (IP-адрес, имя хоста, адрес эл. почты, номер кредитной карты и т.д.);
валидаторы для проверки того, что числовое значение лежит в заданном диапазоне (меньше чем, больше чем, между и т.д.);
валидаторы, выступающие "заместителями" (proxies) для других валидаторов (ValidatorChain, StaticValidator и Callback).

Таблица 9.1. Стандартные валидаторы

Имя класса	Описание
`EmailAddress`	Возвращает булевое `true`, если значение - действительный адрес эл. почты; иначе возвращает `false`.
`Hostname`	Проверяет, является ли значение действительным именем хоста.
`Barcode`	Возвращает булевое `true` тогда и только тогда, когда значние содержит действительый штрих-код.
`CreditCard`	Возвращает `true` тогда и только тогда, когда значение соответствует общему формату номера кредитной карты (Алгоритм Луна, контрольная сумма кратна 10).
`Iban`	Возвращает `true`, если значение - действительный международный номер банковского счёта (International Bank Account Number - IBAN); иначе возвращает `false`.
`Isbn`	Возвращает булевое `true` тогда и только тогда, когда значение - действительный международный стандартный книжный номер (International Standard Book Number - ISBN).
`Ip`	Возвращает `true`, если значение - действительный IP-адрес; иначе возвращает `false`.
`Uri`	Возвращает `true` тогда и только тогда, когда значение - единообразный идентификатор ресурса (Uniform Resource Identifier - URI).
`Between`	Возвращает `true`, если значение находится в определенном диапазоне; иначе возвращает `false`.
`LessThan`	Возвращает булевое `true`, если значение меньше определенного числа; иначе возвращает `false`.
`GreaterThan`	Возвращает `true` тогда и только тогда, когда значение больше определенного числа.
`Identical`	Возвращает булевое `true`, если значение совпадает с заданным токеном.
`Step`	Проверяет, является ли значение скалярным и действительной величиной шага.
`Csrf`	Этот валидатор проверяет, совпадает ли заданный токен с сгенерированным ранее и хранящимся в PHP-сессии.
`Date`	Возвращает `true`, если значение - действительная дата определенного формата.
`DateStep`	Возвращает булевое `true`, если дата находится внутри действительного шага.
`InArray`	Возвращает `true`, если значение содержится в заданном массиве; иначе возвращает false.
`Digits`	Возвращает булевое `true` тогда и только тогда, когда $value содержит только цифровые символы.
`Hex`	Возвращает `true` тогда и только тогда, когда значение содержит только шестнадцатеричные символы.
`IsInstanceOf`	Возвращает `true`, если значение является экземпляром определенного класса; иначе возвращает `false`.
`NotEmpty`	Возвращает `true`, если значение не является пустым массивом.
`Regex`	Возвращает `true`, если значение соответствует заданному шаблону; иначе возвращает `false`.
`StringLength`	Возвращает `true`, если длина строки лежит в заданном диапазоне.
`Explode`	Разделяет принимаемое значение на части и возвращает `true`, если все части проходят заданную проверку.
`StaticValidator`	Этот валидатор позволяет выполнить другой валидатор без явного инстанцирования второго.
`Callback`	Этот валидатор позволяет выполнить пользовательский алгоритм валидации, используя предоставляемую пользователем функцию обратного вызова.
`ValidatorChain`	Валидатор-обертка, позволяющий организовать несколько валидаторов в цепь. Присоединенные валидаторы запускаются в том же порядке, в котором они были добавлены в цепочку (FIFO - «первым пришёл — первым ушёл»).