Класс Validation

Класс Validation. Используется для валидации данных модели.

Предлагает различные методы валидации.

Пространство имён: Cake\Validation

Константы

string

COMPARE_EQUAL
```
'=='
```
Оператор сравнения «равно».
string

COMPARE_GREATER
```
'>'
```
Оператор сравнения «больше».
string

COMPARE_GREATER_OR_EQUAL
```
'>='
```
Оператор сравнения «больше или равно».
string

COMPARE_LESS
```
'<'
```
Оператор сравнения «меньше».
string

COMPARE_LESS_OR_EQUAL
```
'<='
```
Оператор сравнения «меньше или равно».
string

COMPARE_NOT_EQUAL
```
'!='
```
Оператор сравнения «не равно».
string

COMPARE_NOT_SAME
```
'!=='
```
Оператор сравнения «не такое же».
string

COMPARE_SAME
```
'==='
```
Оператор сравнения «такое же».

array<string>

COMPARE_STRING

[self::COMPARE_EQUAL, self::COMPARE_NOT_EQUAL, self::COMPARE_SAME, self::COMPARE_NOT_SAME]

string

DATETIME_ISO8601
```
'iso8601'
```
Формат даты и времени ISO8601
string

DEFAULT_LOCALE
```
'en_US'
```
Локаль по умолчанию

Краткое описание свойств

$_pattern protected static

array<string, string>

Некоторые сложные шаблоны, необходимые в нескольких местах
$errors public static

array

Хранит массив сообщений об ошибках, установленных в этом классе. Используются для отладки.

Краткое описание методов

_check() protected static

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

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

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

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

Проверяет, что строка содержит только цифры или буквы.
ascii() public static

Проверяет, что входное значение находится в диапазоне байтов ASCII.
asciiAlphaNumeric() public static

Проверяет, что строка содержит только цифры или буквы ASCII.
boolean() public static

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

Сравнение одного поля с другим.
compareWith() public static

Сравнение одного поля с другим.
comparison() public static

Используется для сравнения двух числовых значений.
containsNonAlphaNumeric() public static deprecated

Проверка наличия одного или нескольких небуквенно-цифровых символов в строке.
creditCard() public static

Проверка номеров кредитных карт. Возвращает true, если $check соответствует правильному формату кредитной карты.
custom() public static

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

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

Проверка значения даты и времени.
decimal() public static

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

Проверка адреса электронной почты.
equalTo() public static

Проверка, что значение точно равно $comparedTo.
extension() public static

Проверка наличия допустимого расширения файла.
falsey() public static

Проверка, является ли заданное значение ложным.
fileSize() public static

Проверка размера файла.
geoCoordinate() public static

Проверка географической координаты.
getFilename() protected static

Вспомогательная функция для чтения файла из различных реализаций файлов, которые мы принимаем.
hexColor() public static

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

Проверка, что входное значение имеет допустимый синтаксис Международного банковского счета (IBAN). Требования: заглавные буквы, отсутствие пробелов, максимальная длина 34, код страны и контрольная сумма находятся в правильных местах, тело соответствует контрольной сумме с помощью алгоритма Mod97-10.
imageHeight() public static

Проверка высоты изображения.
imageSize() public static

Проверка размера загруженного изображения.
imageWidth() public static

Проверка ширины изображения.
inList() public static

Проверка, входит ли значение в заданный список. Сравнение по умолчанию чувствительно к регистру.
ip() public static

Проверка IP-адреса.
isArray() public static

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

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

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

Проверка формата даты и времени iso8601. ISO8601 распознает 2019 как допустимую дату. Для проверки целостности даты используйте @see \Cake\Validation\Validation::datetime()
latitude() public static

Вспомогательный метод для проверки широты.
lengthBetween() public static

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

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

Вспомогательный метод для проверки долготы.
luhn() public static

Алгоритм Луна.
maxLength() public static

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

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

mimeType() public static

