在ThinkPHP模型中，通过定义getFullnameAttr访问器可动态生成fullname等虚拟字段并自动参与toArray()输出，需配合$append配置；用setAddressAttr等修改器可将组合字段反向拆解为真实字段；查询时需用whereRaw或作用域绕过虚拟字段限制；避免在访问器中触发关联查询以防N+1问题。
当你需要在ThinkPHP模型中根据多个真实字段动态生成一个计算值（比如 fullname = first_name + last_name），又不想每次手动拼接、还要求这个值能自动参与序列化输出时，直接写逻辑容易漏掉空值处理或触发时机错误。
定义只读虚拟字段并自动参与toArray()
第一步：在模型中定义getFullnameAttr访问器，方法名必须严格匹配驼峰规则——数据库字段是first_name和last_name，组合字段叫fullname，就只能写getFullnameAttr，写成getFullNameAttr或getFull_nameAttr都会静默失效。
第二步：访问器函数接收两个参数，$value是fullname字段原始值（通常为null，因它不存库），$data是当前模型所有已加载字段组成的数组，必须从中取first_name和last_name：
public function getFullnameAttr($value, $data) {
return trim(($data['first_name'] ?? '') . ' ' . ($data['last_name'] ?? ''));
}
立即学习“PHP免费学习笔记（深入）”；
第三步：让fullname出现在toArray()结果里，不能靠默认行为——模型默认只输出真实字段。必须显式用append追加，或在模型类中声明protected $append = ['fullname'];。注意：$append只影响读取，不参与任何写入流程，也绝不触发setXxxAttr。
用修改器反向推导并自动填充真实字段
方法一：当表单提交的是完整地址字符串，但数据库要拆成province/city/district三字段时，不能靠前端分好再传，而应在模型层拦截处理。
在模型中定义setAddressAttr，注意这里address是表单传入的字段名，不是数据库字段：
protected function setAddressAttr($value, $data) {
if (empty($value)) return $data;
$parts = explode(' ', $value, 3);
return [
'province' => $parts[0] ?? '',
'city' => $parts[1] ?? '',
'district' => $parts[2] ?? '',
];
}
这一步的关键在于：返回值必须是关联数组，键名对应真实数据库字段，且该数组会直接合并进待写入数据。但【必须确保模型未开启strict模式，否则未声明的province/city/district会被过滤】。
方法二：若数据库已有province/city/district字段，且它们在$schema中明确定义，则无需 setAddressAttr，改用setProvinceAttr/setCityAttr等分别处理——更可控，也避免单个修改器承担过多职责。
组合字段参与查询条件的绕过方案
虚拟字段fullname无法直接用于where('fullname', 'like', '%zhang%')，因为SQL不识别它。此时需用Db::raw构造底层表达式：
User::whereRaw("concat(ifnull(first_name,''), ' ', ifnull(last_name,'')) like ?", ['%zhang%'])->select();
或者更稳妥地，在模型中封装一个作用域scopeSearchFullname：
public function scopeSearchFullname($query, $keyword) {
$query->whereRaw("concat(ifnull(first_name,''), ' ', ifnull(last_name,'')) like ?", ["%{$keyword}%"]);
}
调用时直接User::searchFullname('zhang')->select()，语义清晰且复用性强。注意：这种写法绕过了所有获取器逻辑，拿到的是原始数据库值，所以空值处理必须在SQL里做（ifnull）。
防止多字段组合时的N+1陷阱
第一步：绝对禁止在getFullnameAttr里调用$this->department->name这类关联查询。访问器执行时机在每条记录解析时，会引发严重性能问题。
第二步：如需拼接部门名称，必须提前预加载。在查询处统一用with('department')，并在访问器中通过$data['department']['name']安全取值：
public function getFullnameAttr($value, $data) {
$deptName = $data['department']['name'] ?? '';
return trim(($data['first_name'] ?? '') . ' ' . ($data['last_name'] ?? '') . '（' . $deptName . '）');
}
第三步：确保控制器查询时已主动加载关联，例如User::with('department')->select()。没with就直接读$data['department']会得到null，不会报错但结果异常。
