Class yii\behaviors\AttributeBehavior

AttributeBehavior automatically assigns a specified value to one or multiple attributes of an ActiveRecord object when certain events happen.

To use AttributeBehavior, configure the $attributes property which should specify the list of attributes that need to be updated and the corresponding events that should trigger the update. Then configure the $value property with a PHP callable whose return value will be used to assign to the current attribute(s). For example,

use yii\behaviors\AttributeBehavior;

public function behaviors()
{
    return [
        [
            'class' => AttributeBehavior::className(),
            'attributes' => [
                ActiveRecord::EVENT_BEFORE_INSERT => 'attribute1',
                ActiveRecord::EVENT_BEFORE_UPDATE => 'attribute2',
            ],
            'value' => function ($event) {
                return 'some value';
            },
        ],
    ];
}

Because attribute values will be set automatically by this behavior, they are usually not user input and should therefore not be validated, i.e. they should not appear in the rules() method of the model.

Public Properties

Public Methods

Protected Methods

Property Details

$attributes public property

List of attributes that are to be automatically filled with the value specified via $value. The array keys are the ActiveRecord events upon which the attributes are to be updated, and the array values are the corresponding attribute(s) to be updated. You can use a string to represent a single attribute, or an array to represent a list of attributes. For example,

[
    ActiveRecord::EVENT_BEFORE_INSERT => ['attribute1', 'attribute2'],
    ActiveRecord::EVENT_BEFORE_UPDATE => 'attribute2',
]

public array $attributes = []

$preserveNonEmptyValues public property (available since version 2.0.13)

Whether to preserve non-empty attribute values.

public boolean $preserveNonEmptyValues = false

$skipUpdateOnClean public property (available since version 2.0.8)

Whether to skip this behavior when the $owner has not been modified

public boolean $skipUpdateOnClean = true

$value public property

The value that will be assigned to the current attributes. This can be an anonymous function, callable in array format (e.g. [$this, 'methodName']), an Expression object representing a DB expression (e.g. new Expression('NOW()')), scalar, string or an arbitrary value. If the former, the return value of the function will be assigned to the attributes. The signature of the function should be as follows,

function ($event)
{
    // return value will be assigned to the attribute
}

public mixed $value = null

Method Details

[
    Model::EVENT_BEFORE_VALIDATE => 'myBeforeValidate',
    Model::EVENT_AFTER_VALIDATE => 'myAfterValidate',
]