Проверяет тип MIME файла.
minLength() public static

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

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

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

Проверяет множественный выбор. Сравнение по умолчанию регистрозависимое.
naturalNumber() public static

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

Проверяет, что строка не содержит буквенно-цифровых символов.
notAsciiAlphaNumeric() public static

Проверяет, что строка не содержит буквенно-цифровых символов ASCII.
notBlank() public static

Проверяет, что строка содержит что-то помимо пробельных символов.
numElements() public static

Используется для проверки количества элементов заданного массива или объекта, реализующего интерфейс Countable.
numeric() public static

Проверяет, является ли значение числовым.
range() public static

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

Проверка времени. Определяет, является ли переданная строка допустимым временем. Проверяет время в формате 24 часов (HH:MM[:SS][.FFFFFF]) или AM/PM ([H]H:MM[a|p]m).
truthy() public static

Проверяет, является ли данное значение истинным.
uploadError() public static

Проверка ошибок загрузки.
uploadedFile() public static

Проверка загруженного файла.
url() public static

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

Проверяет, является ли входное значение строкой UTF-8.
uuid() public static

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

Подробное описание методов

_check() protected static

_check(mixed $check, string $regex): bool

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

Параметры

mixed $check: Значение для проверки по выражению $regex.
string $regex: Регулярное выражение.

Возвращает

bool

_getDateString() protected static

_getDateString(array<string, mixed> $value): string

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

Параметры

array<string, mixed> $value: Массив, представляющий дату или время.

Возвращает

string

_populateIp() protected static

_populateIp(): void

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

Возвращает

void

_reset() protected static

_reset(): void

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

Возвращает

void

alphaNumeric() public static

alphaNumeric(mixed $check): bool

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

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

Параметры

mixed $check: Значение для проверки.

Возвращает

bool

ascii() public static

ascii(mixed $value): bool

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

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

Параметры

mixed $value: Значение для проверки.

Возвращает

bool

asciiAlphaNumeric() public static

asciiAlphaNumeric(mixed $check): bool

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

Параметры

mixed $check: Значение для проверки.

Возвращает

bool

boolean() public static

boolean(string|int|bool $check, array<string|int|bool> $booleanValues = []): bool

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

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

Параметры

string|int|bool $check: Значение для проверки.
array<string|int|bool> $booleanValues необязательно: Список допустимых булевых значений, по умолчанию [true, false, 0, 1, '0', '1'].

Возвращает

bool

compareFields() public static

compareFields(mixed $check, string $field, string $operator, array<string, mixed> $context): bool

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

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

Параметры

mixed $check: Значение, которое нужно найти в $field.
string $field: Поле, с которым нужно сравнить $check. Это поле должно присутствовать в $context.
string $operator: Оператор сравнения. См. Validation::comparison().
array<string, mixed> $context: Контекст валидации.

Возвращает

bool

compareWith() public static

compareWith(mixed $check, string $field, array<string, mixed> $context): bool

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

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

Параметры

mixed $check: Значение, которое нужно найти в $field.
string $field: Поле, с которым нужно сравнить $check. Это поле должно присутствовать в $context.
array<string, mixed> $context: Контекст валидации.

Возвращает

bool

comparison() public static

comparison(string|int $check1, string $operator, string|int $check2): bool

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

Параметры

string|int $check1: Левое значение для сравнения.
string $operator: Может быть одним из следующих операторов: '>', '<', '>=', '<=', '==', '!=', '===' и '!=='. Вы можете использовать один из констант Validation::COMPARE_*.
string|int $check2: Правое значение для сравнения.

Возвращает

bool

containsNonAlphaNumeric() public static

containsNonAlphaNumeric(mixed $check, int $count = 1): bool

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

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

Параметры

mixed $check: Значение для проверки.
int $count необязательно: Количество не буквенно-цифровых символов для проверки.

Возвращает

bool

creditCard() public static

