kop / yii2-conditional-validator
If-then validation rules for Yii2 Framework
Installs: 5 010
Dependents: 0
Suggesters: 0
Security: 0
Stars: 13
Watchers: 3
Forks: 6
Open Issues: 0
Type:yii2-extension
Requires
- php: >=5.4.0
- yiisoft/yii2: *
This package is auto-updated.
Last update: 2019-10-10 10:02:14 UTC
README
Note: Since version
2.0.0-beta
, Yii2 has it's own conditional validator built in to the core. Please use validator provided by the framework. This extension will no receive updates any longer.
Yii2 Conditional Validator (Y2CV) validates some attributes depending on certain conditions (rules).
You can use any core validator as you usually would do or any other class based or inline validator.
An interesting feature is that you can even use the own Y2CV inside itself to perform more complex conditions.
Basically, Y2CV executes the rules set in the param if
and if there are no errors executes the rules set in the param then
.
Requirements
- Yii 2.0
- PHP 5.4
Installation
The preferred way to install this extension is through Composer.
Either run
php composer.phar require kop/yii2-conditional-validator "dev-master"
or add
"kop/yii2-conditional-validator": "dev-master"
to the require
section of your composer.json
file.
Syntax Example
[['safeAttributes'], `path.to.ConditionalValidator`, 'if' => [ // rule1: [['attrX', 'attrY'], 'required', ... ] // ruleN: ... ], 'then' => [ // rule1: [['attrZ', 'attrG'], 'required', ... ] // ruleN: ... ] ]
safeAttributes
: The name of the attributes that should be turned safe (since Yii has no way to make dynamic validators to turn attributes safe);path.to.ConditionalValidator
: In the most of cases will beConditionalValidator::className()
;if
: (bidimensional array) The conditional rules to be validated. Only if they are all valid (i.e., have no errors) then the rules inthen
will be validated;then
: (bidimensional array) The rules that will be validated only if there are no errors in rules ofif
param.
Note: Errors in the rules set in the param
if
are discarded after checking. Only errors in the rules set in paramthen
are really kept.
Usage Examples
If
customer_type is "active" then
birthdate and city are required
:
public function rules() { return [ [['customer_type'], ConditionalValidator::className(), 'if' => [ [['customer_type'], 'compare', 'compareValue' => 'active'] ], 'then' => [ [['birthdate', 'city'], 'required'] ] ] ]; }
If
customer_type is "inactive" then
birthdate and city are required
and city must be "sao_paulo", "sumare" or "jacarezinho":
public function rules() { return [ [['customer_type'], ConditionalValidator::className(), 'if' => [ [['customer_type'], 'compare', 'compareValue' => 'active'] ), 'then' => [ [['birthdate', 'city'], 'required'], [['city'], 'in', 'range' => ['sao_paulo', 'sumare', 'jacarezinho']] ] ] ]; }
If
information starts with 'http://' and has at least 24 chars length then
the own information must be a valid url:
public function rules() { return [ [['information'], ConditionalValidator::className(), 'if' => [ [['information'], 'match', 'pattern' => '/^http:\/\//'], [['information'], 'string', 'min' => 24, 'allowEmpty' => false] ), 'then' => [ [['information'], 'url'] ] ] ]; }
License
yii2-conditional-validator is released under the MIT License. See the bundled LICENSE.md
for details.