Класс RulesChecker

existsIn()source public

existsIn( string|array $field , object|string $table , string|array|null $message = null )

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

Это полезно для обеспечения целостности внешних ключей.

Пример:

$rules->add($rules->existsIn('author_id', 'Authors', 'Invalid Author'));

$rules->add($rules->existsIn('site_id', new SitesTable(), 'Invalid Site'));

Доступные параметры — сообщение об ошибке 'message' и флаг 'allowNullableNulls'. 'message' задаёт пользовательское сообщение об ошибке. Установите 'allowNullableNulls' в true, чтобы принять составные внешние ключи, где один или несколько столбцов со значением NULL.

Параметры

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

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

объект|строка $table

Имя таблицы, в которой будет проверяться существование полей.

строка|массив|null $message необязательно null

Сообщение об ошибке, которое будет показано в случае, если правило не выполнено. Также может быть массивом опций. Если массив, ключ 'message' может использоваться для указания сообщения.

Возвращает

вызываемый объект

isUnique()source public

isUnique( array $fields , string|array|null $message = null )

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

Пример:

$rules->add($rules->isUnique(['email'], 'The email should be unique'));

Параметры

массив $fields

Список полей для проверки уникальности.

строка|массив|null $message необязательно null

Сообщение об ошибке, которое будет показано в случае, если правило не выполнено. Также может быть массивом опций. Если массив, ключ 'message' может использоваться для указания сообщения.

Возвращает

вызываемый объект

validCount()source public

validCount( string $field , integer $count = 0 , string $operator = '>' , string|null $message = null )

Проверяет количество связанных записей.

Параметры

строка $field

Поле, на котором нужно проверить количество.

целое число $count необязательно 0

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

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

Оператор для сравнения количества.

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

Сообщение об ошибке, которое будет показано в случае, если правило не выполнено.

Возвращает

вызываемый объект

__construct()source public

__construct( array $options = [] )

Конструктор. Принимает опции, которые будут переданы всем правилам.

Параметры

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

Опции для передачи каждому правилу

_addError()source protected

_addError( callable $rule , string $name , array $options )

Вспомогательный метод для оформления любого вызываемого объекта таким образом, что если он возвращает false, соответствующее свойство в сущности помечается как недействительное.

Параметры

вызываемый объект $rule

Правило для оформления

строка $name

Псевдоним правила.

массив $options

Опции, содержащие сообщение об ошибке и поле.

Возвращает

вызываемый объект

_checkRules()source protected

_checkRules( Cake\Datasource\EntityInterface $entity , array $options = [] , array $rules = [] )

Используется функциями верхнего уровня checkDelete, checkCreate и checkUpdate. Эта функция итерирует массив, содержащий правила для проверки, и проверяет их все.

Параметры

Cake\Datasource\EntityInterface $entity

Сущность, для проверки валидности.

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

Дополнительные опции для передачи функциям проверки.

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

Список правил, которые должны быть проверены.

Возвращает

boolean

add()source public

add( callable $rule , string|null $name = null , array $options = [] )

Добавляет правило, которое будет применено к сущности при операциях создания и обновления.

Опции

Массив опций принимает следующие специальные ключи:

• errorField: Имя поля сущности, которое будет помечено как недействительное, если правило не выполняется.
• message: Сообщение об ошибке, которое будет установлено в errorField если правило не выполняется.

Параметры

вызываемый объект $rule

Вызываемая функция или объект, которые возвращают, является ли сущность валидной или нет.

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

Псевдоним правила.

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

Список дополнительных опций для передачи вызываемому объекту как второго аргумента.

Возвращает

$this

addCreate()source public

addCreate( callable $rule , string|null $name = null , array $options = [] )

Добавляет правило, которое будет применено к сущности при операциях создания.

Опции

Массив опций принимает следующие специальные ключи:

• errorField: Имя поля сущности, которое будет помечено как недействительное, если правило не выполняется.
• message: Сообщение об ошибке, которое будет установлено в errorField если правило не выполняется.

Параметры

вызываемый объект $rule

Вызываемая функция или объект, которые возвращают, является ли сущность валидной или нет.

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

Псевдоним правила.

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

Список дополнительных опций для передачи вызываемому объекту как второго аргумента.

Возвращает

$this

addDelete()source public

addDelete( callable $rule , string|null $name = null , array $options = [] )

Добавляет правило, которое будет применено к сущности при операциях удаления.

Опции

Массив опций принимает следующие специальные ключи:

• errorField: Имя поля сущности, которое будет помечено как недействительное, если правило не выполняется.
• message: Сообщение об ошибке, которое будет установлено в errorField если правило не выполняется.

Параметры

вызываемый объект $rule

Вызываемая функция или объект, которые возвращают, является ли сущность валидной или нет.

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

Псевдоним правила.

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

Список дополнительных опций для передачи вызываемому объекту как второго аргумента.

Возвращает

$this

addUpdate()source public

addUpdate( callable $rule , string|null $name = null , array $options = [] )

Добавляет правило, которое будет применено к сущности при операциях обновления.

Параметры

Массив параметров принимает следующие специальные ключи:

• errorField: Название поля сущности, которое будет помечено как некорректное, если правило не выполняется.
• message: Сообщение об ошибке, которое будет установлено для errorField , если правило не выполняется.

Параметры

callable $rule

Функция или объект вызова, который вернёт, является ли сущность допустимой или нет.

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

Псевдоним правила.

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

Список дополнительных параметров для передачи в функцию-правило в качестве второго аргумента.

Возвращает

$this

check()source public

check( Cake\Datasource\EntityInterface $entity , string $mode , array $options = [] )

Выполняет каждое из правил, передавая предоставленную сущность, и возвращает true, если все они выполнены. Правила, которые будут применяться, зависят от параметра $mode, который может быть только RulesChecker::CREATE, RulesChecker::UPDATE или RulesChecker::DELETE

Параметры

Cake\Datasource\EntityInterface $entity

Сущность, для которой проверяется допустимость.

string $mode

Значение 'create', 'update' или 'delete'.

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

Дополнительные параметры для передачи функциям проверки.

Возвращает

boolean

Исключения

InvalidArgumentException
если передан недопустимый режим.

checkCreate()source public

checkCreate( Cake\Datasource\EntityInterface $entity , array $options = [] )

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

Параметры

Cake\Datasource\EntityInterface $entity

Сущность, для которой проверяется допустимость.

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

Дополнительные параметры для передачи функциям проверки.

Возвращает

boolean

checkDelete()source public

checkDelete( Cake\Datasource\EntityInterface $entity , array $options = [] )

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

Параметры

Cake\Datasource\EntityInterface $entity

Сущность, для которой проверяется допустимость.

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

Дополнительные параметры для передачи функциям проверки.

Возвращает

boolean

checkUpdate()source public

checkUpdate( Cake\Datasource\EntityInterface $entity , array $options = [] )

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

Параметры

Cake\Datasource\EntityInterface $entity

Сущность, для которой проверяется допустимость.

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

Дополнительные параметры для передачи функциям проверки.

Возвращает

boolean