ThinkPHP模型批量添加虚拟字段需用append()声明字段名并配合对应getAttrNameAttr()访问器，否则toArray()不输出；TP8 stricter校验访问器存在性且优先级visible>append>hidden。
ThinkPHP 模型里怎么批量加虚拟字段（非数据库字段）
不能直接写 $model->attr1 = 'x'; $model->attr2 = 'y' 就完事——这样赋值后，toArray() 或 JSON 输出时默认不包含，save() 时还可能报错或静默丢弃。
核心方法是用 append()，但它不是“追加到数据里”，而是“声明哪些字段要被序列化进去”。必须配合 getAttrNameAttr() 访问器或 setAttrNameAttr() 修改器才能真正生效。
-
append()只接受字段名数组，比如['full_name', 'is_vip']，不能传值 - 字段名必须和访问器方法名前缀一致：想 append
full_name，就得定义getFullNameAttr() - 模型实例化后调用
append()才生效，定义在模型类里无效（别往protected $append = [...]里瞎塞运行时才有的字段） - 如果字段名含下划线（如
user_status），访问器必须用驼峰：getUserStatusAttr()
为什么 append(['xxx']) 后 toArray() 还没值
因为 append() 只是注册字段名，不触发计算；访问器方法没被调用，自然没值。常见错误是只写 $model->append(['score_level'])->toArray()，但忘了 score_level 对应的 getScoreLevelAttr() 根本没定义，或者返回了 null / 空字符串而没注意。
- 检查访问器是否真存在，方法名大小写、下划线转驼峰是否准确（
last_login_time→getLastLoginTimeAttr()） - 访问器里别直接 return $this->xxx，那会递归死循环；要用
$this->getData('xxx')或$this->getAttribute('xxx') - 如果字段依赖其他模型关联数据，确保关联已预载入（
with('user')），否则访问器里查库会 N+1 -
append()必须在toArray()/toJson()前调用，链式写法没问题：$model->append(['x'])->toArray()
批量设置虚拟字段值（绕过访问器）的危险操作
有人试过 $model->setData(['a' => 1, 'b' => 2]) 或直接 $model->a = 1，再 append(['a', 'b']) —— 这样 toArray() 是能出值，但隐患很大：
立即学习“PHP免费学习笔记（深入）”；
-
setData()会覆盖原始数据，包括主键、时间戳等关键字段，save()可能更新错记录 - 直接赋值的字段不会走验证、修改器、类型转换，比如你设
$model->price = '19.90'，但 price 字段是 float 类型，后续运算可能出错 - JSON 序列化时字段顺序不可控，且无法统一做格式处理（如时间转 Y-m-d）
- 真正安全的做法：老老实实写访问器，哪怕只是
return $this->getData('real_field') * 100;
TP6 和 TP8 在虚拟字段上的关键差异
TP8 把 append() 的行为收紧了：如果字段没定义访问器，即使你强行 append(['xxx'])，toArray() 也不再兜底返回 null，而是彻底忽略——TP6 还会返回 null，容易掩盖问题。
- TP8 中，
append()后字段没值，第一反应不是数据没传对，而是访问器缺失或命名错误 - TP8 支持在访问器里用
$this->originData获取原始数据，比 TP6 的$this->data更安全（避免污染） - TP8 的
hidden和visible与append()共存时，优先级是visible>append>hidden，别以为 append 能绕过 hidden
虚拟字段看着简单，但跨版本、跨场景时，访问器是否存在、是否被调用、是否污染原始数据，这三处最容易漏查。
