Класс Validation
Класс Validation. Используется для валидации данных модели.
Предлагает различные методы валидации.
Резюме констант
-
stringCOMPARE_EQUAL'==' -
stringCOMPARE_GREATER'>' -
stringCOMPARE_GREATER_OR_EQUAL'>=' -
stringCOMPARE_LESS'<' -
stringCOMPARE_LESS_OR_EQUAL'<=' -
stringCOMPARE_NOT_EQUAL'!=' -
stringCOMPARE_NOT_SAME'!==' -
stringCOMPARE_SAME'===' -
stringDATETIME_ISO8601'iso8601' -
stringDEFAULT_LOCALE'en_US'
Резюме свойств
- Некоторые сложные шаблоны, необходимые в нескольких местах
array -
arrayХранит массив сообщений об ошибках, заданных в этом классе. Эти сообщения используются в отладочных целях
Резюме методов
- Выполняет проверку соответствия регулярному выражению.
-
Преобразует массив, представляющий дату или время, в строку в формате ISO. Массивы обычно отправляются для проверки из формы, сгенерированной с помощью CakePHP FormHelper.
- Лениво заполняет шаблоны адресов IP, используемые для проверок
- Сброс внутренних переменных для следующей проверки.
- Проверяет, что строка содержит только цифры или буквы.
- Проверяет, что входное значение находится в диапазоне байтов ASCII.
-
Возвращает true, если поле пусто -ИЛИ- содержит только символы пробела. Символы пробела включают пробел, табуляцию, возврат каретки, перевод строки.
- Проверяет, является ли переданное значение булевым.
- Обёртка обратной совместимости для Validation::creditCard().
- Сравнивает одно поле с другим.
- Сравнивает одно поле с другим.
- Используется для сравнения двух числовых значений.
- Проверяет, содержит ли строка один или несколько небуквенно-цифровых символов.
-
Проверка номеров кредитных карт. Возвращает true, если $check соответствует правильному формату кредитной карты.
- Используется, когда требуется пользовательское регулярное выражение.
-
Проверка дат, определяет, является ли переданная строка корректной датой. Ключи, ожидающие полного месяца, дня и года, будут проверять високосные годы.
- Проверяет значение даты и времени.
- Проверяет, является ли значение корректной десятичной дробью. Знак и порядок являются необязательными.
- Проверка адреса электронной почты.
- Проверяет, что значение точно равно $comparedTo.
- Проверяет, что значение имеет допустимое расширение файла.
- Проверяет, является ли данное значение ложным.
- Проверяет размер файла.
- Проверка географической координаты.
-
Помощник для чтения файла из различных реализаций файлов, которые мы принимаем.
- Проверка, является ли входное значение 6-значным шестнадцатеричным цветом.
-
Проверка, соответствует ли входное значение формату Международного банковского счёта (IBAN). Требования: заглавные буквы, отсутствие пробелов, максимальная длина 34 символа, код страны и контрольная сумма находятся на правильных позициях, тело соответствует контрольной сумме по алгоритму Mod97-10.
- Проверяет ширину изображения.
- Проверяет размер загруженного изображения.
- Проверяет ширину изображения.
- Проверяет, содержится ли значение в заданном списке. Сравнение по умолчанию регистрозависимое.
- Проверка адреса IP.
- Проверка, является ли входное значение массивом.
- Проверка, является ли входное значение целым числом.
- Проверка, является ли входное значение скаляром.
-
Проверка формата даты и времени в формате ISO8601. ISO8601 распознаёт 2019 как корректную дату. Для проверки целостности даты используйте @see \Cake\Validation\Validation::datetime()
- Удобный метод для проверки широты.
-
Проверяет, что длина строки находится в заданном диапазоне. Пробелы включаются в счёт символов. Возвращает true, если строка соответствует значению min, max или между min и max.
-
Проверка строк даты и/или времени. Использует
I18n::Timeдля разбора даты. Это означает, что разбор зависит от локали. - Удобный метод для проверки долготы.
- Алгоритм Луна.
- Проверяет, что длина строки (в символах) меньше или равна максимальной длине.
- Проверяет, что длина строки (в байтах) меньше или равна максимальной длине.
- Проверяет тип MIME файла.
- Проверяет, что длина строки (в символах) больше или равна минимальной длине.
- Проверяет, что длина строки (в байтах) больше или равна минимальной длине.
- Проверяет, является ли значение денежной суммой.
- Проверяет множественный выбор. Сравнение по умолчанию регистрозависимое.
- Проверяет, является ли значение натуральным числом.
- Проверяет, содержит ли строка что-либо кроме пробелов.
- Обёртка обратной совместимости для Validation::notBlank().
- Используется для проверки количества элементов заданного значения типа массив или Countable.
- Проверяет, является ли значение числовым.
- Проверяет, находится ли число в заданном диапазоне.
-
Проверка времени, определяет, является ли переданная строка допустимым временем. Проверяет время как 24-часовое (ЧЧ:ММ) или AM/PM ([Ч]Ч:ММ[a|p]m). Не разрешает/не проверяет секунды.
- Проверяет, является ли заданное значение истинным.
- Проверка ошибок загрузки.
- Проверка загруженного файла.
- Проверяет, является ли значение корректным URL в соответствии с https://www.w3.org/Addressing/URL/url-spec.txt
- Выполняет пользовательскую проверку.
- Проверка того, что входное значение является строкой UTF-8.
- Проверяет, является ли значение корректным UUID - https://tools.ietf.org/html/rfc4122
Подробное описание методов
_check()source protected static
_check( string $check , string $regex )
Выполняет соответствие регулярному выражению.
Параметры
- строка
$check - Значение для проверки против выражения $regex
- строка
$regex - Регулярное выражение
Возвращаемые значения
booleanУспех соответствия
_getDateString()source protected static
_getDateString( array $value )
Преобразует массив, представляющий дату или datetime, в строку ISO. Массивы обычно отправляются для проверки из формы, сгенерированной с помощью CakePHP FormHelper.
Параметры
- массив
$value - Массив, представляющий дату или datetime.
Возвращаемые значения
строка_populateIp()source protected static
_populateIp( )
Ленивая инициализация шаблонов IP-адресов, используемых для проверок
_reset()source protected static
_reset( )
Сброс внутренних переменных для следующего запуска проверки.
alphaNumeric()source public static
alphaNumeric( string $check )
Проверка, содержит ли строка только целые числа или буквы.
Возвращает true, если строка содержит только целые числа или буквы.
Параметры
- строка
$check - Значение для проверки
Возвращаемые значения
booleanУспех
ascii()source public static
ascii( string $value )
Проверка, что входное значение находится в диапазоне байтов ASCII.
Этот метод отклонит все значения, не являющиеся строками.
Параметры
- строка
$value - Значение для проверки
Возвращаемые значения
booleanblank()source public static deprecated
blank( string $check )
Возвращает true, если поле пустое -ИЛИ- содержит только пробелы. Пробелы включают пробел, табуляцию, возврат каретки, новую строку.
Устарело
3.0.2 Validation::blank() устарело.Параметры
- строка
$check - Значение для проверки
Возвращаемые значения
booleanУспех
boolean()source public static
boolean( boolean|integer|string $check , array $booleanValues = [] )
Проверяет, является ли переданное значение булевым.
Список того, что считается булевыми значениями, может быть задан через $booleanValues.
Параметры
- boolean|integer|string
$check - Значение для проверки.
- массив
$booleanValuesопционально [] - Список допустимых булевых значений, по умолчанию
[true, false, 0, 1, '0', '1'].
Возвращаемые значения
booleanУспех.
cc()source public static deprecated
cc( string $check , string|array $type = 'fast' , boolean $deep = false , string|null $regex = null )
Обёртка обратной совместимости для Validation::creditCard().
Устарело
3.7.0 Используйте Validation::creditCard() вместо этого.Параметры
- строка
$check - номер кредитной карты для проверки
- строка|массив
$typeопционально 'fast' 'all' может быть передан как строка, по умолчанию fast, который проверяет формат большинства основных кредитных карт. Если используется массив, проверяются только значения массива. Пример: ['amex', 'bankcard', 'maestro']
- boolean
$deepопционально false - Установив в true, будет проверено соответствие алгоритма Луна кредитной карте.
- строка|null
$regexопционально null - Также может быть передан пользовательский regex, который будет использован вместо определенных значений regex
Возвращаемые значения
booleanУспех
См. также
\Cake\Validation\Validation::creditCard()compareFields()source public static
compareFields( mixed $check , string $field , string $operator , array $context )
Сравнение одного поля с другим.
Возвращает true, если сравнение соответствует ожидаемому результату.
Параметры
- смешанное
$check - Значение для поиска в $field.
- строка
$field - Поле для проверки $check. Это поле должно быть присутствовать в $context.
- строка
$operator - Оператор сравнения.
- массив
$context - Контекст проверки.
Возвращаемые значения
booleanС версии
3.6.0compareWith()source public static
compareWith( mixed $check , string $field , array $context )
Сравнение одного поля с другим.
Если оба поля имеют точно одинаковое значение, этот метод вернет true.
Параметры
- смешанное
$check - Значение для поиска в $field.
- строка
$field - Поле для проверки $check. Это поле должно быть присутствовать в $context.
- массив
$context - Контекст проверки.
Возвращаемые значения
booleancomparison()source public static
comparison( string $check1 , string $operator , integer $check2 )
Используется для сравнения двух числовых значений.
Параметры
- строка
$check1 - Левое значение для сравнения.
- строка
$operator Может быть словом или оператором больше >, меньше <, больше или равно >=, меньше или равно <=, меньше <, равно ==, не равно !=
- целое число
$check2 - Правое значение для сравнения.
Возвращаемое значение
booleanУспех
containsNonAlphaNumeric()source public static
containsNonAlphaNumeric( string $check , integer $count = 1 )
Проверяет, содержит ли строка один или несколько не буквенно-цифровых символов.
Возвращает true, если строка содержит не менее указанного количества не буквенно-цифровых символов.
Параметры
- строка
$check - Значение для проверки
- целое число
$countопционально 1 - Количество не буквенно-цифровых символов, которые нужно проверить
Возвращаемое значение
booleanУспех
creditCard()source public static
creditCard( string $check , string|array $type = 'fast' , boolean $deep = false , string|null $regex = null )
Проверка номеров кредитных карт. Возвращает true, если $check соответствует формату кредитной карты.
Параметры
- строка
$check - Номер кредитной карты для проверки
- строка|массив
$typeопционально 'fast' 'all' может быть передан как строка, по умолчанию используется fast, который проверяет формат большинства основных кредитных карт. Если используется массив, проверяются только значения массива. Пример: ['amex', 'bankcard', 'maestro']
- булево
$deepопционально false - Установив в значение true, будет проверена алгоритм Луна для кредитной карты.
- строка|null
$regexопционально null - Можно также передать пользовательское регулярное выражение, которое будет использоваться вместо определенных регулярных выражений.
Возвращаемое значение
booleanУспех
См. также
\Cake\Validation\Validation::luhn()custom()source public static
custom( string $check , string|null $regex = null )
Используется, когда необходимо пользовательское регулярное выражение.
Параметры
- строка
$check - Значение для проверки.
- строка|null
$regexопционально null - Если $check передан как строка, $regex также должен быть установлено на корректное регулярное выражение.
Возвращаемое значение
booleanУспех
date()source public static
date( string|DateTimeInterface $check , string|array $format = 'ymd' , string|null $regex = null )
Проверка даты, определяет, является ли переданная строка корректной датой. Ключи, ожидающие полный месяц, день и год, будут проверять високосные годы.
Годы допустимы от 1800 до 2999.
Форматы:
-
dmy27-12-2006 или 27-12-06 разделители могут быть пробелом, точкой, тире, слешем -
mdy12-27-2006 или 12-27-06 разделители могут быть пробелом, точкой, тире, слешем -
ymd2006-12-27 или 06-12-27 разделители могут быть пробелом, точкой, тире, слешем -
dMy27 декабря 2006 или 27 дек 2006 -
MdyДекабря 27, 2006 или Дек 27, 2006 запятая необязательна -
MyДекабрь 2006 или Дек 2006 -
my12/2006 или 12/06 разделители могут быть пробелом, точкой, тире, слешем -
ym2006/12 или 06/12 разделители могут быть пробелом, точкой, тире, слешем -
y2006 только год без разделителей
Параметры
- строка|DateTimeInterface
$check - корректная строка/объект даты
- строка|массив
$formatопционально 'ymd' Используйте строку или массив вышеперечисленных ключей. Массивы должны передаваться как ['dmy', 'mdy', и т.д]
- строка|null
$regexопционально null - Если используется пользовательское регулярное выражение, это единственная проверка, которая будет выполнена.
Возвращаемое значение
booleanУспех
datetime()source public static
datetime( string|DateTimeInterface $check , string|array $dateFormat = 'ymd' , string|null $regex = null )
Проверяет значение datetime
Все значения, соответствующие правилу проверки "date", и "time", будут действительны
Параметры
- строка|DateTimeInterface
$check - Значение для проверки
- строка|массив
$dateFormatопционально 'ymd' Формат части даты. См. Validation::date() для получения дополнительной информации. Или
Validation::DATETIME_ISO8601для проверки значения datetime ISO8601.- строка|null
$regexопционально null - Регулярное выражение для части даты. Если используется пользовательское регулярное выражение, это единственная проверка, которая будет выполнена.
Возвращаемое значение
booleanTrue, если значение действительное, 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 или число с плавающей точкой. Точка обязательна.
- 1..N => Ровно столько десятичных знаков. Точка обязательна.
Параметры
- число с плавающей точкой
$check - Значение, для которого проверяется десятичная форма.
- целое число|булево|null
$placesопционально null - Десятичные знаки.
- строка|null
$regexопционально null - Если используется пользовательское регулярное выражение, это единственная проверка, которая будет выполнена.
Возвращаемое значение
booleanУспех
email()source public static
email( string $check , boolean $deep = false , string|null $regex = null )
Проверка адреса электронной почты.
Использует только getmxrr() для глубокой проверки или любую версию PHP на не-Windows дистрибутиве.
Параметры
- строка
$check - Значение для проверки
- булево
$deepопционально false - Выполнить более глубокую проверку (если true), также проверив доступность хоста
- строка|null
$regexопционально null - Регулярное выражение для использования (если нет, будет использоваться встроенное регулярное выражение)
Возвращаемое значение
booleanУспех
equalTo()source public static
equalTo( mixed $check , mixed $comparedTo )
Проверяет, что значение точно равно $comparedTo.
Параметры
- смешанный
$check - Значение для проверки
- смешанный
$comparedTo - Значение для сравнения
Возвращаемое значение
booleanУспех
extension()source public static
extension( string|array|Psr\Http\Message\UploadedFileInterface $check , array $extensions = ['gif', 'jpeg', 'png', 'jpg'] )
Проверяет, что у значения есть корректное расширение файла.
Параметры
- строка|массив|Psr\Http\Message\UploadedFileInterface
$check - Значение для проверки
- массив
$extensionsопционально ['gif', 'jpeg', 'png', 'jpg'] - Допустимые расширения файлов. По умолчанию расширения — 'gif', 'jpeg', 'png', 'jpg'
Возвращаемое значение
booleanУспех
falsey()source public static
falsey( boolean|integer|string $check , array $falseyValues = [] )
Проверяет, является ли данное значение ложным.
Список значений, которые считаются ложными, может быть задан через $falseyValues.
Параметры
- булево|целое число|строка
$check - Значение для проверки.
- массив
$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 - Размер в байтах или строка, читаемая человеком, например, '5МБ'.
Возвращаемые значения
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необязательно [] - Параметры для логики проверки.
Возвращаемые значения
booleangetFilename()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Успех
iban()source public static
iban( string $check )
Проверка, что входное значение имеет допустимый синтаксис международного банковского счета IBAN. Требования: заглавные буквы, отсутствие пробелов, максимальная длина 34, код страны и контрольная сумма находятся в правильных местах, тело соответствует контрольной сумме по алгоритму Mod97-10
Параметры
- string
$check - Значение для проверки
Возвращаемые значения
booleanУспех
imageHeight()source public static
imageHeight( array $file , string $operator , integer $height )
Проверка высоты изображения.
Параметры
- array
$file - Данные загруженного файла из PHP.
- string
$operator - Оператор сравнения.
- integer
$height - Минимальная или максимальная ширина.
Возвращаемые значения
booleanimageSize()source public static
imageSize( array|Psr\Http\Message\UploadedFileInterface $file , array $options )
Проверка размера загруженного изображения.
Параметры
- array|Psr\Http\Message\UploadedFileInterface
$file - Данные загруженного файла из PHP.
- array
$options - Параметры для проверки ширины и высоты.
Возвращаемые значения
booleanИсключения
InvalidArgumentExceptionimageWidth()source public static
imageWidth( array $file , string $operator , integer $width )
Проверка ширины изображения.
Параметры
- array
$file - Данные загруженного файла из PHP.
- string
$operator - Оператор сравнения.
- integer
$width - Минимальная или максимальная ширина.
Возвращаемые значения
booleaninList()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 - Значение для проверки
Возвращаемые значения
booleanisInteger()source public static
isInteger( string $value )
Проверка, является ли входное значение целым числом
Этот метод также примет строки, содержащие только целочисленные данные.
Параметры
- string
$value - Значение для проверки
Возвращаемые значения
booleanisScalar()source public static
isScalar( mixed $value )
Проверка, является ли входное значение скалярным.
Этот метод примет целые числа, числа с плавающей запятой, строки и булевы значения, но не примет массивы, объекты, ресурсы и null.
Параметры
- mixed
$value - Значение для проверки
Возвращаемые значения
booleaniso8601()source public static
iso8601( string|DateTimeInterface $check )
Проверка формата даты и времени iso8601. ISO8601 распознает даты и время, такие как 2019, как допустимую дату. Для проверки и проверки целостности даты используйте @see \Cake\Validation\Validation::datetime()
Параметры
- string|DateTimeInterface
$check - Значение для проверки
Возвращаемые значения
booleanTrue, если значение допустимо, иначе false
См.
Кредиты регулярных выражений: https://www.myintervals.com/blog/2009/05/20/iso-8601-date-validation-that-doesnt-suck/latitude()source public static
latitude( string $value , array $options = [] )
Удобный метод для проверки широты.
Параметры
- string
$value - Широта в виде строки
- array
$optionsнеобязательно [] - Параметры для логики проверки.
Возвращаемые значения
booleanСсылка
https://en.wikipedia.org/wiki/LatitudeСм.
\Cake\Validation\Validation::geoCoordinate()lengthBetween()source public static
lengthBetween( string $check , integer $min , integer $max )
Проверяет, что длина строки находится в заданном диапазоне. Пробелы включаются в подсчет символов. Возвращает true, если строка соответствует значению min, max или между min и max.
Параметры
- 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://en.wikipedia.org/wiki/LongitudeСм. также
\Cake\Validation\Validation::geoCoordinate()luhn()source public static
luhn( string|array $check )
Алгоритм Луна
Параметры
- string|array
$check - Значение для проверки.
Возвращает
booleanУспех
См. также
https://en.wikipedia.org/wiki/Luhn_algorithmmaxLength()source public static
maxLength( string $check , integer $max )
Проверяет, меньше ли длина строки (в символах) максимальной длины.
Параметры
- string
$check - Строка для проверки
- integer
$max - Максимальная длина строки
Возвращает
booleanУспех
maxLengthBytes()source public static
maxLengthBytes( string $check , integer $max )
Проверяет, меньше ли длина строки (в байтах) максимальной длины.
Параметры
- string
$check - Строка для проверки
- integer
$max - Максимальная длина строки
Возвращает
booleanУспех
mimeType()source public static
mimeType( string|array|Psr\Http\Message\UploadedFileInterface $check , array|string $mimeTypes = [] )
Проверяет тип MIME файла.
Будет проверять тип MIME файлов/экземпляров UploadedFileInterface, используя finfo для файла, а не полагаясь на тип контента, отправленный клиентом.
Параметры
- string|array|Psr\Http\Message\UploadedFileInterface
$check - Значение для проверки.
- array|string
$mimeTypesнеобязательно [] - Массив типов MIME или регулярное выражение для проверки.
Возвращает
booleanУспех
Выбрасывает
RuntimeExceptionесли тип MIME не может быть определен.
LogicException
если отсутствует расширение ext/fileinfo
minLength()source public static
minLength( string $check , integer $min )
Проверяет, больше ли или равна длина строки (в символах) минимальной длине.
Параметры
- string
$check - Строка для проверки
- integer
$min - Минимальная длина строки
Возвращает
booleanУспех
minLengthBytes()source public static
minLengthBytes( string $check , integer $min )
Проверяет, больше ли или равна длина строки (в байтах) минимальной длине.
Параметры
- string
$check - Строка для проверки
- integer
$min - Минимальная длина строки (в байтах)
Возвращает
booleanУспех
money()source public static
money( string $check , string $symbolPosition = 'left' )
Проверяет, является ли значение денежной суммой.
Параметры
- string
$check - Значение для проверки
- string
$symbolPositionнеобязательно 'left' - Где находится символ (слева/справа)
Возвращает
booleanУспех
multiple()source public static
multiple( array $check , array $options = [] , boolean $caseInsensitive = false )
Проверяет множественный выбор. Сравнение по умолчанию регистрозависимое.
Допустимые опции
- in => предоставляет список вариантов, из которых должны выбираться элементы
- max => максимальное количество ненулевых выборов
- min => минимальное количество ненулевых выборов
Параметры
- array
$check - Значение для проверки
- array
$optionsнеобязательно [] - Опции для проверки.
- boolean
$caseInsensitiveнеобязательно false - Устанавливает значение true для регистронезависимого сравнения.
Возвращает
booleanУспех
naturalNumber()source public static
naturalNumber( string $check , boolean $allowZero = false )
Проверяет, является ли значение натуральным числом.
Параметры
- string
$check - Значение для проверки
- boolean
$allowZeroнеобязательно false - Установить в true, чтобы разрешить ноль, по умолчанию false
Возвращает
booleanУспех
См. также
https://en.wikipedia.org/wiki/Natural_numbernotBlank()source public static
notBlank( string $check )
Проверяет, содержит ли строка что-либо помимо пробелов
Возвращает true, если строка содержит что-либо помимо пробелов
Параметры
- string
$check - Значение для проверки
Возвращает
booleanУспех
notEmpty()source public static deprecated
notEmpty( string $check )
Обертка для обратной совместимости Validation::notBlank().
Устарело
3.0.2 Используйте Validation::notBlank() вместо этого.Параметры
- string
$check - Значение для проверки.
Возвращает
booleanУспех.
См. также
\Cake\Validation\Validation::notBlank()numElements()source public static
numElements( array|Countable $check , string $operator , integer $expectedCount )
Используется для проверки количества заданного значения типа массив или Countable.
Параметры
- array|Countable
$check - Значение, количество которого нужно проверить.
- string
$operator Может быть словом или операндом: больше >, меньше <, больше или равно >=, меньше или равно <=, равно ==, не равно !=
- integer
$expectedCount - Ожидаемое значение количества.
Возвращает
booleanУспех
numeric()source public static
numeric( string $check )
Проверяет, является ли значение числовым.
Параметры
- string
$check - Значение для проверки
Возвращает
booleanУспех
range()source public static
range( string $check , integer|float|null $lower = null , integer|float|null $upper = null )
Проверяет, что число находится в заданном диапазоне.
Если $lower и $upper заданы, диапазон включающий. Если они не заданы, вернёт true, если $check — законное конечное число на этой платформе.
Параметры
- string
$check - Значение для проверки
- integer|float|null
$loweroptional null - Нижняя граница
- integer|float|null
$upperoptional null - Верхняя граница
Возвращает
booleanУспех
time()source public static
time( string|DateTimeInterface $check )
Валидация времени, определяет, является ли переданная строка допустимым временем. Проверяет время как 24-часовое (ЧЧ:ММ) или ам/пм ([Ч]Ч:ММ[a|p]м) Второго не допускает/не проверяет.
Параметры
- string|DateTimeInterface
$check - допустимая строка времени/объект
Возвращает
booleanУспех
truthy()source public static
truthy( boolean|integer|string $check , array $truthyValues = [] )
Проверяет, является ли данное значение истинным.
Список значений, которые считаются истинными, может быть задан через $truthyValues.
Параметры
- boolean|integer|string
$check - Значение для проверки.
- array
$truthyValuesoptional [] - Список допустимых истинных значений, по умолчанию
[true, 1, '1'].
Возвращает
booleanУспех.
uploadError()source public static
uploadError( string|array|Psr\Http\Message\UploadedFileInterface $check , boolean $allowNoFile = false )
Проверка ошибок загрузки
Параметры
- string|array|Psr\Http\Message\UploadedFileInterface
$check - Значение для проверки.
- boolean
$allowNoFileoptional false - Установите в значение true, чтобы разрешить UPLOAD_ERR_NO_FILE как проход.
Возвращает
booleanСм.
https://secure.php.net/manual/en/features.file-upload.errors.phpuploadedFile()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
$optionsoptional [] - Массив параметров для проверки.
Возвращает
booleanurl()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
$strictoptional false - Требуется, чтобы URL был префиксами с допустимой схемой (один из http(s)/ftp(s)/file/news/gopher)
Возвращает
booleanУспех
Ссылка
https://tools.ietf.org/html/rfc3986userDefined()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
$argsoptional null - аргументы, которые нужно отправить методу
Возвращает
mixedвозвращаемое значение метода класса пользователя
utf8()source public static
utf8( string $value , array $options = [] )
Проверка того, что входное значение — строка utf8.
Этот метод отклонит все значения, отличные от строк.
Параметры
-
extended- Запретить байты, расположенные выше в базовой многоязычной плоскости. Более старая кодировка utf8 MySQL не допускает символы выше базовой многоязычной плоскости. По умолчанию false.
Параметры
- string
$value - Значение для проверки
- array
$optionsoptional [] - Массив параметров. См. выше допустимые параметры.
Возвращает
booleanuuid()source public static
uuid( string $check )
Проверка, является ли значение допустимым UUID - https://tools.ietf.org/html/rfc4122
Параметры
- string
$check - Значение для проверки
Возвращает
booleanУспех
Подробное описание свойств
$_patternsource
protected static 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,})',
'latitude' => '[-+]?([1-8]?\d(\.\d+)?|90(\.0+)?)',
'longitude' => '[-+]?(180(\.0+)?|((1[0-7]\d)|([1-9]?\d))(\.\d+)?)',
] $errorssource
public static array
Хранит массив сообщений об ошибках, установленных в этом классе. Используются для отладки
[]
© 2005–present The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/3.8/class-Cake.Validation.Validation.html