Класс Validation

_checkисходный код защищённый статический

_check( string $check , string $regex )

Выполняет сопоставление с регулярным выражением.

Параметры

строка $check

Значение для проверки по выражению $regex

строка $regex

Регулярное выражение

Возвращает

boolean
Результат сопоставления

_passисходный код защищённый статический

_pass( string $method , mixed $check , string $classPrefix )

Попытка передать необработанные локали валидации в класс, начинающийся с $classPrefix и заканчивающийся Validation. Например, $classPrefix = 'nl', класс будет NlValidation.

Параметры

строка $method

Метод для вызова в другом классе.

смешанное $check

Значение для проверки или массив параметров для вызываемого метода.

строка $classPrefix

Префикс для класса, выполняющего валидацию.

Возвращает

mixed
Результат вызываемого метода, false при неудаче

_populateIpисходный код защищённый статический

_populateIp( )

Ленивая загрузка шаблонов IP-адресов, используемых для валидации

_resetисходный код защищённый статический

_reset( )

Сброс внутренних переменных для следующей проверки.

alphaNumericисходный код публичный статический

alphaNumeric( string|array $check )

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

Возвращает true, если строка содержит только цифры или буквы.

$check может быть передан как массив: array('check' => 'значениеДляПроверки');

Параметры

строка|массив $check

Значение для проверки

Возвращает

boolean
Результат

betweenисходный код публичный статический

between( string $check , integer $min , integer $max )

Псевдоним для Validator::lengthBetween() для обратной совместимости.

Устарело

Устарело, начиная с версии 2.6. Используйте Validator::lengthBetween() вместо этого.

Параметры

строка $check

Значение для проверки длины

целое число $min

Минимальное значение в диапазоне (включительно)

целое число $max

Максимальное значение в диапазоне (включительно)

Возвращает

boolean
Результат

См. также

Validator::lengthBetween()

blankисходный код публичный статический

blank( string|array $check )

Возвращает true, если поле пусто -ИЛИ- содержит только пробельные символы. Пробельные символы включают пробел, табуляцию, возврат каретки, перенос строки

$check может быть передан как массив: array('check' => 'значениеДляПроверки');

Параметры

строка|массив $check

Значение для проверки

Возвращает

boolean
Результат

booleanисходный код публичный статический

boolean( string $check )

Валидация булевых значений, определяет, является ли переданное значение булевым целым числом или true/false.

Параметры

строка $check

валидное булевое значение

Возвращает

boolean
Результат

ccисходный код публичный статический

cc( string|array $check , string|array $type 'fast' , boolean $deep false , string $regex null )

Валидация номеров кредитных карт. Возвращает true, если $check соответствует формату кредитной карты.

Параметры

строка|массив $check

номер кредитной карты для проверки

строка|массив $type необязательно 'fast'

'all' может быть передано как строка, по умолчанию 'fast', что проверяет формат большинства основных кредитных карт. Если используется массив, проверяются только значения массива. Пример: array('amex', 'bankcard', 'maestro')

булево $deep необязательно false

если установлено в true, проверяется алгоритм Luhn для кредитной карты.

строка $regex необязательно null

также можно передать пользовательское регулярное выражение, оно будет использоваться вместо определённых значений regex

Возвращает

boolean
Результат

См. также

Validation::luhn()

comparisonисходный код публичный статический

comparison( string|array $check1 , string $operator null , integer $check2 null )

Используется для сравнения двух числовых значений.

Параметры

строка|массив $check1

если передана строка, для $check2 также должна быть передана строка. Используя массив, он должен быть передан как array('check1' => значение, 'operator' => 'оператор', 'check2' => значение)

строка $operator необязательно null

Может быть словом или оператором: больше >, меньше <, больше или равно >=, меньше или равно <=, равно ==, не равно !=

целое число $check2 необязательно null

необходимо только если $check1 - строка

Возвращает

boolean
Результат

customисходный код публичный статический

custom( string|array $check , string $regex null )

Используется, когда нужно пользовательское регулярное выражение.

Параметры

строка|массив $check

Если используется как строка, $regex также должно быть допустимым регулярным выражением. Как массив: array('check' => значение, 'regex' => 'валидное регулярное выражение')

