如何设置ThinkPHP模型中不存库但可返回的字段虚拟属性？

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

在ThinkPHP框架中，获取字段值时，通常使用`getAttr`方法。此方法主要用于读取数据库中字段的值。它仅处理设置操作，不涉及读取操作。若数据库中不存在该字段，则会触发异常。

正确的方法是使用`getXxxAttr`方法，其中`xxx`代表字段名。例如，如果字段名为`full_name`，则使用`getFullNameAttr`方法。这种方法在数据库中找不到对应字段时会返回`null`，从而避免异常。

常见错误是把逻辑写在 setFullNameAttr 里，结果调用 $model->full_name 时返回 null 或原始字段值，因为压根没走读取逻辑。

• getAttr 方法名必须严格匹配“驼峰字段名 + Attr”，如数据库字段为 user_id，虚拟字段想叫 userName，就得写 getUserNameAttr
• 方法参数固定是 $value, $data，其中 $data 是当前模型所有原始数据（含关联查询结果），别漏掉它
• 返回值会直接覆盖字段访问结果，不校验类型，也不触发验证或自动转换

虚拟字段不入库但要参与 JSON 输出的坑

ThinkPHP 默认把所有 public 属性和可读字段都塞进 toArray() 和 JSON 序列化结果里，但虚拟字段如果没被显式“读过”，getAttr 不会自动执行，导致 JSON 里字段缺失或为 null。