Class CakeValidationRule
CakeValidationRule object. Represents a validation method, error message and rules for applying such method to a field.
Link: http://book.cakephp.org/2.0/en/data-validation.html
Copyright: Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
License: MIT License
Location: Cake/Model/Validator/CakeValidationRule.php
Properties summary
-
$_passedOptions
protectedarray
Holds passed in options -
$_recordExists
protectedboolean
Holds whether the record being validated exists in datasource or not -
$_rule
protectedmixed
Validation method -
$_ruleParams
protectedarray
Validation method arguments -
$_valid
protectedmixed
Whether the field passed this validation rule -
$allowEmpty
publicboolean
The 'allowEmpty' key -
$last
publicboolean
The 'last' key -
$message
publicstring
The 'message' key -
$on
publicstring
The 'on' key -
$required
publicmixed
The 'required' key -
$rule
publicmixed
The 'rule' key
Method Summary
-
__construct() public
Constructor -
_addValidatorProps() protected
Sets the rule properties from the rule entry in validate -
_getPropertiesArray() protected
Gets an array with the rule properties -
_parseRule() protected
Parses the rule and sets the rule and ruleParams -
checkEmpty() public
Checks if the allowEmpty key applies -
checkRequired() public
Checks whether the field failed thefield should be present
validation -
getOptions() public
Returns passed options for this rule -
getValidationResult() public
Gets the validation error message -
isEmptyAllowed() public
Returns whether the field can be left blank according to this rule -
isLast() public
Returns whether this rule should break validation process for associated field after it fails
-
isRequired() public
Checks if the field is required according to therequired
property -
isUpdate() public
Sets the recordExists configuration value for this rule, ir refers to whether the model record it is validating exists exists in the collection or not (create or update operation)
-
isValid() public
Checks if the rule is valid -
process() public
Dispatches the validation rule to the given validator method -
reset() public
Resets internal state for this rule, by default it will become valid and it will set isUpdate() to false
-
skip() public
Checks if the validation rule should be skipped
Method Detail
__construct() public ¶
__construct( array $validator = array() )
Constructor
Parameters
- array $validator optional array()
- [optional] The validator properties
_addValidatorProps() protected ¶
_addValidatorProps( array $validator = array() )
Sets the rule properties from the rule entry in validate
Parameters
- array $validator optional array()
- [optional]
_getPropertiesArray() protected ¶
_getPropertiesArray( )
Gets an array with the rule properties
Returns
_parseRule() protected ¶
_parseRule( string $field , array $data )
Parses the rule and sets the rule and ruleParams
Parameters
- string $field
- Field name
- array $data
- Data array
checkEmpty() public ¶
checkEmpty( string $field , array $data )
Checks if the allowEmpty key applies
Parameters
- string $field
- Field name
- array $data
- data to check rule against
Returns
checkRequired() public ¶
checkRequired( string $field , array $data )
Checks whether the field failed the field should be present
validation
Parameters
- string $field
- Field name
- array $data
- Data to check rule against
Returns
getOptions() public ¶
getOptions( string|integer $key )
Returns passed options for this rule
Parameters
- string|integer $key
- Array index
Returns
getValidationResult() public ¶
getValidationResult( )
Gets the validation error message
Returns
isEmptyAllowed() public ¶
isEmptyAllowed( )
Returns whether the field can be left blank according to this rule
Returns
isLast() public ¶
isLast( )
Returns whether this rule should break validation process for associated field after it fails
Returns
isRequired() public ¶
isRequired( )
Checks if the field is required according to the required
property
Returns
isUpdate() public ¶
isUpdate( boolean $exists = null )
Sets the recordExists configuration value for this rule, ir refers to whether the model record it is validating exists exists in the collection or not (create or update operation)
If called with no parameters it will return whether this rule is configured for update operations or not.
Parameters
- boolean $exists optional null
- Boolean to indicate if records exists
Returns
process() public ¶
process( string $field , array $data , array $methods )
Dispatches the validation rule to the given validator method
Parameters
- string $field
- Field name
- array $data
- Data array
- array $methods
- Methods list
Returns
True if the rule could be dispatched, false otherwise
Properties detail
$_recordExists ¶
Holds whether the record being validated exists in datasource or not
false