_check()source protected static

_check( string $check , string $regex )

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

Параметры

string $check

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

string $regex

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

Возвращает

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

_getDateString()source protected static

_getDateString( array $value )

Преобразует массив, представляющий дату или время, в строку в формате ISO. Массивы обычно передаются для проверки из формы, сгенерированной с помощью CakePHP FormHelper.

Параметры

array $value

Массив, представляющий дату или время.

Возвращает

string

_populateIp()source protected static

_populateIp( )

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

_reset()source protected static

_reset( )

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

alphaNumeric()source public static

alphaNumeric( string $check )

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

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

Параметры

string $check

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

Возвращает

boolean
Результат

ascii()source public static

ascii( string $value )

Проверяет, что входное значение находится в диапазоне ASCII-байтов.

Этот метод отклонит все значения, не являющиеся строками.

Параметры

string $value

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

Возвращает

boolean

blank()source public static deprecated

blank( string $check )

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

Устаревшее

3.0.2 Validation::blank() устарел.

Параметры

string $check

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

Возвращает

boolean
Результат

boolean()source public static

boolean( boolean|integer|string $check , array $booleanValues = [] )

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

Список значений, считающихся булевыми, может быть задан через $booleanValues.

Параметры

boolean|integer|string $check

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

array $booleanValues optional []

Список допустимых булевых значений, по умолчанию [true, false, 0, 1, '0', '1'].

Возвращает

boolean
Результат.

cc()source public static

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

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

Параметры

string $check

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

string|array $type optional 'fast'

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

boolean $deep optional false

Установив в значение true, будет проверено соответствие алгоритму Луна для кредитной карты.

string|null $regex optional null

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

Возвращает

boolean
Результат

См. также

\Cake\Validation\Validation::luhn()

compareFields()source public static

compareFields( mixed $check , string $field , string $operator , array $context )

Сравнение одного поля с другим.

Возвращает true, если сравнение соответствует ожидаемому результату.

Параметры

mixed $check

Значение для поиска в $field.

string $field

Поле для проверки $check. Это поле должно присутствовать в $context.

string $operator

Оператор сравнения.

array $context

Контекст проверки.

Возвращает

boolean

С версии

3.6.0

compareWith()source public static

compareWith( mixed $check , string $field , array $context )

Сравнение одного поля с другим.

Если оба поля имеют точно одинаковое значение, этот метод вернёт true.

Параметры

mixed $check

Значение для поиска в $field.

string $field

Поле для проверки $check. Это поле должно присутствовать в $context.

array $context

Контекст проверки.

Возвращает

boolean

comparison()source public static

comparison( string $check1 , string $operator , integer $check2 )

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

Параметры

string $check1

Левое значение для сравнения.

string $operator

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

integer $check2

Правое значение для сравнения.

Возвращает

boolean
Результат

containsNonAlphaNumeric()source public static

containsNonAlphaNumeric( string $check , integer $count = 1 )

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

Возвращает true, если строка содержит не менее указанного количества небуквенно-цифровых символов.

Параметры

string $check

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

integer $count необязательно 1

Количество небуквенно-цифровых символов для проверки

Возвращает

boolean
Успех

custom()source public static

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

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

Параметры

string $check

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

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

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

Возвращает

boolean
Успех

date()source public static