строка $regex необязательно null

Если $check передан как строка, $regex также должен быть допустимым регулярным выражением

Возвращает

boolean
Результат

dateисходный код публичный статический

date( string $check , string|array $format 'ymd' , string $regex null )

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

Годы допустимы от 1800 до 2999.

Форматы:

• dmy 27-12-2006 или 27-12-06 разделители могут быть пробелом, точкой, тире, слешем
• mdy 12-27-2006 или 12-27-06 разделители могут быть пробелом, точкой, тире, слешем
• ymd 2006-12-27 или 06-12-27 разделители могут быть пробелом, точкой, тире, слешем
• dMy 27 декабря 2006 или 27 дек 2006
• Mdy 27 декабря 2006 или 27 дек 2006 запятая необязательна
• My Декабрь 2006 или дек 2006
• my 12/2006 или 12/06 разделители могут быть пробелом, точкой, тире, слешем
• ym 2006/12 или 06/12 разделители могут быть пробелом, точкой, тире, слешем
• y 2006 только год без разделителей

Параметры

строка $check

корректная строка даты

строка|массив $format необязательно 'ymd'

Используйте строку или массив с вышеперечисленными ключами. Массивы должны быть переданы как array('dmy', 'mdy', etc)

строка $regex необязательно null

Если используется пользовательское регулярное выражение, это единственная валидация, которая будет выполнена.

Возвращает

boolean
Результат

datetimesource public static

datetime( string $check , string|array $dateFormat 'ymd' , string $regex null )

Проверяет значение datetime

Все значения, соответствующие правилам проверки «дата» и «время», будут считаться допустимыми.

Параметры

строка $check

Значение для проверки

строка|массив $dateFormat необязательно 'ymd'

Формат части даты. Дополнительную информацию см. в Validation::date.

строка $regex необязательно null

Регулярное выражение для части даты. Если используется пользовательское регулярное выражение, это единственная проверка, которая будет выполнена.

Возвращает

boolean
Истина, если значение допустимо, ложь в противном случае

См. также

Validation::date()
Validation::time()

decimalsource public static

decimal( float $check , integer $places null , string $regex null )

Проверяет, является ли значение допустимым десятичным числом. Знак и показатель степени являются необязательными.

Допустимые разряды:

• null => Любое количество десятичных знаков, включая отсутствие.
• true => Любое количество десятичных знаков больше нуля или число с плавающей точкой. Точка обязательна.
• 1..N => Ровно указанное количество десятичных знаков. Точка обязательна.

Параметры

число с плавающей точкой $check

Значение для проверки на десятичное число.

целое число $places необязательно null

Десятичные разряды.

строка $regex необязательно null

Если используется пользовательское регулярное выражение, это единственная проверка, которая будет выполнена.

Возвращает

boolean
Успех

emailsource public static

email( string $check , boolean $deep false , string $regex null )

Проверка адреса электронной почты.

Используется только getmxrr() для глубокой проверки, если используется PHP 5.3.0+ или любая версия PHP на не-Windows дистрибутиве.

Параметры

строка $check

Значение для проверки

логическое $deep необязательно false

Выполнить более глубокую проверку (если true), также проверив доступность хоста

строка $regex необязательно null

Регулярное выражение для использования (если нет, будет использовано встроенное регулярное выражение)

Возвращает

boolean
Успех

equalTosource public static

equalTo( mixed $check , mixed $comparedTo )

Проверка, что значение точно равно $comparedTo.

Параметры

смешанный тип $check

Значение для проверки

смешанный тип $comparedTo

Значение для сравнения

Возвращает

boolean
Успех

extensionsource public static

extension( string|array $check , array $extensions array('gif', 'jpeg', 'png', 'jpg') )

Проверка, что значение имеет допустимое расширение файла.

Параметры

строка|массив $check

Значение для проверки

массив $extensions необязательно array('gif', 'jpeg', 'png', 'jpg')

Разрешенные расширения файлов. По умолчанию расширения — 'gif', 'jpeg', 'png', 'jpg'

Возвращает

boolean
Успех

fileSizesource public static

fileSize( string|array $check , string $operator null , integer|string $size null )

