Класс Validation

_check()source protected static

_check( string $check , string $regex )

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

Параметры

строка $check

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

строка $regex

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

Возвращает

boolean
Результат проверки

_isUploadedFile()source protected static

_isUploadedFile( string $path )

Вспомогательный метод, который можно подменить при тестировании.

Параметры

строка $path

Путь для проверки.

Возвращает

boolean
Является ли файл загруженным.

_pass()source protected static

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

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

Параметры

строка $method

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

смешанное $check

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

строка $classPrefix

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

Возвращает

смешанное
Результат вызываемого метода, false при ошибке

_populateIp()source protected static

_populateIp( )

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

_reset()source protected static

_reset( )

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

alphaNumeric()source public static

alphaNumeric( string|array $check )

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

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

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

Параметры

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

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

Возвращает

boolean
Результат

between()source public static

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

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

Устаревшее

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

Параметры

строка $check

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

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

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

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

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

Возвращает

boolean
Результат

См. также

Validator::lengthBetween()

blank()source public static

blank( string|array $check )

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

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

Параметры

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

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

Возвращает

boolean
Результат

boolean()source public static

boolean( string $check )

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

Параметры

строка $check

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

Возвращает

boolean
Результат

cc()source public static

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, будет проверена алгоритм Луна для кредитной карты.

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

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

Возвращает

boolean
Результат

См. также

Validation::luhn()

comparison()source public static

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

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

Параметры

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

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

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

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

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

необходимо только если $check1 является строкой

Возвращает

boolean
Результат

custom()source public static

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

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

Параметры

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

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

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

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

Возвращает

boolean
Результат

date()source public static

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
Результат

datetime()source public static

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

Проверяет значение даты и времени

Все значения, соответствующие правилу проверки "date" и правилу "time", будут действительными

Параметры

строка $check

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

строка|массив $dateFormat дополнительный 'ymd'

Формат части даты. Подробнее см. в Validation::date.

строка $regex дополнительный null

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

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

boolean
True, если значение соответствует, false — в противном случае

См. также

Validation::date
Validation::time

decimal()source public static

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

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

Допустимые значения мест:

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

Параметры

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

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

целое число $places дополнительный null

Знаки после запятой.

строка $regex дополнительный null

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

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

boolean
Успех

email()source 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
Успех

equalTo()source public static

equalTo( mixed $check , mixed $comparedTo )

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

Параметры

смешанное $check

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

смешанное $comparedTo

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

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

boolean
Успех

extension()source 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
Успех

fileSize()source public static

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

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

Параметры

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

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

строка $operator дополнительный null

См. Validation::comparison().

целое число|строка $size дополнительный null

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

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

boolean
Успех

inList()source public static

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

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

Параметры

строка $check

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

массив $list

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

булево $caseInsensitive дополнительный false

Установите в значение true для регистронезависимого сравнения.

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

boolean
Успех.

ip()source public static

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

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

Параметры

строка $check

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

строка $type дополнительный 'both'

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

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

boolean
Успех

lengthBetween()source public static

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

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

Параметры

строка $check

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

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

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

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

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

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

boolean
Успех

luhn()source public static

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

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

Параметры

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

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

булево $deep дополнительный false

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

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

boolean
Успех

См. также

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

maxLength()source public static

maxLength( string $check , integer $max )

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

Параметры

строка $check

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

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

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

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

boolean
Успех

maxLengthBytes()source public static

maxLengthBytes( string $check , integer $max )

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

Параметры

строка $check

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

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

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

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

boolean
Успех

mimeType()source public static

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

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

Параметры

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

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

массив|строка $mimeTypes дополнительный array()

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

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

boolean
Успех

Исключения

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

minLength()source public static

minLength( string $check , integer $min )

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

Параметры

строка $check

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

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

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

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

boolean
Успех

minLengthBytes()source public static

minLengthBytes( string $check , integer $min )

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

Параметры

строка $check

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

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

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

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

boolean
Успех

money()source public static

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

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

Параметры

строка $check

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

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

Где находится символ (слева/справа)

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

boolean
Успех

multiple()source public static

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

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

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

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

Параметры

массив $check

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

массив $options необязательно array()

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

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

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

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

boolean
Успех

naturalNumber()source public static

naturalNumber( string $check , boolean $allowZero false )

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

Параметры

строка $check

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

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

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

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

boolean
Успех

См. также

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

notBlank()source public static

notBlank( string $check )

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

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

Параметры

строка $check

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

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

boolean
Успех

notEmpty()source public static

notEmpty( string|array $check )

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

Устарело

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

Параметры

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

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

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

boolean
Успех.

См. также

Validation::notBlank()

numeric()source public static

numeric( string $check )

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

Параметры

строка $check

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

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

boolean
Успех

phone()source public static

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

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

Параметры

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

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

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

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

строка $country необязательно 'all'

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

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

boolean
Успех

postal()source public static

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

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

Параметры

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

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

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

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

строка $country необязательно 'us'

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

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

boolean
Успех

range()source public static

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

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

Параметры

строка $check

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

целое число/число с плавающей точкой $lower необязательно null

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

целое число/число с плавающей точкой $upper необязательно null

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

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

boolean
Успех

ssn()source public static

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

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

Устарело

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

Параметры

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

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

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

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

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

Страна

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

boolean
Успех

time()source public static

time( string $check )

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

Параметры

строка $check

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

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

boolean
Успех

uploadError()source public static

uploadError( string|array $check , boolean $allowNoFile false )

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

Параметры

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

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

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

Установите в значение true, чтобы разрешить UPLOAD_ERR_NO_FILE как корректное значение.

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

boolean

См. также

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

uploadedFile()source public static

uploadedFile( array $file , array $options array() )

Валидация загруженного файла.

Помогает объединить uploadError, fileSize и mimeType в один метод валидации более высокого уровня.

Параметры

• types - Список допустимых типов MIME. Если пусто, все типы будут приняты. type не будет рассматриваться, вместо этого тип файла будет проверяться с помощью ext/finfo.
• minSize - Минимальный размер файла. По умолчанию проверка не выполняется.
• maxSize - Максимальный размер файла. По умолчанию проверка не выполняется.
• optional - Является ли этот файл необязательным. По умолчанию false. Если true, отсутствие файла пройдет валидатор независимо от других ограничений.

Параметры

массив $file

Данные загруженного файла из PHP.

массив $options необязательно array()

Массив параметров для валидации.

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

boolean

url()source 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)
• необязательный фрагмент (якорь ссылки)

Параметры

строка $check

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

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

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

Возвращает

булево
Успех

userDefined()source public static

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

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

Параметры

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

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

объект $object

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

строка $method

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

массив $args необязательно null

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

Возвращает

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

uuid()source public static

uuid( string $check )

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

Параметры

строка $check

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

Возвращает

булево
Успех

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()