date( string|DateTimeInterface $check , string|array $format = 'ymd' , string|null $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 только год без разделителей

Параметры

string|DateTimeInterface $check

корректная строка/объект даты

string|array $format необязательно 'ymd'

Используйте строку или массив вышеперечисленных ключей. Массивы должны передаваться как ['dmy', 'mdy', и т.д.]

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

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

Возвращает

boolean
Успех

datetime()source public static

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

Валидирует значение datetime

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

Параметры

string|DateTimeInterface $check

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

string|array $dateFormat необязательно 'ymd'

Формат части даты. См. Validation::date() для получения дополнительной информации.

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

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

Возвращает

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

См.

\Cake\Validation\Validation::date()
\Cake\Validation\Validation::time()

decimal()source public static

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

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

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

• null => Любое количество десятичных знаков, включая ноль. Точка не требуется.
• true => Любое количество десятичных знаков больше 0 или float/double. Точка обязательна.
• 1..N => Точно заданное количество десятичных знаков. Точка обязательна.

Параметры

float $check

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

integer|boolean|null $places необязательно null

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

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

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

Возвращает

boolean
Успех

email()source public static

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

Валидирует адрес электронной почты.

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

Параметры

string $check

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

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

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

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

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

Возвращает

boolean
Успех

equalTo()source public static

equalTo( mixed $check , mixed $comparedTo )

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

Параметры

mixed $check

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

mixed $comparedTo

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

Возвращает

boolean
Успех

extension()source public static

extension( string|array|Psr\Http\Message\UploadedFileInterface $check , array $extensions = ['gif', 'jpeg', 'png', 'jpg'] )

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

Параметры

string|array|Psr\Http\Message\UploadedFileInterface $check

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

array $extensions необязательно ['gif', 'jpeg', 'png', 'jpg']

допустимые расширения файлов. По умолчанию расширения - 'gif', 'jpeg', 'png', 'jpg'

Возвращает

boolean
Успех

falsey()source public static

falsey( boolean|integer|string $check , array $falseyValues = [] )

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

Список значений, считающихся ложными, может быть задан через $falseyValues.

Параметры

boolean|integer|string $check

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

array $falseyValues необязательно []

Список допустимых ложных значений, по умолчанию [false, 0, '0'].

Возвращает

boolean
Успех.

fileSize()source public static

fileSize( string|array|Psr\Http\Message\UploadedFileInterface $check , string|null $operator = null , integer|string|null $size = null )

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

Будет проверять размер файлов/объектов UploadedFileInterface, проверяя размер файла на диске, а не полагаясь на длину, указанную клиентом.

Параметры

string|array|Psr\Http\Message\UploadedFileInterface $check

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

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

См. Validation::comparison().

integer|string|null $size необязательно null

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

Возвращает

boolean
Успех

geoCoordinate()source public static

geoCoordinate( string $value , array $options = [] )

Валидирует географическую координату.

Поддерживаемые форматы:

• <latitude>, <longitude> Пример: -25.274398, 133.775136

Параметры

• type - Формат координат, в данный момент только latLong.
• format - По умолчанию both, может быть long и lat для валидации только части координаты.

Параметры

string $value

Географическое местоположение в виде строки

array $options необязательно []

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

Возвращает

boolean

getFilename()source protected static

getFilename( string|array|Psr\Http\Message\UploadedFileInterface $check )

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

Параметры

string|array|Psr\Http\Message\UploadedFileInterface $check

Данные для чтения имени файла.

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

string|boolean
Имя файла или false при ошибке.

hexColor()source public static

hexColor( string|array $check )

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

Параметры

string|array $check

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

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

boolean
Успех

imageHeight()source public static

imageHeight( array $file , string $operator , integer $height )

Проверка ширины изображения.

Параметры

array $file

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

string $operator

Оператор сравнения.

integer $height

Минимальная или максимальная ширина.

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

boolean

imageSize()source public static

imageSize( array|Psr\Http\Message\UploadedFileInterface $file , array $options )

Проверка размера загруженного изображения.

Параметры

array|Psr\Http\Message\UploadedFileInterface $file

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

array $options

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

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

boolean

imageWidth()source public static

imageWidth( array $file , string $operator , integer $width )

Проверка ширины изображения.

Параметры

array $file

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

string $operator

Оператор сравнения.

integer $width

Минимальная или максимальная ширина.

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

boolean

inList()source public static

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

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

Параметры

string $check

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

array $list

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

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

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

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

boolean
Успешно.

ip()source public static

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

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

Параметры

string $check

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

string $type необязательно 'both'

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

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

boolean
Успех

isArray()source public static

isArray( array $value )

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

Параметры

array $value

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

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

boolean

isInteger()source public static

isInteger( string $value )

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

Этот метод также принимает строки, содержащие только данные целого типа.

Параметры

string $value

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

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

boolean

isScalar()source public static

isScalar( mixed $value )

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

Этот метод принимает целые числа, числа с плавающей запятой, строки и булевы значения, но не принимает массивы, объекты, ресурсы и null.

Параметры

mixed $value

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

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

boolean

latitude()source public static

latitude( string $value , array $options = [] )

Удобный метод для проверки широты.

Параметры

string $value

Широта как строка

array $options необязательно []

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

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

boolean

Ссылка

https://ru.wikipedia.org/wiki/Широта

См. также

\Cake\Validation\Validation::geoCoordinate()

lengthBetween()source public static

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

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

Параметры

string $check

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

integer $min

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

integer $max

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

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

boolean
Успех

localizedTime()source public static

localizedTime( string|DateTime $check , string $type = 'datetime' , string|integer|null $format = null )

Проверка строк даты и/или времени. Использует I18n::Time для разбора даты. Это означает, что разбор зависит от локали.

Параметры

string|DateTime $check

строка даты или объект (всегда пройдет)

string $type необязательно 'datetime'

Тип парсера, один из 'date', 'time' и 'datetime'

string|integer|null $format необязательно null

любой формат, принятый IntlDateFormatter

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

boolean
Успех

Исключения

InvalidArgumentException
при передаче неподдерживаемого $type

См. также

\Cake\I18n\Time::parseDate(), \Cake\I18n\Time::parseTime(), \Cake\I18n\Time::parseDateTime()

longitude()source public static

longitude( string $value , array $options = [] )

Удобный метод для проверки долготы.

Параметры

string $value

Долгота как строка

array $options необязательно []

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

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

boolean

Ссылка

https://ru.wikipedia.org/wiki/Долгота

См. также

\Cake\Validation\Validation::geoCoordinate()

luhn()source public static

luhn( string|array $check )

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

Параметры

string|array $check

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

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

boolean
Успех

См. также

https://ru.wikipedia.org/wiki/Алгоритм_Луна

maxLength()source public static

maxLength( string $check , integer $max )

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

Параметры

string $check

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

integer $max

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

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

boolean
Успех

maxLengthBytes()source public static

maxLengthBytes( string $check , integer $max )

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

Параметры

строка $check

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

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

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

Возвращает

boolean
Успех

mimeType()source public static

mimeType( string|array|Psr\Http\Message\UploadedFileInterface $check , array|string $mimeTypes = [] )

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

Проверит тип MIME файлов/экземпляров UploadedFileInterface, используя finfo для файла, а не полагаясь на тип контента, отправленный клиентом.

Параметры

строка|массив|Psr\Http\Message\UploadedFileInterface $check

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

массив|строка $mimeTypes необязательно []

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

Возвращает

boolean
Успех

Выбрасывает

RuntimeException
если тип MIME не может быть определен.
LogicException
если модуль ext/fileinfo отсутствует

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 = [] , boolean $caseInsensitive = false )

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

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

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