creditCard(mixed $check, array<string>|string $type = 'fast', bool $deep = false, string|null $regex = null): bool

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

Параметры

mixed $check: Номер кредитной карты для проверки.
array<string>|string $type необязательно: 'all' может быть передано как строка, по умолчанию используется "fast", который проверяет формат большинства основных кредитных карт. Если передается массив, проверяются только значения в массиве. Пример: ['amex', 'bankcard', 'maestro']
bool $deep необязательно: Если установлено в true, будет проверена алгоритм Луна для кредитной карты.
string|null $regex необязательно: Пользовательское регулярное выражение, которое будет использоваться вместо определенных значений регулярных выражений.

Возвращает

bool

См. также

\Cake\Validation\Validation::luhn()

custom() public static

custom(mixed $check, string|null $regex = null): bool

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

Параметры

mixed $check: Значение для проверки.
string|null $regex необязательно: Если $check передается как строка, $regex также должен быть установлено в валидное регулярное выражение.

Возвращает

bool

date() public static

date(mixed $check, array<string>|string $format = 'ymd', string|null $regex = null): bool

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

Годы допустимы от 0001 до 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 только год без разделителей

Параметры

mixed $check: корректная строка/объект даты
array<string>|string $format необязательно: Используйте строку или массив вышеуказанных ключей. Массивы должны передаваться как ['dmy', 'mdy', ...]
string|null $regex необязательно: Если используется пользовательское регулярное выражение, это единственная проверка, которая будет выполнена.

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

bool

datetime() public static

datetime(mixed $check, array|string $dateFormat = 'ymd', string|null $regex = null): bool

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

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

Параметры

mixed $check: Значение для проверки
array|string $dateFormat необязательно: Формат части даты. Для получения дополнительной информации см. Validation::date(). Или Validation::DATETIME_ISO8601 для проверки значения datetime в формате ISO8601.
string|null $regex необязательно: Регулярное выражение для части даты. Если используется пользовательское регулярное выражение, это единственная проверка, которая будет выполнена.

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

bool

См. также

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

decimal() public static

decimal(mixed $check, int|true|null $places = null, string|null $regex = null): bool

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

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

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

Параметры

mixed $check: Значение для проверки десятичного формата.
int|true|null $places необязательно: Десятичные знаки.
string|null $regex необязательно: Если используется пользовательское регулярное выражение, это единственная проверка, которая будет выполнена.

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

bool

email() public static

email(mixed $check, bool $deep = false, string|null $regex = null): bool

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

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

Параметры

mixed $check: Значение для проверки
bool $deep необязательно: Выполнить более глубокую проверку (если true), также проверив доступность хоста
string|null $regex необязательно: Регулярное выражение для использования (если нет, оно будет использовать встроенное регулярное выражение)

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

bool

equalTo() public static

equalTo(mixed $check, mixed $comparedTo): bool

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

Параметры

mixed $check: Значение для проверки
mixed $comparedTo: Значение для сравнения

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

bool

extension() public static

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

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

Параметры

Psr\Http\Message\UploadedFileInterface|array|string $check: Значение для проверки
array<string> $extensions необязательно: допустимые расширения файлов. По умолчанию расширения — 'gif', 'jpeg', 'png', 'jpg'

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

bool

falsey() public static

falsey(string|int|bool $check, array<string|int|bool> $falseyValues = []): bool

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

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

Параметры

string|int|bool $check: Значение для проверки.
array<string|int|bool> $falseyValues необязательно: Список допустимых ложных значений, по умолчанию [false, 0, '0'].

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

bool

fileSize() public static

fileSize(Psr\Http\Message\UploadedFileInterface|array|string $check, string $operator, string|int $size): bool

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

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

Параметры

Psr\Http\Message\UploadedFileInterface|array|string $check: Значение для проверки.
string $operator: См. Validation::comparison().
string|int $size: Размер в байтах или удобочитаемая строка, например, '5MB'.

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

