Класс Validation в CakePHP содержит правила проверки данных, которые могут упростить валидацию данных модели. Этот класс содержит множество, часто используемых, приемов проверки данных. Ниже представлен полный перечень всех правил с примерами использования.
Данные для поля должны содержать только буквы и цифры.
<?
var $validate = array(
'login' => array(
'rule' => 'alphaNumeric',
'message' => 'Имена пользователей должны содержать только буквы и цифры.'
)
);
?>
Длина данных для поля должна попадать в указанный диапазон. Должны быть определены и минимум и максимум. Используется <=, а не <
<?
var $validate = array(
'password' => array(
'rule' => array('between', 5, 15),
'message' => 'Длина пароля должны быть от 5 до 15 символов.'
)
);
?>
Это правило используется для того, чтобы убедиться, что поле осталось пустым или присутствуют только пробелы (т.е. пробелы, символы табуляции, возврат каретки и новая строка).
<?
var $validate = array(
'id' => array(
'rule' => 'blank',
'on' => 'create'
)
);
?>
Данные для поля должны быть типа boolean. Допустимые значения: true или false, целые 0 или 1, или строковые '0' или '1'.
<?
var $validate = array(
'myCheckbox' => array(
'rule' => array('boolean'),
'message' => 'Некорректные значения для myCheckbox'
)
);
?>
Правило используется для проверки валидности номера кредитной карты. Оно принимает три параметра: 'type', 'deep' и 'regex'.
Индексу 'type' могут быть присвоены значения 'fast', 'all' или одно из следующих:
Если 'type' установлен в 'fast', то будет производиться проверка для основных форматов нумерации кредитных карт. Установка 'type' в 'all' будет проверять для всех типов кредитных карт. Вы также можете сопоставить 'type' массив типов, с которыми вы хотите производить сравнение.
Индексу 'deep' должно быть сопоставлено значение типа boolean. Если он установлен в true, валидация будет использовать алгоритм Луна 
http://ru.wikipedia.org/wiki/Алгоритм_Луна. По умолчанию установлен в false.
Индекс 'regex' позволяет вам использовать вам собственное регулярное выражение, которое будет использоваться для проверки номера кредитной карты.
<?
var $validate = array(
'ccnumber' => array(
'rule' => array('cc', array('visa', 'maestro'), false, null),
'message' => 'Неверный номер кредитной карты.'
)
);
?>
Comparison используетс для сравнения числовых значений. Он поддерживает “is greater”, “is less”, “greater or equal”, “less or equal”, “is less”, “equal to”, и “not equal”. Некоторые примеры представлены ниже:
<?
var $validate = array(
'age' => array(
'rule' => array('comparison', '>=', 18),
'message' => 'Должно быть не менее 18 лет.'
)
);
var $validate = array(
'age' => array(
'rule' => array('comparison', 'greater or equal', 18),
'message' => 'Должно быть не менее 18 лет.'
)
);
?>
Это правило гарантирует, что дата будет введена в корректных форматах. Единственный параметр (который может быть массивом) может быть передан. Он будет использоваться для проверки формата предлагаемой даты. Значения параметра могут быть следующие:
Если не передан ни один индекс, то по умолчанию будет использоваться 'ymd'.
<?
var $validate = array(
'born' => array(
'rule' => 'date',
'message' => 'Введите дату в формате YY-MM-DD.',
'allowEmpty' => true
)
);
?>
Многие хранилища данных требуют определенный формат даты. Вместо того, чтобы заставлять
пользователей ввести дату в нужном формате, вы можете принимать широкий массив форматов,
и затем конвертировать их в нужный.
Это правило гарантирует, что данные – корректное десятичное число. Может быть передан параметр, для указания требуемого количества знаков после запятой.
Если параметр не передан, то данные не пройдут проверку в случае отсутствия знаков после запятой.
<?
var $validate = array(
'price' => array(
'rule' => array('decimal', 2)
)
);
?>
Проверяет являются ли данные корректным email адресом. При передаче true в качестве второго параметра для этого правила будет производиться попытка проверить хост для данного адреса.
<?
var $validate = array('email' => array('rule' => 'email'));
var $validate = array(
'email' => array(
'rule' => array('email', true),
'message' => 'Пожалуйста, введите действующий email адрес.'
)
);
?>
Это правило проверяет, чтобы введеное значение было равно значению, определенному в правиле, и было того же типа.
<?
var $validate = array(
'food' => array(
'rule' => array('equalTo', 'cake'),
'message' => "Значение должно быть строкой 'cake' "
)
);
?>
Это правило проверяет расширение файла, наподобие .jpg или .png. Разрешает множество расширений при передаче их в виде массива.
<?
var $validate = array(
'image' => array(
'rule' => array('extension', array('gif', 'jpeg', 'png', 'jpg')),
'message' => "Разрешены файлы с расширениями 'gif', 'jpeg', 'png', 'jpg'."
)
);
?>
Это правило обеспечит проверку валидности введенного IPv4 адреса.
<?
var $validate = array(
'clientip' => array(
'rule' => 'ip',
'message' => 'Пожалуйста, введите корректный IP-адрес.'
)
);
?>
Данные для поля должны быть уникальными, они не могут быть в любой другой записи.
<?
var $validate = array(
'login' => array(
'rule' => 'isUnique',
'message' => 'Пользователь с таким логином уже существует.'
)
);
?>
Правило гарантирует, что данные содержат указанный минимум символов.
<?
var $validate = array(
'login' => array(
'rule' => array('minLength', '8'),
'message' => 'Логин должен быть минимум 8 символов.'
)
);
?>
Правило гарантирует, что данные не превышают указанную длину.
<?
var $validate = array(
'login' => array(
'rule' => array('maxLength', '15'),
'message' => 'Логин не должен превышать 15 символов.'
)
);
?>
Правило проверяет, что значение является валидной денежной величиной.
Второй параметр определяет расположение символа (слева/справа).
<?
var $validate = array(
'salary' => array(
'rule' => array('money', 'left'),
'message' => 'Пожалуйста, введите денежную величину.'
)
);
?>
Используйте это правило для валидации значений мульти-селекта (multiple select input). Поддерживает параметры “in”, “max” и “min”.
<?
var $validate = array(
'multiple' => array(
'rule' => array('multiple', array('in' => array('foo', 'bar'), 'min' => 1, 'max' => 3)),
'message' => 'Пожалуйста, выберите первый, второй или третий вариант'
)
);
?>
Это правило проверяет входит ли значение в данное множество. Требует массив значений. Поле валидно, если его значение совпадает с одним из значений данного массива.
<?
var $validate = array(
'function' => array(
'allowedChoice' => array(
'rule' => array('inList', array('Foo', 'Bar')),
'message' => 'Введите Foo или Bar.'
)
)
);
?>
Проверяет являются ли переданные данные чилом.
<?
var $validate = array(
'cars' => array(
'rule' => 'numeric',
'message' => 'Пожалуйста, введите количество машин.'
)
);
?>
Основное правило, гарантирующее, что поле не пустое.
<?
var $validate = array(
'title' => array(
'rule' => 'notEmpty',
'message' => 'Поле не должно быть пустым'
)
);
?>
Не используйте это правило для multiple select input, так как это вызовет ошибку.
Используйте вместо этого - "multiple".
Phone проводит проверку телефонных номеров US. Если вы хотите проверить не-US телефонный номер, то вы можете передать вторым параметром регулярное выражение.
<?
var $validate = array(
'phone' => array(
'rule' => array('phone', null, 'us')
)
);
?>
Postal используется для валидации ZIP кодов из США (us), Канады (ca), Великобритании (uk), Италии (it), Германии (de) и Бельгии (be). Для других форматов ZIP кода, вы можете передать регулярное выражение в качестве второго параметра.
<?
var $validate = array(
'zipcode' => array(
'rule' => array('postal', null, 'us')
)
);
?>
Правило проверяет, что значение входит в указанный диапазон. Если диапазон не указан, то правило проверит, чтобы значение было допустимой конечной величиной для текущей платформы.
<?
var $validate = array(
'number' => array(
'rule' => array('range', 0, 10),
'message' => 'Пожалуйста введите число между 0 и 10'
)
);
?>
Ssn проверяет номер социального страхования из США (us), Дании (dk), и Нидерландов (nl). Для других форматов номера социального страхования, вы можете передать регулярное выражение.
<?
var $validate = array(
'ssn' => array(
'rule' => array('ssn', null, 'us')
)
);
?>
Правило проверяет валидность формата URL. Поддерживает http(s), ftp(s), file, news, и gopher протоколы.
<?
var $validate = array(
'website' => array(
'rule' => 'url'
)
);
?>
Для проверки того, что протокол есть в url, доступен строгий режим, например:
<?
var $validate = array(
'website' => array(
'rule' => array('url',true)
)
);
?>
<< Множество правил для поля | Пользовательские правила валидации >>