如何设置ThinkPHP模型中的时间戳字段？

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

在ThinkPHP中使用模型保存数据时，若发现`createTime`或`updateTime`字段未自动写入，可能是时间戳功能未启用或字段配置不匹配。以下是解决此问题的步骤：

一、启用模型自动时间戳功能

ThinkPHP默认关闭模型级自动时间戳，必须显式开启才能触发字段自动写入行为。该设置优先于全局配置，且仅对当前模型生效。

1、在模型类中添加 protected 属性：$autoWriteTimestamp = true;

2、若需指定时间格式（如 datetime 而非 int），可设为：$autoWriteTimestamp = 'datetime';

立即学习“PHP免费学习笔记（深入）”；

3、确认该模型未继承自禁用时间戳的父类，且未被中间件或钩子动态关闭时间戳写入。

二、自定义时间戳字段名

当数据库表中时间字段名不是默认的 create_time 和 update_time 时，必须在模型中精确声明对应字段名，框架不会自动转换驼峰或下划线命名。

1、若数据库字段为 _createTime，则模型中写：protected $createTime = '_createTime';

2、若数据库字段为 create_at，则模型中写：protected $createTime = 'create_at';

3、若仅需更新时间而无需创建时间，可设：protected $createTime = false;

4、字段名必须与数据库列名完全一致，包括大小写、下划线、前缀等，否则写入将静默失败。

三、检查字段是否被 allowField 过滤

时间戳字段属于非表单数据，在调用 save() 时若传入 field 参数或启用 allowField(true)，可能导致时间字段被排除在外，从而无法写入。

1、检查 save() 调用处是否包含类似 ['field' => ['id', 'name']] 的显式字段限制。

2、若使用 allowField(true)，确认数据库实际结构中存在所配置的时间戳字段名（如 _createTime），否则框架校验失败后跳过写入。

3、调试时可在 save() 前打印 $model->getData()，验证 _createTime 等字段是否已生成并存在于数据数组中。

四、确保使用模型 save() 方法而非 Db::insert()

自动时间戳功能仅在模型的 save()、saveAll() 等方法中生效；通过 Db 类直接执行 insert() 或 execute() 不会触发模型时间戳逻辑。

1、正确方式：$user->save(['name' => 'test']);

2、错误方式：Db::name('user')->insert(['name' => 'test']);

3、若必须使用 Db 类操作，需手动赋值时间字段，例如：'create_time' => date('Y-m-d H:i:s')。

五、验证数据库字段类型与配置一致性

时间戳字段类型需与模型或数据库配置中的 auto_timestamp 类型匹配，否则可能写入失败或格式异常。

1、若数据库字段为 DATETIME 类型，应在模型或 database.php 中设：$autoWriteTimestamp = 'datetime';

2、若数据库字段为 INT 类型，保持默认配置即可，但需确保未在模型中误设 type 映射导致字符串写入。

3、若使用 INT 类型却配置为 'datetime'，会导致入库值为字符串 '2026-04-25 20:14:00'，引发数据库报错或截断。