Проверка размера файла

Параметры

строка|массив $check

Значение для проверки.

строка $operator необязательно null

См. Validation::comparison().

целое число|строка $size необязательно null

Размер в байтах или строка в удобочитаемом формате, например, '5MB'.

Возвращает

boolean
Успех

inListsource public static

inList( string $check , array $list , boolean $caseInsensitive false )

Проверяет, находится ли значение в заданном списке. Сравнение по умолчанию чувствительно к регистру.

Параметры

строка $check

Значение для проверки.

массив $list

Список для проверки.

логическое $caseInsensitive необязательно false

Установите в значение true для выполнения нечувствительного к регистру сравнения.

Возвращает

boolean
Успех.

ipsource public static

ip( string $check , string $type 'both' )

Проверка IP-адреса.

Параметры

строка $check

Строка для проверки.

строка $type необязательно 'both'

Версия IP-протокола для проверки

Возвращает

boolean
Успех

lengthBetweensource public static

lengthBetween( string $check , integer $min , integer $max )

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

Параметры

строка $check

Значение для проверки длины

целое число $min

Минимальное значение в диапазоне (включительно)

целое число $max

Максимальное значение в диапазоне (включительно)

Возвращает

boolean
Успех

luhnsource public static

luhn( string|array $check , boolean $deep false )

Алгоритм Луна

Параметры

строка|массив $check

Значение для проверки.

логическое $deep необязательно false

Если true, выполняется глубокая проверка.

Возвращает

boolean
Успех

См. также

http://en.wikipedia.org/wiki/Luhn_algorithm

maxLengthsource public static

maxLength( string $check , integer $max )

Проверяет, меньше ли длина строки или равна максимальной длине.

Параметры

строка $check

Строка для проверки

целое число $max

Максимальная длина строки

Возвращает

boolean
Успех

mimeTypesource public static

mimeType( string|array $check , array|string $mimeTypes array() )

Проверка типа MIME файла.

Параметры

строка|массив $check

Значение для проверки.

массив|строка $mimeTypes необязательно array()

Массив типов MIME или регулярное выражение для проверки.

Возвращает

boolean
Успех

Выбрасывает

CakeException
при невозможности определить тип MIME.

minLengthsource public static

minLength( string $check , integer $min )

Проверяет, больше ли или равна длина строки минимальной длине.

Параметры

строка $check

Строка для проверки

целое число $min

Минимальная длина строки

Возвращает

boolean
Успех

moneysource public static

money( string $check , string $symbolPosition 'left' )

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

Параметры

строка $check

Значение для проверки

строка $symbolPosition необязательно 'left'

Расположение символа (слева/справа)

Возвращает

boolean
Успех

multiplesource public static

multiple( array $check , array $options array() , boolean $caseInsensitive false )

Проверка множественного выбора. Сравнение по умолчанию чувствительно к регистру.

Допустимые параметры

• in => список значений, из которых должны выбираться элементы
• max => максимальное количество выбранных ненулевых значений
• min => минимальное количество выбранных ненулевых значений

Параметры

array $check

Значение для проверки

array $options необязательно array()

Параметры проверки.

boolean $caseInsensitive необязательно false

Установить в значение true для выполнения сравнения без учёта регистра.

Возвращаемое значение

boolean
Успех

naturalNumbersource public static

naturalNumber( string $check , boolean $allowZero false )

Проверка, является ли значение натуральным числом.

Параметры

string $check

Значение для проверки

boolean $allowZero необязательно false

Установить в значение true, чтобы разрешить ноль, по умолчанию false

Возвращаемое значение

boolean
Успех

См. также

http://en.wikipedia.org/wiki/Natural_number

notBlanksource public static

notBlank( string|array $check )

Проверяет, содержит ли строка что-либо помимо пробелов

Возвращает true, если строка содержит что-либо помимо пробелов

$check может быть передан как массив: array('check' => 'valueToCheck');

Параметры

string|array $check

Значение для проверки

Возвращаемое значение

boolean
Успех

notEmptysource public static

notEmpty( string|array $check )

Обёртка обратной совместимости для Validation::notBlank().

Устаревшее

