urmaul/yii-enumattributes

Yii ActiveRecord behavior used to work with ENUM attributes.

Yii Enumattributes

Yii ActiveRecord behavior used to work with ENUM attributes, _(*1)

Installing

composer require urmaul/yii-enumattributes dev-master

Attaching example

You need to add this behavior to behaviors:, _(*2)

public function behaviors()
{
    return array(
        ...
        'statusEnum' => array(
            'class' => 'EnumAttributesBehavior',
            'attribute' => 'status',
        ),
    );
}

Options

• attribute (string) - enum attribute name
• labels (array) - custom labels array (value => label)

Class phpDoc

And also you should add behavior property to phpDoc comments:, _(*3)

/**
 * ...
 * 
 * @property EnumAttributesBehavior $statusEnum
 */
class ...

Using

Values

Now you can retrieve list of possible values by calling behavior like that:, _(*4)

$model->statusEnum->values

Values order is equal to values order in DB structure., _(*5)

Labels

Or you can retrieve a map "value => label" by calling behavior like that:, _(*6)

$model->statusEnum->valueLabels

Values order is equal to values order in DB structure., _(*7)

Labels are generated from values using CModel::generateAttributeLabel function. You can set custom labels using the labels behavior option., _(*8)

Validation rule

This behavior can generate validation rule for you., _(*9)

public function rules()
{
    return array(
        ...
        $this->statusEnum->rule,
        // or
        $this->statusEnum->rule + array('on' => 'create'),
        ...
    );
}