bool

geoCoordinate() public static

geoCoordinate(mixed $value, array<string, mixed> $options = []): bool

Проверка географической координаты.

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

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

Параметры

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

Параметры

mixed $value: Географическое положение в виде строки
array<string, mixed> $options необязательно: Параметры для логики проверки.

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

bool

getFilename() protected static

getFilename(mixed $check): string|false

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

Параметры

mixed $check: Данные для чтения имени файла.

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

string|false

hexColor() public static

hexColor(mixed $check): bool

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

Параметры

mixed $check: Значение для проверки

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

bool

iban() public static

iban(mixed $check): bool

Проверяет, что входное значение имеет корректный синтаксис международного банковского счета IBAN. Требования: заглавные буквы, без пробелов, максимальная длина 34, код страны и контрольная сумма находятся на правильных местах, тело соответствует контрольной сумме по алгоритму Mod97-10.

Параметры

mixed $check: Значение для проверки

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

bool

imageHeight() public static

imageHeight(mixed $file, string $operator, int $height): bool

Проверяет высоту изображения.

Параметры

mixed $file: Данные загруженного файла из PHP.
string $operator: Оператор сравнения.
int $height: Минимальная или максимальная высота.

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

bool

imageSize() public static

imageSize(mixed $file, array<string, mixed> $options): bool

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

Параметры

mixed $file: Данные загруленного файла из PHP.
array<string, mixed> $options: Параметры для проверки ширины и высоты.

Возвращает

bool

Выбрасывает

InvalidArgumentException

imageWidth() public static

imageWidth(mixed $file, string $operator, int $width): bool

Проверяет ширину изображения.

Параметры

mixed $file: Данные загруженного файла из PHP.
string $operator: Оператор сравнения.
int $width: Минимальная или максимальная ширина.

Возвращает

bool

inList() public static

inList(mixed $check, array<string> $list, bool $caseInsensitive = false): bool

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

Параметры

mixed $check: Значение для проверки.
array<string> $list: Список для сравнения.
bool $caseInsensitive optional: Установите в значение true для сравнения без учёта регистра.

Возвращает

bool

ip() public static

ip(mixed $check, string $type = 'both'): bool

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

Параметры

mixed $check: Строка для проверки.
string $type optional: Версия протокола IP для проверки.

Возвращает

bool

isArray() public static

isArray(mixed $value): bool

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

Параметры

mixed $value: Значение для проверки.

Возвращает

bool

isInteger() public static

isInteger(mixed $value): bool

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

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

Параметры

mixed $value: Значение для проверки.

Возвращает

bool

isScalar() public static

isScalar(mixed $value): bool

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

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

Параметры

mixed $value: Значение для проверки.

Возвращает

bool

iso8601() public static

iso8601(mixed $check): bool

Проверка формата даты/времени ISO8601. Формат ISO8601 распознаёт 2019 как корректную дату. Для проверки целостности даты используйте @see \Cake\Validation\Validation::datetime()

Параметры

mixed $check: Значение для проверки

Возвращает

bool

См. также

Примечания к регулярному выражению: https://www.myintervals.com/blog/2009/05/20/iso-8601-date-validation-that-doesnt-suck/

latitude() public static

latitude(mixed $value, array<string, mixed> $options = []): bool

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

Параметры

mixed $value: Широта в виде строки
array<string, mixed> $options optional: Параметры для логики проверки.

Возвращает

bool

См. также

\Cake\Validation\Validation::geoCoordinate()

Ссылки

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

lengthBetween() public static

lengthBetween(mixed $check, int $min, int $max): bool

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

Параметры

mixed $check: Значение для проверки длины.
int $min: Минимальное значение в диапазоне (включительно).
int $max: Максимальное значение в диапазоне (включительно).

Возвращает

bool

localizedTime() public static

localizedTime(mixed $check, string $type = 'datetime', string|int|null $format = null): bool

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

