Class RulesChecker
ORM flavoured rules checker.
Adds ORM related features to the RulesChecker class.
Constants
-
stringCREATE ¶'create'Indicates that the checking rules to apply are those used for creating entities
-
stringDELETE ¶'delete'Indicates that the checking rules to apply are those used for deleting entities
-
stringUPDATE ¶'update'Indicates that the checking rules to apply are those used for updating entities
Property Summary
-
$_createRules protected
callable[]The list of rules to check during create operations
-
$_deleteRules protected
callable[]The list of rules to check during delete operations
-
$_options protected
arrayList of options to pass to every callable rule
-
$_rules protected
callable[]The list of rules to be checked on both create and update operations
-
$_updateRules protected
callable[]The list of rules to check during update operations
-
$_useI18n protected
boolWhether or not to use I18n functions for translating default error messages
Method Summary
-
__construct() public
Constructor. Takes the options to be passed to all rules.
-
_addError() protected
Utility method for decorating any callable so that if it returns false, the correct property in the entity is marked as invalid.
-
_checkRules() protected
Used by top level functions checkDelete, checkCreate and checkUpdate, this function iterates an array containing the rules to be checked and checks them all.
-
add() public
Adds a rule that will be applied to the entity both on create and update operations.
-
addCreate() public
Adds a rule that will be applied to the entity on create operations.
-
addDelete() public
Adds a rule that will be applied to the entity on delete operations.
-
addUpdate() public
Adds a rule that will be applied to the entity on update operations.
-
check() public
Runs each of the rules by passing the provided entity and returns true if all of them pass. The rules to be applied are depended on the $mode parameter which can only be RulesChecker::CREATE, RulesChecker::UPDATE or RulesChecker::DELETE
-
checkCreate() public
Runs each of the rules by passing the provided entity and returns true if all of them pass. The rules selected will be only those specified to be run on 'create'
-
checkDelete() public
Runs each of the rules by passing the provided entity and returns true if all of them pass. The rules selected will be only those specified to be run on 'delete'
-
checkUpdate() public
Runs each of the rules by passing the provided entity and returns true if all of them pass. The rules selected will be only those specified to be run on 'update'
-
existsIn() public
Returns a callable that can be used as a rule for checking that the values extracted from the entity to check exist as the primary key in another table.
-
isUnique() public
Returns a callable that can be used as a rule for checking the uniqueness of a value in the table.
-
validCount() public
Validates the count of associated records.
Method Detail
__construct() ¶ public
__construct(array $options = [])Constructor. Takes the options to be passed to all rules.
Parameters
-
array$options optional The options to pass to every rule
_addError() ¶ protected
_addError(callable $rule, string $name, array $options): callableUtility method for decorating any callable so that if it returns false, the correct property in the entity is marked as invalid.
Parameters
-
callable$rule The rule to decorate
-
string$name The alias for a rule.
-
array$options The options containing the error message and field.
Returns
callable_checkRules() ¶ protected
_checkRules(Cake\Datasource\EntityInterface $entity, array $options = [], array $rules = []): boolUsed by top level functions checkDelete, checkCreate and checkUpdate, this function iterates an array containing the rules to be checked and checks them all.
Parameters
-
Cake\Datasource\EntityInterface$entity The entity to check for validity.
-
array$options optional Extra options to pass to checker functions.
-
array$rules optional The list of rules that must be checked.
Returns
booladd() ¶ public
add(callable $rule, string|null $name = null, array $options = []): $thisAdds a rule that will be applied to the entity both on create and update operations.
Options
The options array accept the following special keys:
errorField: The name of the entity field that will be marked as invalid if the rule does not pass.message: The error message to set toerrorFieldif the rule does not pass.
Parameters
-
callable$rule A callable function or object that will return whether the entity is valid or not.
-
string|null$name optional The alias for a rule.
-
array$options optional List of extra options to pass to the rule callable as second argument.
Returns
$thisaddCreate() ¶ public
addCreate(callable $rule, string|null $name = null, array $options = []): $thisAdds a rule that will be applied to the entity on create operations.
Options
The options array accept the following special keys:
errorField: The name of the entity field that will be marked as invalid if the rule does not pass.message: The error message to set toerrorFieldif the rule does not pass.
Parameters
-
callable$rule A callable function or object that will return whether the entity is valid or not.
-
string|null$name optional The alias for a rule.
-
array$options optional List of extra options to pass to the rule callable as second argument.
Returns
$thisaddDelete() ¶ public
addDelete(callable $rule, string|null $name = null, array $options = []): $thisAdds a rule that will be applied to the entity on delete operations.
Options
The options array accept the following special keys:
errorField: The name of the entity field that will be marked as invalid if the rule does not pass.message: The error message to set toerrorFieldif the rule does not pass.
Parameters
-
callable$rule A callable function or object that will return whether the entity is valid or not.
-
string|null$name optional The alias for a rule.
-
array$options optional List of extra options to pass to the rule callable as second argument.
Returns
$thisaddUpdate() ¶ public
addUpdate(callable $rule, string|null $name = null, array $options = []): $thisAdds a rule that will be applied to the entity on update operations.
Options
The options array accept the following special keys:
errorField: The name of the entity field that will be marked as invalid if the rule does not pass.message: The error message to set toerrorFieldif the rule does not pass.
Parameters
-
callable$rule A callable function or object that will return whether the entity is valid or not.
-
string|null$name optional The alias for a rule.
-
array$options optional List of extra options to pass to the rule callable as second argument.
Returns
$thischeck() ¶ public
check(Cake\Datasource\EntityInterface $entity, string $mode, array $options = []): boolRuns each of the rules by passing the provided entity and returns true if all of them pass. The rules to be applied are depended on the $mode parameter which can only be RulesChecker::CREATE, RulesChecker::UPDATE or RulesChecker::DELETE
Parameters
-
Cake\Datasource\EntityInterface$entity The entity to check for validity.
-
string$mode Either 'create, 'update' or 'delete'.
-
array$options optional Extra options to pass to checker functions.
Returns
boolThrows
InvalidArgumentExceptionif an invalid mode is passed.
checkCreate() ¶ public
checkCreate(Cake\Datasource\EntityInterface $entity, array $options = []): boolRuns each of the rules by passing the provided entity and returns true if all of them pass. The rules selected will be only those specified to be run on 'create'
Parameters
-
Cake\Datasource\EntityInterface$entity The entity to check for validity.
-
array$options optional Extra options to pass to checker functions.
Returns
boolcheckDelete() ¶ public
checkDelete(Cake\Datasource\EntityInterface $entity, array $options = []): boolRuns each of the rules by passing the provided entity and returns true if all of them pass. The rules selected will be only those specified to be run on 'delete'
Parameters
-
Cake\Datasource\EntityInterface$entity The entity to check for validity.
-
array$options optional Extra options to pass to checker functions.
Returns
boolcheckUpdate() ¶ public
checkUpdate(Cake\Datasource\EntityInterface $entity, array $options = []): boolRuns each of the rules by passing the provided entity and returns true if all of them pass. The rules selected will be only those specified to be run on 'update'
Parameters
-
Cake\Datasource\EntityInterface$entity The entity to check for validity.
-
array$options optional Extra options to pass to checker functions.
Returns
boolexistsIn() ¶ public
existsIn(string|string[] $field, object|string $table, string|array|null $message = null): callableReturns a callable that can be used as a rule for checking that the values extracted from the entity to check exist as the primary key in another table.
This is useful for enforcing foreign key integrity checks.
Example:
$rules->add($rules->existsIn('author_id', 'Authors', 'Invalid Author'));
$rules->add($rules->existsIn('site_id', new SitesTable(), 'Invalid Site'));Available $options are error 'message' and 'allowNullableNulls' flag. 'message' sets a custom error message. Set 'allowNullableNulls' to true to accept composite foreign keys where one or more nullable columns are null.
Parameters
-
string|string[]$field The field or list of fields to check for existence by primary key lookup in the other table.
-
object|string$table The table name where the fields existence will be checked.
-
string|array|null$message optional The error message to show in case the rule does not pass. Can also be an array of options. When an array, the 'message' key can be used to provide a message.
Returns
callableisUnique() ¶ public
isUnique(string[] $fields, string|array|null $message = null): callableReturns a callable that can be used as a rule for checking the uniqueness of a value in the table.
Example:
$rules->add($rules->isUnique(['email'], 'The email should be unique'));Parameters
-
string[]$fields The list of fields to check for uniqueness.
-
string|array|null$message optional The error message to show in case the rule does not pass. Can also be an array of options. When an array, the 'message' key can be used to provide a message.
Returns
callablevalidCount() ¶ public
validCount(string $field, int $count = 0, string $operator = '>', string|null $message = null): callableValidates the count of associated records.
Parameters
-
string$field The field to check the count on.
-
int$count optional The expected count.
-
string$operator optional The operator for the count comparison.
-
string|null$message optional The error message to show in case the rule does not pass.
Returns
callable