toArray() 默认只浅层转换当前模型属性，不递归处理关联数据；需用load()预载入、显式调用子模型toArray()或重写方法实现嵌套转换与格式化。
toArray() 方法默认行为和常见误解
ThinkPHP 的 toArray() 并不自动递归处理关联模型或嵌套数据，它只对当前模型实例的属性做浅层转换。如果你调用了 with('user') 或 hasMany 关联后直接 toArray()，关联数据可能还是对象或闭包，导致 JSON 输出失败或字段丢失。
典型错误现象：json_encode() 报错 “Type error: Object of class think\Model could not be converted to string”，或者返回结果里 user 字段是空数组、null，甚至整个字段消失。
- 默认只转换模型自身的
$this->data，不触发关联模型的toArray() - 如果关联字段是延迟加载（如
getAttr中返回新模型），toArray()不会主动执行它 -
hidden、visible、append等模型配置在toArray()中生效，但需确保字段已实际读取
手动控制关联数据转换的三种方式
想让 toArray() 包含完整关联结构，不能只靠链式调用，得提前“落地”关联数据。
- 用
load()强制预载入并转为数组：$model->load(['user', 'posts'])->toArray()，前提是关联已在模型中定义且未被禁用 - 对已查出的关联模型显式调用
toArray()：$data = $model->toArray(); $data['user'] = $model->user->toArray(); - 重写模型的
toArray()方法，在内部统一处理关键关联（见下节）
注意：如果关联模型设置了 protected $hidden = ['password']，它的 toArray() 会自动过滤，但父模型不会自动继承该逻辑——必须让子模型自己完成转换。
立即学习“PHP免费学习笔记（深入）”；
自定义 toArray() 实现嵌套/过滤/格式化逻辑
直接重写模型类中的 toArray() 是最可控的方式，尤其适合需要统一处理时间格式、字段别名、敏感字段脱敏等场景。
public function toArray()
{
$data = parent::toArray();
// 转换关联（确保不是 null）
if (isset($this->user) && $this->user instanceof \think\Model) {
$data['user'] = $this->user->toArray();
}
// 格式化时间戳
if (isset($data['create_time'])) {
$data['create_time'] = date('Y-m-d H:i:s', (int) $data['create_time']);
}
// 删除敏感字段（即使 visible/hidden 没覆盖到）
unset($data['api_token']);
return $data;
}
关键点：
- 务必先调用
parent::toArray()获取基础数据，否则丢失模型原生逻辑（如自动类型转换、append字段） - 检查关联是否已加载（
isset($this->xxx)）且是模型实例，避免Call to a member function toArray() on null - 不要在
toArray()中做数据库查询——它可能被高频调用（如 API 分页列表），应确保所有依赖数据已提前加载
替代方案：用 collection()->toArray() 或 toJSON() 更安全
当处理的是集合（Db::name('user')->select() 返回 Collection），直接调用 toArray() 会尝试对每个项调用模型的 toArray()，但如果模型没重写，仍可能漏掉关联。此时更稳妥的是：
- 用
collection()->each(function ($item) { $item->load(['profile', 'roles']); })预加载后再toArray() - 改用
toJSON()：它内部会自动调用各模型的toJson()，而后者默认会委托给toArray()，且对 null 和对象更健壮 - 对简单场景，用
Db::query()或Db::table()->field()->select()直接查数组，绕过模型层——适合只读、无业务逻辑的接口
性能提示：频繁重写 toArray() 并在里面做格式化，容易掩盖 N+1 查询问题；真正要优化的，是把关联加载和字段计算前置到查询阶段，而不是在转换时补救。
