yii2-at-least-validator ¶

1. Installation
2. Examples
3. Changelog

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.

See this on github.com/code-on-yii/at-least-validator.

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 ¶

• 1.1: Adds client-side validation;
• 1.0.3: Basic funcionality and tests;