Class yii\behaviors\AttributeTypecastBehavior

AttributeTypecastBehavior 提供了模型属性自动转换数据类型的能力。 这个行为在数据库语法比较弱化的数据库系统上使用 ActiveRecord 时比较有用，比如 MongoDB 或者 Redis 这些数据库。 它也可以在普通的 yii\db\ActiveRecord 甚至 yii\base\Model 上发挥作用。 因为它能够在执行模型验证之后保持严格的属性数据类型。

这个行为应该附加到 yii\base\Model 或者 yii\db\BaseActiveRecord 的子类中使用。

你应该通过 $attributeTypes 指明确切的数据类型。

比如：

use yii\behaviors\AttributeTypecastBehavior;

class Item extends \yii\db\ActiveRecord
{
    public function behaviors()
    {
        return [
            'typecast' => [
                'class' => AttributeTypecastBehavior::className(),
                'attributeTypes' => [
                    'amount' => AttributeTypecastBehavior::TYPE_INTEGER,
                    'price' => AttributeTypecastBehavior::TYPE_FLOAT,
                    'is_active' => AttributeTypecastBehavior::TYPE_BOOLEAN,
                ],
                'typecastAfterValidate' => true,
                'typecastBeforeSave' => false,
                'typecastAfterFind' => false,
            ],
        ];
    }

    // ...
}

Tip: 你可以把 $attributeTypes 留空， 这时行为将通过属主组件的验证规则自动组装它的值。 下面的例子展示了 $attributeTypes 是根据它上面的 rules 方法里的验证规则创建了一模一样的数据类型：

use yii\behaviors\AttributeTypecastBehavior;

class Item extends \yii\db\ActiveRecord
{

    public function rules()
    {
        return [
            ['amount', 'integer'],
            ['price', 'number'],
            ['is_active', 'boolean'],
        ];
    }

    public function behaviors()
    {
        return [
            'typecast' => [
                'class' => AttributeTypecastBehavior::className(),
                // 'attributeTypes' will be composed automatically according to `rules()`
            ],
        ];
    }

    // ...
}

这个行为允许自动类型转换发生在如下的场景：

• 在成功通过模型验证之后
• 在模型保存之前（插入或者更新）
• 在模型查找之后（通过查询语句找到模型或模型执行刷新）

你可以通过使用 $typecastAfterValidate，$typecastBeforeSave 和 $typecastAfterFind 来控制自动转换发生在哪些指定的场景。 默认情况下只在模型成功通过验证之后进行类型转换。

Note: 你也可以在任何时候手动地通过调用 typecastAttributes() 方法触发属性的类型转换：

$model = new Item();
$model->price = '38.5';
$model->is_active = 1;
$model->typecastAttributes();