mkiselev/yii2-serialize-attribute-behavior

Yii2 serialize attribute behavior

Yii2 Serialize Attribute Behavior

This Yii 2.0 ActiveRecord behavior allows you to store serialized values in attributes., _(*1)

Installation

The preferred way to install this extension is through composer., _(*2)

Either run, _(*3)

php composer.phar require --prefer-dist mkiselev/yii2-serialize-attribute-behavior "*"

or add, _(*4)

"mkiselev/yii2-serialize-attribute-behavior": "*"

to the require section of your composer.json file., _(*5)

Usage

Behavior adds property named "$attribute . $unserializedAttributeSuffix" to your ActiveRecord class., _(*6)

You can get unserialized property value like $model->propertyArray., _(*7)

You can set unserialized property value like $model->propertyArray = []., _(*8)

Basic

If you want to just serialize and unserialize attribute use a config like the following:, _(*9)

public function behaviors()
{
    return [
        ...
        [
            'class' => SerializeAttributeBehavior::className(),
            'attribute' => 'data',
            'unserializedAttributeSuffix' => 'Array',
        ],
        ...
    ];
}

Advanced

If you need more flexible logic, you may configure behavior like this:, _(*10)

public function behaviors()
{
    return [
        ...
        [
            'class' => SerializeAttributeBehavior::className(),
            'attribute' => 'data',
            'unserializedAttributeSuffix' => 'Model',
            // MyModel must extend mkiselev\serialized\Model
            'setAttributesToModel' => MyModel::className(),
            'setAttributesToModelSafeOnly' => true,
            // serializerClass must implements mkiselev\serialized\interfaces\SerializerInterface
            'serializerClass' => MySerializer::className(),
        ],
        ...
    ];
}

In the example above MyModel must contain attributes, rules, and more in order to support ActiveField attributes unserialization., _(*11)

For example:, _(*12)

<?= $form->field($model, 'activeRecordModelAttribute')->textInput(); ?>
<?= $form->field($model->dataModel, 'MyModelAttribute')->textInput(); ?>

Use cases

• This behavior was developed primarily for use with JSON in PostgreSQL and MariaDB columns.
• You may use it to store any serialized data as text.