herroffizier/yii2-attribute-index-validator

Yii2 validator that adds incremental index to attribute values to make them unique.

Yii2 Attribute Index Validator

, _(*1)

This validator solves value collisions for unique model attributes by adding incremental index to repeating values. E.g. title will become title-1 if item with title already exists., _(*2)

Such behavior may be useful for tasks like generating URLs and so on., _(*3)

Installation

Install validator with Composer:, _(*4)

composer require --prefer-dist "herroffizier/yii2-attribute-index-validator:@stable"

Usage

Add validator to your model's rules array before required and unique validators (if any)., _(*5)

use herroffizier\yii2aiv\AttributeIndexValidator;

...

public function rules()
{
    return [
        [['attribute'], AttributeIndexValidator::className()],
        [['attribute'], 'required'],
        [['attribute'], 'unique'],
    ];
}

Validator has a few options to customize its behavior., _(*6)

• separator sets separator between original value and index. Default separator is -.
• startIndex defines start index. Default value is 1.
• filter defines additional filter to be applied to query used to check attribute uniqueness. May be either a string, an array or an anonymous function. In case of string or array filter value will be passed to \yii\web\ActiveQueryInterface::andWhere() method. In case of anonymous function its signature must be function($query) and instance of \yii\web\ActiveQueryInterface will be passed to it. Default value is null.