Глава 33. Zend_Validate

Содержание

33.1. Введение
33.2. Цепочки валидаторов
33.3. Написание валидаторов
33.4. Validating Email Addresses
33.5. Validating Hostnames

33.1. Введение

Компонента Zend_Validate предоставляет набор наиболее часто используемых валидаторов. Он также предоставляет простой механизм формирования цепочки валидаторов, посредством которого которому к одним и тем же данные может быть применено несколько валидаторов в порядке, заданном пользователем.

Что такое валидатор?

Валидатор проверяет входные данные на предмет соответствия некоторым требованиям и возвращает результат булевого типа. Если входные данные не соответствуют требованиям, то валидатор может предоставить информацию о том, какому требованию (требованиям) не соответствуют входные данные.

Например, веб-приложение может требовать, чтобы имя пользователя было длиной от 6 до 12 символов и содержало только алфавитно-цифровые символы. Для того, чтобы проверить, соответствует ли имя пользователя этим требованиям, можно использовать валидатор. Если выбранное имя пользователя не соответствует одному из требований (или обоим требованиям), то будет также полезно знать, каким именно требованиям не соответствует имя пользователя.

Такое определение валидации дает основу для Zend_Validate_Interface, который определяет два метода - isValid() и getMessages(). Метод isValid() выполняет валидацию переданного значения, возвращая true тогда и только тогда, когда значение прошло проверку по критериям валидации. Если isValid() возвращает false, то getMessages() используется для получения массива сообщений, объясняющих, по каким причинам валидация не была пройдена.

[Замечание] Замечание

getMessages() возвращает сообщения ошибок валидации только для последнего вызова isValid(), поскольку isValid() удаляет все сообщения, существующие с предыдущего вызова isValid().

Следующий пример демонстрирует проверку адреса e-mail:

<?php

require_once 'Zend/Validate/EmailAddress.php';
$validator = new Zend_Validate_EmailAddress();
if ($validator->isValid($email)) {
    // email прошел валидацию
} else {
    // email не прошел валидацию; вывод причин этого
    foreach ($validator->getMessages() as $message) {
        echo "$message\n";
    }
}

?>