yii2-at-least-validator

KO | EN

gitlite — search

#javascript #hacktoberfest #react #typescript #rust #deep-learning #docker #macos #nodejs #awesome #cli #pytorch #mcp #ios

yii2-at-least-validator

(★ 28)

Makes one or more attributes mandatory inside a set of attributes.

yii2-at-least-validator Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Yii 2 - AtLeastValidator

[![Latest Stable Version](https://poser.pugx.org/codeonyii/yii2-at-least-validator/v/stable)](https://packagist.org/packages/codeonyii/yii2-at-least-validator)
[![Total Downloads](https://img.shields.io/packagist/dt/codeonyii/yii2-at-least-validator.svg)](https://packagist.org/packages/codeonyii/yii2-at-least-validator)
[![Build Status](https://travis-ci.org/slinstj/yii2-at-least-validator.svg?branch=master)](https://travis-ci.org/slinstj/yii2-at-least-validator)
[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/slinstj/yii2-at-least-validator/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/slinstj/yii2-at-least-validator/?branch=master)
[![CodeFactor](https://www.codefactor.io/repository/github/slinstj/yii2-at-least-validator/badge)](https://www.codefactor.io/repository/github/slinstj/yii2-at-least-validator)

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:

```php
    composer require "codeonyii/yii2-at-least-validator"
```
In your Model, import the validator:
```php
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.

```php
     // 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:

```php
     // 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.*

```php
     // 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](https://github.com/code-on-yii/yii2-at-least-validator/releases) to see versions with a some description.

yii2-at-least-validator

yii2-at-least-validator Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

yii2-at-least-validator

yii2-at-least-validator Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README