Встроенные правила валидации

Класс Validation в CakePHP содержит правила проверки данных, которые могут упростить валидацию данных модели. Этот класс содержит множество, часто используемых, приемов проверки данных. Ниже представлен полный перечень всех правил с примерами использования.

alphaNumeric

Данные для поля должны содержать только буквы и цифры.


<?
var $validate = array(
    'login' => array(
        'rule' => 'alphaNumeric',
        'message' => 'Имена пользователей должны содержать только буквы и цифры.'
    )
);
?>

between

Длина данных для поля должна попадать в указанный диапазон. Должны быть определены и минимум и максимум. Используется <=, а не <


<?
var $validate = array(
    'password' => array(
        'rule' => array('between', 5, 15),
        'message' => 'Длина пароля должны быть от 5 до 15 символов.'
    )
);
?>

blank

Это правило используется для того, чтобы убедиться, что поле осталось пустым или присутствуют только пробелы (т.е. пробелы, символы табуляции, возврат каретки и новая строка).


<?
var $validate = array(
    'id' => array(
        'rule' => 'blank',
        'on' => 'create'
    )
);
?>

boolean

Данные для поля должны быть типа boolean. Допустимые значения: true или false, целые 0 или 1, или строковые '0' или '1'.


<?
var $validate = array(
    'myCheckbox' => array(
        'rule' => array('boolean'),
        'message' => 'Некорректные значения для myCheckbox'
    )
);

?>

cc

Правило используется для проверки валидности номера кредитной карты. Оно принимает три параметра: 'type', 'deep' и 'regex'.

Индексу 'type' могут быть присвоены значения 'fast', 'all' или одно из следующих:

amex
bankcard
diners
disc
electron
enroute
jcb
maestro
mc
solo
switch
visa
voyager

Если '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

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 лет.'
    )
);

?>

date

Это правило гарантирует, что дата будет введена в корректных форматах. Единственный параметр (который может быть массивом) может быть передан. Он будет использоваться для проверки формата предлагаемой даты. Значения параметра могут быть следующие:

'dmy' например, 27–12–2006 или 27–12–06 (разделителями могут быть пробел, точка, тире, косая черта /)
'mdy' например, 12–27–2006 или 12–27–06 (разделителями могут быть пробел, точка, тире, косая черта /)
'ymd' например, 2006–12–27 или 06–12–27 (разделителями могут быть пробел, точка, тире, косая черта /)
'dMy' например, 27 December 2006 или 27 Dec 2006
'Mdy' например, December 27, 2006 или Dec 27, 2006 (запятая необязательна)
'My' например, (December 2006 или Dec 2006)
'my' например, 12/2006 или 12/06 (разделителями могут быть пробел, точка, тире, косая черта /)

Если не передан ни один индекс, то по умолчанию будет использоваться 'ymd'.


<?
var $validate = array(
    'born' => array(
        'rule' => 'date',
        'message' => 'Введите дату в формате YY-MM-DD.',
        'allowEmpty' => true
    )
);
?>


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

decimal

Это правило гарантирует, что данные – корректное десятичное число. Может быть передан параметр, для указания требуемого количества знаков после запятой.
Если параметр не передан, то данные не пройдут проверку в случае отсутствия знаков после запятой.


<?
var $validate = array(
    'price' => array(
        'rule' => array('decimal', 2)
    )
);
?>

email

Проверяет являются ли данные корректным email адресом. При передаче true в качестве второго параметра для этого правила будет производиться попытка проверить хост для данного адреса.


<?
var $validate = array('email' => array('rule' => 'email'));
 
var $validate = array(
    'email' => array(
        'rule' => array('email', true),
        'message' => 'Пожалуйста, введите действующий email адрес.'
    )
);
?>

equalTo

Это правило проверяет, чтобы введеное значение было равно значению, определенному в правиле, и было того же типа.


<?
var $validate = array(
    'food' => array(
        'rule' => array('equalTo', 'cake'),  
        'message' => "Значение должно быть строкой 'cake' "
    )
);
?>

extension

Это правило проверяет расширение файла, наподобие .jpg или .png. Разрешает множество расширений при передаче их в виде массива.


