codeonyii / yii2-at-least-validator
Validates at least one (or more) attributes.
Installs: 204 092
Dependents: 1
Suggesters: 0
Security: 0
Stars: 28
Watchers: 6
Forks: 19
Open Issues: 8
Type:yii2-extension
Requires
- php: >=5.6
- yiisoft/yii2: ~2.0.5
Requires (Dev)
- phpunit/phpunit: 6.5.8
This package is auto-updated.
Last update: 2024-10-16 03:09:38 UTC
README
Sometimes, in a set of fields, you need to make at least one of them (sometimes two, or more) be filled. For example, phone OR e-mail, (facebook OR linkedin) OR (linkedin OR instagram) and so on. You can do it using required validator with a bunch of conditional rules. Or you can use AtLeastValidator.
Installation
Use composer:
composer require "codeonyii/yii2-at-least-validator"
In your Model, import the validator:
use codeonyii\yii2validators\AtLeastValidator; class MyModel extends Model { ... public function rules() { // see examples below } ...
Examples
In the following example, the phone
and email
attributes will
be verified. If none of them are filled phone
will receive an error.
Please, note that in
param is always mandatory.
// in rules() return [ ['phone', AtLeastValidator::className(), 'in' => ['phone', 'email']], ];
Here, facebook
, linkedin
and instagram
attributes will
be verified. If at least 2 (note the min
param) of them are not filled,
facebook
and instagram
will receive an error:
// in rules() return [ [['facebook', 'instagram'], AtLeastValidator::className(), 'in' => ['facebook', 'linkedin', 'instagram'], 'min' => 2], ];
Showing errors in summary
If you want to show errors in a summary instead in the own attributes, you can do this:
Note that summary will not work for client-side validation. If you want to use it, you should disable the client-side validation for your fields or for your entire form.
// in the rules() // please note the exclamation mark. It will avoid the pk attribute to be massively assigned. return [ ['!id', AtLeastValidator::className(), 'in' => ['attr1', 'attr2', 'attr3']], // where `id` is the pk ]; // in the view, show all errors in the summary: ... echo yii\helpers\Html::errorSummary($model, ['class' => ['text-danger']]); // OR, to show only `id` errors: echo yii\helpers\Html::error($model, 'id', ['class' => ['text-danger']]);
Changelog
Please, access Releases to see versions with a some description.