Параметры

mixed $check: строка даты или объект (всегда пройдёт)
string $type optional: Тип парсера, один из 'date', 'time' и 'datetime'
string|int|null $format optional: любой формат, принятый IntlDateFormatter

Возвращает

bool

Выбрасывает

InvalidArgumentException
при указании неподдерживаемого $type

См. также

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

longitude() public static

longitude(mixed $value, array<string, mixed> $options = []): bool

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

Параметры

mixed $value: Долгота в виде строки
array<string, mixed> $options optional: Параметры для логики проверки.

Возвращает

bool

См. также

\Cake\Validation\Validation::geoCoordinate()

Ссылки

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

luhn() public static

luhn(mixed $check): bool

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

Параметры

mixed $check: Значение для проверки.

Возвращает

bool

См. также

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

maxLength() public static

maxLength(mixed $check, int $max): bool

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

Параметры

mixed $check: Строка для проверки
int $max: Максимальная длина строки

Возвращает

bool

maxLengthBytes() public static

maxLengthBytes(mixed $check, int $max): bool

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

Параметры

mixed $check: Строка для проверки
int $max: Максимальная длина строки

Возвращает

bool

mimeType() public static

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

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

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

Parameters

Psr\Http\Message\UploadedFileInterface|array|string $check: Значение для проверки.
array|string $mimeTypes optional: Массив типов MIME или шаблон регулярного выражения для проверки.

Returns

bool

Throws

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

minLength() public static

minLength(mixed $check, int $min): bool

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

Parameters

mixed $check: Строка для проверки
int $min: Минимальная длина строки

Returns

bool

minLengthBytes() public static

minLengthBytes(mixed $check, int $min): bool

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

Parameters

mixed $check: Строка для проверки
int $min: Минимальная длина строки (в байтах)

Returns

bool

money() public static

money(mixed $check, string $symbolPosition = 'left'): bool

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

Parameters

mixed $check: Значение для проверки
string $symbolPosition optional: Расположение символа (слева/справа)

Returns

bool

multiple() public static

multiple(mixed $check, array<string, mixed> $options = [], bool $caseInsensitive = false): bool

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

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

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

Parameters

mixed $check: Значение для проверки
array<string, mixed> $options optional: Параметры для проверки.
bool $caseInsensitive optional: Установите true для сравнения без учёта регистра.

Returns

bool

naturalNumber() public static

naturalNumber(mixed $check, bool $allowZero = false): bool

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

Parameters

mixed $check: Значение для проверки
bool $allowZero optional: Установите true, чтобы разрешить ноль, по умолчанию false

Returns

bool

notAlphaNumeric() public static

notAlphaNumeric(mixed $check): bool

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

Определение букв и целых чисел этим методом включает символы Юникода. Используйте notAsciiAlphaNumeric() если вы хотите исключить только символы ASCII.

Parameters

mixed $check: Значение для проверки

Returns

bool

notAsciiAlphaNumeric() public static

notAsciiAlphaNumeric(mixed $check): bool

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

Parameters

mixed $check: Значение для проверки

Returns

bool

notBlank() public static

notBlank(mixed $check): bool

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

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

Parameters

mixed $check: Значение для проверки

Returns

bool

numElements() public static

numElements(mixed $check, string $operator, int $expectedCount): bool

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

Parameters

mixed $check: Значение, для которого необходимо проверить количество.
string $operator: Может быть либо словом, либо операндом: больше >, меньше <, больше или равно >=, меньше или равно <=, меньше <, равно ==, не равно !=
int $expectedCount: Ожидаемое значение количества.

Returns

bool

numeric() public static

numeric(mixed $check): bool

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

Parameters

mixed $check: Значение для проверки

Returns

bool

range() public static

range(mixed $check, float|null $lower = null, float|null $upper = null): bool

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

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

Parameters

