如何使用ThinkPHP模型访问器格式化输出复杂多维数组？

本文共计983个文字，预计阅读时间需要4分钟。

ThinkPHP 模型访问器本身不处理多维数组的输出格式化，它仅对单个字段值生效；所谓格式化多维数组，实际上是将 `toArray()`、`toJson()` 或模板中嵌套的输出转化为访问器职责。

访问器_getAttr 只作用于模型自身字段，不递归处理关联数据

常见错误是给主模型定义了 getProfileAttr，期望它能自动格式化关联模型 Profile 的字段（比如 profile.name），结果发现 $model->profile->name 仍是原始值。

• 访问器只在读取当前模型的字段时触发，$model->profile 返回的是另一个模型实例，它的字段走的是 Profile 类自己的访问器
• 若想 profile.name 也格式化，必须在 Profile 模型里定义 getNameAttr
• $model->append(['profile']) 只把关联模型整个对象附加进来，不会自动调用其内部字段的访问器——除非你在 Profile 里也写了对应方法

多维数组输出靠 toArray() / toJson()，但访问器是否执行取决于调用方式

toArray() 和 toJson() 默认会触发当前模型字段的访问器，但有严格前提：

• $model->toArray()：触发本模型所有字段的 getAttr，包括 append 添加的动态属性（如 getFullNameAttr）
• $model->hidden(['status'])->toArray()：被隐藏的字段不触发访问器，也不出现在结果中
• $model->getData()：TP5.1 中完全绕过访问器；TP6 起才支持触发，但仅限显式字段名（$model->getData('status')）
• $model->toJson() 底层调用 toArray()，所以行为一致；但注意浮点数精度、Carbon 对象默认序列化为时间戳等问题

模板中输出多维结构，访问器只在最内层字段生效

ThinkPHP 模板引擎支持 {$user.profile.name} 这种链式写法，但它本质是依次调用：

立即学习“PHP免费学习笔记（深入）”；

• $user->profile → 触发 User 模型的 getProfileAttr（如果定义了）
• $user->profile->name → 触发 Profile 模型的 getNameAttr（如果定义了）
• 中间任意一环没定义访问器，就返回原始值
• <volist name="list" id="user"></volist> 循环里的 {$user.profile.name} 同理，逐层触发

想统一格式化整个数组结构？别依赖访问器，重写 toArray()

访问器是字段粒度的，无法控制键名大小写、嵌套层级遍历或全局类型转换。真要让所有输出（含关联）都转小写、加前缀、过滤空值，得覆盖基类的 toArray()：

public function toArray() { $data = parent::toArray(); // 递归处理所有关联（需判断是否为 Model 实例） foreach ($data as $key => $value) { if ($value instanceof Model) { $data[$key] = $value->toArray(); } } return array_change_key_case($data, CASE_LOWER); }

注意：这种写法会让所有子模型（包括关联）都走同一套逻辑，但前提是它们都继承自该基类；第三方模型或未继承的，仍需单独处理。

最容易被忽略的一点：访问器命名错一个字母、大小写差一点，或方法没声明为 public，它就彻底静默失效——连 warning 都不报。调试时优先 dump 模型属性本身，而不是直接看 toArray() 结果。