Spec-Zone.ru › CakePHP 3.8

Класс Validation

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

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

Пространство имен: Cake\Validation
Расположение: Validation/Validation.php

Резюме констант

  • 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
    '==='
  • string

    DATETIME_ISO8601
    'iso8601'
  • string

    DEFAULT_LOCALE
    'en_US'

Резюме свойств

  • $_pattern protected static
    array
    Некоторые сложные шаблоны, необходимые в нескольких местах
  • $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.
  • blank() public static deprecated

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

  • boolean() public static
    Проверяет, является ли переданное значение булевым.
  • cc() public static deprecated
    Обёртка обратной совместимости для Validation::creditCard().
  • compareFields() public static
    Сравнивает одно поле с другим.
  • compareWith() public static
    Сравнивает одно поле с другим.
  • comparison() public static
    Используется для сравнения двух числовых значений.
  • containsNonAlphaNumeric() public static
    Проверяет, содержит ли строка один или несколько небуквенно-цифровых символов.
  • 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
    Проверяет, является ли значение денежной суммой.
END_OF_DOCUMENT_MARKER
  • multiple() public static
    Проверяет множественный выбор. Сравнение по умолчанию регистрозависимое.
  • naturalNumber() public static
    Проверяет, является ли значение натуральным числом.
  • notBlank() public static
    Проверяет, содержит ли строка что-либо кроме пробелов.
  • notEmpty() public static deprecated
    Обёртка обратной совместимости для Validation::notBlank().
  • numElements() public static
    Используется для проверки количества элементов заданного значения типа массив или Countable.
  • numeric() public static
    Проверяет, является ли значение числовым.
  • range() public static
    Проверяет, находится ли число в заданном диапазоне.
  • time() public static

    Проверка времени, определяет, является ли переданная строка допустимым временем. Проверяет время как 24-часовое (ЧЧ:ММ) или AM/PM ([Ч]Ч:ММ[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
  • userDefined() public static deprecated
    Выполняет пользовательскую проверку.
  • utf8() public static
    Проверка того, что входное значение является строкой UTF-8.
  • uuid() public static
    Проверяет, является ли значение корректным 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
Значение для проверки

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

boolean

blank()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.0

compareWith()source public static

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

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

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

Параметры

смешанное $check
Значение для поиска в $field.
строка $field
Поле для проверки $check. Это поле должно быть присутствовать в $context.
массив $context
Контекст проверки.

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

boolean

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

Форматы:

  • 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 только год без разделителей

Параметры

строка|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
Регулярное выражение для части даты. Если используется пользовательское регулярное выражение, это единственная проверка, которая будет выполнена.

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

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 или число с плавающей точкой. Точка обязательна.
  • 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 необязательно []
Параметры для логики проверки.

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

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
Успех

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
Минимальная или максимальная ширина.

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

boolean

imageSize()source public static

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

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

Параметры

array|Psr\Http\Message\UploadedFileInterface $file
Данные загруженного файла из PHP.
array $options
Параметры для проверки ширины и высоты.

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

boolean

Исключения

InvalidArgumentException

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

iso8601()source public static

iso8601( string|DateTimeInterface $check )

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

Параметры

string|DateTimeInterface $check
Значение для проверки

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

boolean
True, если значение допустимо, иначе 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
Успех
END_OF_DOCUMENT_MARKER ```

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_algorithm

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

notBlank()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 $lower optional null
Нижняя граница
integer|float|null $upper optional 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 $truthyValues optional []
Список допустимых истинных значений, по умолчанию [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 $allowNoFile optional 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
Успех

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

$_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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API