thinkphp 6.x 用 $insert/$update/$auto 替代旧版 _auto,仅模型 save() 流程生效;需严格匹配 set{field}attr 方法名与小写字段,避免直连查询构造器导致失效。

ThinkPHP 的自动完成(_auto)在 5.0+ 版本中已被彻底移除,直接照搬旧版文档配置 _auto 数组会完全失效 —— 不报错、不执行、字段原样入库。
ThinkPHP 6.x 怎么实现字段自动填充
新版统一使用模型的 protected $auto、protected $insert 和 protected $update 三个数组控制字段写入逻辑,本质是“写入前自动赋值”,不是“提交前钩子”。
-
$auto:新增和更新时都生效(慎用,比如update_time不该在新增时写) -
$insert:仅 INSERT 时触发,适合create_time、status默认值等 -
$update:仅 UPDATE 时触发,最常用的是update_time
示例:
class User extends Model
{
protected $insert = ['create_time', 'status'];
protected $update = ['update_time'];
protected function setCreateTimeAttr()
{
return date('Y-m-d H:i:s');
}
protected function setUpdateTimeAttr()
{
return date('Y-m-d H:i:s');
}
protected function setStatusAttr()
{
return 1;
}
}
注意:方法名必须是 set{Field}Attr 格式,且字段名需为小写(即使数据库是 create_time,方法也要叫 setCreateTimeAttr)。
为什么写了 $insert 却没生效
常见原因不是配置错,而是调用方式绕过了模型写入流程:
- 用了
User::where(...)->update([...])—— 这是查询构造器直连数据库,跳过模型事件和自动填充 - 用了
User::strict(false)->save($data)但$data里已含create_time字段 —— 模型发现字段已存在,就不会再调用setCreateTimeAttr - 字段未在
$schema或$type中声明,且开启了严格模式(strict => true),导致字段被过滤
验证是否走模型流程:在 setCreateTimeAttr 里加 trace('hit create'),看日志有没有输出。
时间字段自动填充的兼容写法
单纯用 date() 在高并发下可能撞秒,且无法利用数据库默认值能力。更稳妥的方式:
- 数据库字段设默认值:
create_time DATETIME DEFAULT CURRENT_TIMESTAMP - 模型中只配
$insert = ['create_time'],但方法返回null,让数据库兜底 - 或改用
time()+date('Y-m-d H:i:s', time())避免时区偏差(确认date_default_timezone_set()已设为中国时区)
特别注意:MySQL 5.6+ 才支持 DATETIME 类型的 CURRENT_TIMESTAMP 默认值;如果字段是 INT 存时间戳,模型方法应返回 time(),而非字符串。
自动完成 vs 自动验证 vs 事件,别混用
很多人想在自动填充里做数据校验(比如判断邮箱格式),这是错的:
-
$auto/$insert/$update只负责“赋值”,不处理“合法性” - 校验必须走
validate或ValidateRule,否则脏数据直接入库 - 复杂逻辑(如根据用户等级自动设 VIP 过期时间)建议用模型事件
beforeWrite,比属性设置器更可控
一个字段被多次赋值时(比如先在 $insert 里设了默认值,又在 save() 传参里给了值),最终以传参为准 —— 自动填充只是“兜底”,不是“强制覆盖”。
自动填充看似简单,实际依赖模型完整生命周期;跳过 save() 改用查询构造器、或字段命名/大小写不一致,都会让它静默失效。调试时优先确认是不是真的进了模型的写入流程。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











