想让 ThinkPHP 自动帮你写好 create_time 和 update_time?直接改数据库配置文件确实是最省事的方式——但前提是,你得把配对、匹配、不遗漏这三件事做全,否则“省事”就变成“查半天”。
一、database.php 里只改这一项
打开 config/database.php,找到 'auto_timestamp' 这一行,配置其实很简单:
- 设为
true:自动写入整型时间戳(int类型字段) - 设为
'datetime':自动写入Y-m-d H:i:s格式字符串(对应DATETIME或TIMESTAMP字段) - 设为
false或删掉该配置:全局关闭,模型级配置才起作用
这里有个坑需要注意:'auto_timestamp' => 'datetime' 必须搭配数据库字段类型为 DATETIME 或 TIMESTAMP;如果你字段是 INT 却配成 'datetime',写入就会失败,或者存成空值,查半天都查不出原因。
二、字段名和类型必须提前对齐
全局配置不认自定义字段名,默认只处理 create_time 和 update_time。所以,数据库表里必须真实存在这两个字段,名字大小写、下划线一个都不能错。字段类型要和 auto_timestamp 值一致:
true→ 字段类型为INT'datetime'→ 字段类型为DATETIME或TIMESTAMP
另外,字段允许为 NULL,或设默认值(如 CURRENT_TIMESTAMP),避免严格模式下插入报错。这些小细节,一个都不能漏。
三、用对方法,不然白配
自动写入这个小家伙,只认模型操作,不认 Db 类:
- ✅ 正确:
$user = new User(); $user->name = 'xxx'; $user->sa ve(); - ❌ 无效:
Db::name('user')->insert(['name' => 'xxx']);—— 完全绕过模型,时间字段不会自动填
如果你用了 allowField(),记得时间字段得在白名单里,否则会被过滤掉。这个细节很容易被忽略,但偏偏是新手最容易踩的坑。
四、不想全局开?那就关掉它
当然,如果你不想全局开启,或者部分表没有时间字段,建议:
- 把
database.php中的'auto_timestamp'设为false或注释掉 - 只在具体模型里启用:
protected $autoWriteTimestamp = true;,再配字段名 - 这样更安全,避免新增表漏建时间字段导致插入失败
话说回来,这种方式虽然多了一步配置,但灵活性和可控性都更强,适合项目规模较大的场景。