Параметры

массив $check

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

массив $options необязательно []

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

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

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

Возвращает

boolean
Успех

naturalNumber()source public static

naturalNumber( string $check , boolean $allowZero = false )

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

Параметры

строка $check

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

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

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

Возвращает

boolean
Успех

См. также

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

notBlank()source public static

notBlank( string $check )

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

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

Параметры

строка $check

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

Возвращает

boolean
Успех

notEmpty()source public static deprecated

notEmpty( string $check )

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

Устарело

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

Параметры

строка $check

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

Возвращает

boolean
Успех.

См. также

\Cake\Validation\Validation::notBlank()

numElements()source public static

numElements( array|Countable $check , string $operator , integer $expectedCount )

Используется для проверки количества заданного значения типа массив или Countable.

Параметры

массив|Countable $check

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

строка $operator

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

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

Ожидаемое значение количества.

Возвращает

boolean
Успех

numeric()source public static

numeric( string $check )

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

Параметры

строка $check

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

Возвращает

boolean
Успех

range()source public static

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

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

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

Параметры

строка $check

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

целое число|вещественное число|null $lower необязательно null

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

целое число|вещественное число|null $upper необязательно null

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

Возвращает

boolean
Успех

time()source public static

time( string|DateTimeInterface $check )

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

Параметры

строка|DateTimeInterface $check

допустимая строка/объект времени

Возвращает

boolean
Успех

truthy()source public static

truthy( boolean|integer|string $check , array $truthyValues = [] )

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

Список значений, считаемых истинными, может быть задан через $truthyValues.

Параметры

булево|целое число|строка $check

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

массив $truthyValues необязательно []

Список допустимых истинных значений, по умолчанию [true, 1, '1'].

Возвращает

boolean
Успех.

uploadError()source public static

uploadError( string|array|Psr\Http\Message\UploadedFileInterface $check , boolean $allowNoFile = false )

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

Параметры

строка|массив|Psr\Http\Message\UploadedFileInterface $check

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

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

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

Возвращает

boolean

См. также

https://secure.php.net/manual/en/features.file-upload.errors.php

uploadedFile()source public static

uploadedFile( array|Psr\Http\Message\UploadedFileInterface $file , array $options = [] )

Проверка загруженного файла.

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

Параметры

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

Параметры

array|Psr\Http\Message\UploadedFileInterface $file

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

array $options optional []

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

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

boolean

url()source public static

url( string $check , boolean $strict = false )

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

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

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

Параметры

string $check

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

boolean $strict optional false

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

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

boolean
Успех

Ссылка

https://tools.ietf.org/html/rfc3986

userDefined()source public static deprecated

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

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

Устарело

3.0.2 Вы можете просто установить вызываемый объект для rule ключа при добавлении валидаторов.

Параметры

string|array $check

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

object $object

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

string $method

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

array|null $args optional null

аргументы, которые нужно отправить в метод

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

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

utf8()source public static

utf8( string $value , array $options = [] )

Проверка, что входное значение является строкой utf8.

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

Параметры

• extended - Запретить байты, расположенные выше базовой многоязычной плоскости. Более старые типы кодирования utf8 MySQL не поддерживают символы, расположенные выше базовой многоязычной плоскости. По умолчанию false.

Параметры

string $value

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

array $options optional []

Массив параметров. См. выше для поддерживаемых параметров.

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

boolean

uuid()source public static

uuid( string $check )

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

Параметры

string $check

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

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

boolean
Успех

[
    '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,})',
    'latitude' => '[-+]?([1-8]?\d(\.\d+)?|90(\.0+)?)',
    'longitude' => '[-+]?(180(\.0+)?|((1[0-7]\d)|([1-9]?\d))(\.\d+)?)',
]

[]