Yii2 模型实现 Arrayable 接口后 toArray 行为有什么变化-php教程-PHP中文网

yii2模型默认实现arrayable接口，可通过重写fields()和extrafields()定制toarray()输出：字段白名单/黑名单、关联数据显式展开、嵌套路径与回调处理；asarray()则绕过模型直接映射数据库字段，两者路径不同。

yii2 模型实现 arrayable 接口后 toarray 行为有什么变化

Yii2 模型默认就实现了 Arrayable 接口（因为 yii\base\Model 和 yii\db\ActiveRecord 都已实现），所以你不需要手动实现它，但你可以重写 toArray() 的行为来精确控制哪些字段、如何嵌套、是否包含关联数据、是否应用过滤逻辑等。

关键点不是“实现接口后行为变化”，而是“重写 toArray() 或相关 Arrayable 方法后，输出结构可被定制”。

以下是实际影响你 API 输出的几个核心变化方向：

Yii Framework 2.0.51

Yii Framework 2.0.51 官方 Basic 应用模板，适合旧项目兼容、升级验证和开发测试。

下载

字段白名单/黑名单控制
重写 fields() 返回允许导出的字段列表；重写 extraFields() 定义可选扩展字段（如关联模型、计算属性）。
```
public function fields()
{
    return ['id', 'name', 'email']; // 只暴露这三个字段
}
public function extraFields()
{
    return ['profile', 'posts']; // 关联对象需定义 getter 或 relation
}
```
调用 $model->toArray(['id', 'name'], ['profile']) 时，才会包含 profile 数据。
关联数据自动展开需显式声明
toArray() 默认不递归展开关联对象。即使 profile 是一个 ActiveRecord 对象，不进 extraFields() + 显式请求，就不会转成数组。
若 profile 是 hasOne() 关系，且你在 extraFields() 中定义了它，toArray() 会自动调用其 toArray() —— 前提是该关联对象也支持 Arrayable（它天然支持）。

支持嵌套路径与回调处理
toArray() 内部使用 ArrayHelper::toArray() 处理嵌套结构，因此支持点语法路径（如 'profile.name'）、闭包转换：

public function fields()
{
    return [
        'id',
        'full_name' => function ($model) {
            return $model->firstName . ' ' . $model->lastName;
        },
    ];
}

自动跳过敏感字段或未设置值
如果某个字段在 fields() 中声明，但模型属性为 null 且未设默认值，toArray() 默认不会输出该键（除非你覆盖 toArray() 并传入 $keepNulls = true）。
你也可以在 fields() 中用 isset() 或 !empty() 过滤动态字段。
与 asArray() 查询模式无关
注意：ActiveRecord::find()->asArray()->one() 返回的是原生数组，绕过模型实例，完全不走 toArray()。它只做数据库字段到数组的直映射，无字段过滤、无关联展开、无类型转换。这是两条不同路径。

本质上，toArray() 是面向资源表达层（如 REST API 响应） 的可控序列化入口；而 asArray() 是面向查询性能优化的底层数据获取方式。