mixed $check: Значение для проверки
float|null $lower optional: Нижний предел
float|null $upper optional: Верхний предел

Returns

bool

time() public static

time(mixed $check): bool

Проверка времени, определяет, является ли переданная строка допустимым временем. Проверяет время в 24-часовом формате (HH:MM[:SS][.FFFFFF]) или am/pm ([H]H:MM[a|p]m)

Секунды и дробные секунды (микросекунды) разрешены, но необязательны в 24-часовом формате.

Parameters

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

Returns

bool

truthy() public static

truthy(string|int|bool $check, array<string|int|bool> $truthyValues = []): bool

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

Список того, что считается истинными значениями, может быть установлен через $truthyValues.

Parameters

string|int|bool $check: Значение для проверки.
array<string|int|bool> $truthyValues optional: Список допустимых истинных значений, по умолчанию [true, 1, '1'].

Returns

bool

uploadError() public static

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

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

Parameters

Psr\Http\Message\UploadedFileInterface|array|string $check: Значение для проверки.
bool $allowNoFile optional: Установите true, чтобы разрешить UPLOAD_ERR_NO_FILE как успешное значение.

Returns

bool

uploadedFile() public static

uploadedFile(mixed $file, array<string, mixed> $options = []): bool

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

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

Параметры

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

Параметры

mixed $file: Данные загруженного файла из PHP.
array<string, mixed> $options optional: Массив параметров для валидации.

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

bool

url() public static

url(mixed $check, bool $strict = false): bool

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

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

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

Параметры

mixed $check: Значение для проверки
bool $strict optional: Требуется, чтобы URL был префиксным допустимой схемой (одна из http(s)/ftp(s)/file/news/gopher)

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

bool

Ссылки

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

utf8() public static

utf8(mixed $value, array<string, mixed> $options = []): bool

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

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

Параметры

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

Параметры

mixed $value: Значение для проверки
array<string, mixed> $options optional: Массив параметров. Доступные параметры описаны выше.

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

bool

uuid() public static

uuid(mixed $check): bool

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

Параметры

mixed $check: Значение для проверки

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

bool

Подробное описание свойств

`$_pattern` protected static

Некоторые сложные шаблоны, необходимые в нескольких местах

Тип

array<string, string>

`$errors` 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/4.4/class-Cake.Validation.Validation.html

Класс Validation

Константы

Краткое описание свойств

Краткое описание методов

_check() protected static

_getDateString() protected static

_populateIp() protected static

_reset() protected static

alphaNumeric() public static

ascii() public static

asciiAlphaNumeric() public static

boolean() public static

compareFields() public static

compareWith() public static

comparison() public static

containsNonAlphaNumeric() public static deprecated

creditCard() public static

custom() public static

date() public static

datetime() public static

decimal() public static

email() public static

equalTo() public static

extension() public static

falsey() public static

fileSize() public static

geoCoordinate() public static

getFilename() protected static

hexColor() public static

iban() public static

imageHeight() public static

imageSize() public static

imageWidth() public static

inList() public static

ip() public static

isArray() public static

isInteger() public static

isScalar() public static

iso8601() public static

latitude() public static

lengthBetween() public static

localizedTime() public static

longitude() public static

luhn() public static

maxLength() public static

maxLengthBytes() public static

mimeType() public static

minLength() public static

minLengthBytes() public static

money() public static

multiple() public static

naturalNumber() public static

notAlphaNumeric() public static

notAsciiAlphaNumeric() public static

notBlank() public static

numElements() public static

numeric() public static

range() public static

time() public static

truthy() public static

uploadError() public static

uploadedFile() public static

url() public static

utf8() public static

uuid() public static

Подробное описание методов

_check() protected static

Параметры

Возвращает

_getDateString() protected static

Параметры

Возвращает

_populateIp() protected static

Возвращает

_reset() protected static

Возвращает

alphaNumeric() public static

Параметры

Возвращает

ascii() public static