ThinkPHP中Model的append属性_追加计算字段到输出数组【技巧】

ThinkPHP 的 `$append` 属性，说白了就是一个开关——它用来配合访问器（获取器）触发计算逻辑。但有个前提：这个开关只在模型实例被正确序列化时才会生效，比如调用 `toArray()`、`toJson()` 或者 API 自动转换。而且，每个你追加的字段，都必须有一个对应命名的 `getXXXAttr()` 方法等着它，否则就是白搭。

很多新手以为 `$append` 里写个字段名就能自动出值，其实远没那么简单。它本质上是一个触发机制，让你能在模型输出时动态计算一些额外信息。但坑也不少，我们来逐一拆解。

字段名和获取器必须严格配对

比如你想追加一个 `full_name` 字段，那就得在模型里做两件事：

• 在 `protected $append = ['full_name'];` 中声明字段名（注意是字符串，小写加下划线）
• 同时提供方法 `public function getFullNameAttr($value, $data)`（驼峰命名，`Attr` 结尾）
• 方法内部建议优先读取 `$data['first_name']` 和 `$data['last_name']`，而不是直接 `$this->first_name`——后者可能触发其他获取器，造成不必要的性能损耗
• 返回值必须明确，哪怕只是空字符串：`return $data['first_name'] . ' ' . ($data['last_name'] ?? '');`

配对错误是最常见的翻车点，字段名和方法名差一个字母都不行。

注意数据来源是否走模型流程

直接用 `Db::table()->select()` 或 `query()->execute()` 得到的是原生数组，压根不会触发任何获取器，`$append` 自然毫无效果。所以要注意：

• 必须用模型查询：`UserModel::select()` 或 `UserModel::find(1)` 才行
• 集合（Collection）默认不会自动执行 `$append`，需要显式调用 `$list->toArray()`
• 分页对象（如 `Paginator`）也得对 `$list->items()` 或整个结果调用 `toArray()`，否则追加字段不会出现

避免性能陷阱：别在获取器里查库或发请求

每个追加字段都会在每条记录的 `toArray()` 过程中单独执行一次获取器。假设有 100 条数据，你又加了 3 个 `$append` 字段——那就意味着 300 次函数调用。如果在获取器里再搞个数据库查询，后果可想而知。

• 绝对禁止在 `getXXXAttr()` 里写 `User::find()`、`Db::name()->where()->value()` 等数据库操作
• 如果依赖关联数据，必须提前用 `with('profile')` 预加载，然后在获取器里通过 `$this->profile?->title` 来获取
• 时间格式化、字符串拼接、状态映射这类纯计算逻辑是安全的，可以放心用

静态属性 vs 实例方法：用对场景才不丢字段

`protected $append = [...]` 是全局默认设置，所有 `toArray()` 调用都会生效。而 `$model->append([...])` 是单次覆盖，会清空之前所有追加项。所以：

• 通用字段（比如 `create_time_text`）适合写在模型静态属性里，一劳永逸
• 接口级临时字段（比如仅详情页需要的 `is_fa vorited`）应该用实例方法：`$user->append(['is_fa vorited'])->toArray()`
• 想叠加字段？得手动合并：`$user->append(array_merge($user->getAppend(), ['new_field']))`

搞清楚这些，`$append` 才能真正帮你写出干净、高效的代码。