ArrayHelper::toArray() 默认不递归且不识别 extraFields()，需同时设置 $recursive = true 并在 $properties 中显式列出关联字段（如 'profile'）才能展开关联模型。
这个问题很典型：你调用了 ArrayHelper::toArray($model)，但发现关联模型（比如 $user->profile）没被转成数组，字段还是对象，甚至抛出“Call to a member function toArray() on null”——根本原因不是方法失效，而是默认行为不递归处理关联，且没触发模型自身的序列化逻辑。
默认不递归，也不走 extraFields
ArrayHelper::toArray() 默认只做浅层转换：它把对象属性值原样搬进数组，不会自动调用关联对象的 toArray() 方法，也不会读取模型定义的 extraFields()。也就是说，即使你在 User 模型里写了：
public function extraFields()
{
return ['profile'];
}
这个 profile 字段依然不会被展开——因为 ArrayHelper::toArray() 不识别、也不执行 extraFields() 的声明。
必须显式开启递归，并手动指定字段
要让关联生效，两个条件缺一不可：
-
设置
$recursive = true：这是开关，不设就永远只转当前对象一层； -
在
$properties中明确列出关联字段名（如'profile'），或用点语法指定其内部字段（如'profile.name'）；
正确写法示例：
$result = ArrayHelper::toArray($user, [
'app\models\User' => [
'id',
'username',
'profile', // ← 关联对象名，必须显式写出
'createdAt' => 'created_at',
],
], true); // ← 第三个参数必须为 true
此时，只要 $user->profile 不为 null，且 Profile 模型也实现了 toArray()（或继承自 ActiveRecord），就会被递归转换。
extraFields 是模型自己的规则，和 ArrayHelper 无关
extraFields() 只在模型调用自身 toArray() 方法时起作用（例如 $user->toArray(['profile'])）。而 ArrayHelper::toArray() 是一个通用工具函数，它不感知模型上下文，也不调用模型方法——它只按你给的 $properties 映射表去取值、转换、递归。
换句话说：extraFields() 和 ArrayHelper::toArray() 属于两套机制。想用前者，就别绕路用后者；想用后者控制输出结构，就得老老实实填 $properties 数组。
常见踩坑点
- 忘了传第三个参数
true，导致'profile'被当普通属性原样塞进结果，仍是对象； - 在
$properties里写了'profile'，但$user->profile是null，结果该键直接消失（可加空值兜底：用回调返回空数组）； - 关联模型没有实现
toArray()，或字段受fields()限制，导致递归后内容为空； - 误以为
ArrayHelper::toArray($models, [], true)会自动展开所有关联——不会，必须逐个指定。