2.7.0 Используйте Validation::notBlank() вместо этого.

Параметры

string|array $check

Значение для проверки.

Возвращаемое значение

boolean
Успех.

См. также

Validation::notBlank()

numericsource public static

numeric( string $check )

Проверяет, является ли значение числовым.

Параметры

string $check

Значение для проверки

Возвращаемое значение

boolean
Успех

phonesource public static

phone( string|array $check , string $regex null , string $country 'all' )

Проверка, является ли значение корректным номером телефона.

Параметры

string|array $check

Значение для проверки (строка или массив)

string $regex необязательно null

Регулярное выражение для использования

string $country необязательно 'all'

Код страны (по умолчанию 'all')

Возвращаемое значение

boolean
Успех

postalsource public static

postal( string|array $check , string $regex null , string $country 'us' )

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

Параметры

string|array $check

Значение для проверки

string $regex необязательно null

Регулярное выражение для использования

string $country необязательно 'us'

Страна для форматирования

Возвращаемое значение

boolean
Успех

rangesource public static

range( string $check , integer|float $lower null , integer|float $upper null )

Проверка, находится ли число в заданном диапазоне. Если $lower и $upper не установлены, возвращает true, если $check является допустимым конечным значением на этой платформе

Параметры

string $check

Значение для проверки

integer|float $lower необязательно null

Нижняя граница

integer|float $upper необязательно null

Верхняя граница

Возвращаемое значение

boolean
Успех

ssnsource public static

ssn( string|array $check , string $regex null , string $country null )

Проверяет, является ли значение корректным номером социального страхования.

Устаревшее

Устарело 2.6. Будет удалено в 3.0.

Параметры

string|array $check

Значение для проверки

string $regex необязательно null

Регулярное выражение для использования

string $country необязательно null

Страна

Возвращаемое значение

boolean
Успех

timesource public static

time( string $check )

Проверка времени, определяет, является ли переданная строка допустимым временем. Проверяет время как 24-часовое (ЧЧ:ММ) или ам/пм ([Ч]Ч:ММ[a|p]м) Не допускает/не проверяет секунды.

Параметры

string $check

корректная строка времени

Возвращаемое значение

boolean
Успех

uploadErrorsource public static

uploadError( string|array $check )

Проверка ошибок загрузки

Параметры

string|array $check

Значение для проверки.

Возвращаемое значение

boolean
bool

См. также

http://www.php.net/manual/en/features.file-upload.errors.php

urlsource public static

url( string $check , boolean $strict false )

Проверяет, является ли значение корректным URL в соответствии с http://www.w3.org/Addressing/URL/url-spec.txt

Регулярное выражение проверяет следующие составные части:

• допустимая, необязательная схема
• допустимый IP-адрес ИЛИ допустимое доменное имя, как определено в разделе 2.3.1 http://www.ietf.org/rfc/rfc1035.txt с необязательным номером порта
• необязательный допустимый путь
• необязательная строка запроса (параметры GET)
• необязательный фрагмент (якорь)

Параметры

string $check

Значение для проверки

boolean $strict необязательно false

Требовать, чтобы URL был префиксным с допустимой схемой (одной из http(s)/ftp(s)/file/news/gopher)

Возвращаемое значение

boolean
Успех

userDefinedsource public static

userDefined( string|array $check , object $object , string $method , array $args null )

Выполняет пользовательскую проверку.

Параметры

string|array $check

значение, которое будет проверено в пользовательских методах.

object $object

класс, содержащий метод проверки

string $method

имя метода класса для выполнения проверки

array $args необязательно null

аргументы для передачи методу

Возвращаемое значение

mixed
возвращаемое значение метода класса пользовательского класса

uuidsource public static

uuid( string $check )

Проверяет, является ли значение корректным UUID - http://tools.ietf.org/html/rfc4122

Параметры

string $check

Значение для проверки

Возвращаемое значение

boolean
Успех

array(
    'hostname' => '(?:[_\p{L}0-9][-_\p{L}0-9]*\.)*(?:[\p{L}0-9][-\p{L}0-9]{0,62})\.(?:(?:[a-z]{2}\.)?[a-z]{2,})'
)

array()