<?
var $validate = array(
    'image' => array(
        'rule' => array('extension', array('gif', 'jpeg', 'png', 'jpg')),
        'message' => "Разрешены файлы с расширениями 'gif', 'jpeg', 'png', 'jpg'."
    )
);
?>

ip

Это правило обеспечит проверку валидности введенного IPv4 адреса.


<?
var $validate = array(
    'clientip' => array(
        'rule' => 'ip',
        'message' => 'Пожалуйста, введите корректный IP-адрес.'
    )
);
?>

isUnique

Данные для поля должны быть уникальными, они не могут быть в любой другой записи.


<?
var $validate = array(
    'login' => array(
        'rule' => 'isUnique',
        'message' => 'Пользователь с таким логином уже существует.'
    )
);
?>

minLength

Правило гарантирует, что данные содержат указанный минимум символов.


<?
var $validate = array(
    'login' => array(
        'rule' => array('minLength', '8'),  
        'message' => 'Логин должен быть минимум 8 символов.'
    )
);
?>

maxLength

Правило гарантирует, что данные не превышают указанную длину.


<?
var $validate = array(
    'login' => array(
        'rule' => array('maxLength', '15'),  
        'message' => 'Логин не должен превышать 15 символов.'
    )
);
?>

money

Правило проверяет, что значение является валидной денежной величиной.

Второй параметр определяет расположение символа (слева/справа).


<?
var $validate = array(
    'salary' => array(
        'rule' => array('money', 'left'),
        'message' => 'Пожалуйста, введите денежную величину.'
    )
);
?>

Multiple

Используйте это правило для валидации значений мульти-селекта (multiple select input). Поддерживает параметры “in”, “max” и “min”.


<?
var $validate = array(
    'multiple' => array(
        'rule' => array('multiple', array('in' => array('foo', 'bar'), 'min' => 1, 'max' => 3)),
        'message' => 'Пожалуйста, выберите первый, второй или третий вариант'
    )
);
?>

inList

Это правило проверяет входит ли значение в данное множество. Требует массив значений. Поле валидно, если его значение совпадает с одним из значений данного массива.


<?
    var $validate = array(
      'function' => array(
          'allowedChoice' => array(
              'rule' => array('inList', array('Foo', 'Bar')),
              'message' => 'Введите Foo или Bar.'
          )
      )
    );
?>

numeric

Проверяет являются ли переданные данные чилом.


<?
var $validate = array(
    'cars' => array(
        'rule' => 'numeric',  
        'message' => 'Пожалуйста, введите количество машин.'
    )
);
?>

notEmpty

Основное правило, гарантирующее, что поле не пустое.


<?
var $validate = array(
    'title' => array( 
        'rule' => 'notEmpty',
        'message' => 'Поле не должно быть пустым'
    )
);
?>


Не используйте это правило для multiple select input, так как это вызовет ошибку. 
Используйте вместо этого - "multiple".

phone

Phone проводит проверку телефонных номеров US. Если вы хотите проверить не-US телефонный номер, то вы можете передать вторым параметром регулярное выражение.


<?
var $validate = array(
    'phone' => array(
        'rule' => array('phone', null, 'us')
    )
);
?>

postal

Postal используется для валидации ZIP кодов из США (us), Канады (ca), Великобритании (uk), Италии (it), Германии (de) и Бельгии (be). Для других форматов ZIP кода, вы можете передать регулярное выражение в качестве второго параметра.


<?
var $validate = array(
    'zipcode' => array(
        'rule' => array('postal', null, 'us')
    )
);
?>

range

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


<?
var $validate = array(
    'number' => array(
        'rule' => array('range', 0, 10),
        'message' => 'Пожалуйста введите число между 0 и 10'
    )
);
?>

ssn

Ssn проверяет номер социального страхования из США (us), Дании (dk), и Нидерландов (nl). Для других форматов номера социального страхования, вы можете передать регулярное выражение.


<?
var $validate = array(
    'ssn' => array(
        'rule' => array('ssn', null, 'us')
    )
);
?>

url

Правило проверяет валидность формата 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)
    )
);
?>

<< Множество правил для поля | Пользовательские правила валидации >>

Комментарии

Добавить комментарий: