ThinkPHP模型时间字段自动处理需五步协同：一、启用自动时间戳（$autoWriteTimestamp）；二、配置 createTime/updateTime 字段名；三、通过 $type 声明字段类型映射；四、确保时间字段未被 allowField 过滤；五、用修改器 setCreateTimeAttr 定制写入逻辑。
如果您在ThinkPHP中使用模型操作数据库，但时间字段未按预期自动写入或转换，则可能是由于模型配置、数据库字段定义与调用方式未协同一致。以下是设置时间字段自动处理的具体步骤：
一、启用模型自动时间戳功能
自动时间戳功能默认关闭，必须在模型类中显式启用，否则无论数据库字段如何定义，均不会触发自动赋值逻辑。该设置是整个时间字段自动处理的前提条件。
1、在模型类中添加 protected $autoWriteTimestamp = true; 语句。
2、若需指定时间格式（如仅存秒级时间戳），可设为 protected $autoWriteTimestamp = 'timestamp'; 或 protected $autoWriteTimestamp = 'datetime';。
立即学习“PHP免费学习笔记（深入）”；
3、确保该属性声明为 protected，不可使用 public 或未声明访问修饰符。
二、配置时间字段名称与映射关系
框架通过字段名匹配识别创建/更新时间字段，若数据库列名非标准命名（如 add_time、edit_time），必须在模型中显式声明对应关系，否则无法识别并写入。
1、设置创建时间字段名：protected $createTime = 'add_time';（请将 'add_time' 替换为实际数据库字段名）。
2、设置更新时间字段名：protected $updateTime = 'edit_time';（请将 'edit_time' 替换为实际数据库字段名）。
3、若完全不需要某字段自动写入，须设为布尔 false：protected $createTime = false; 和 protected $updateTime = false; —— 注意：必须是 false，不能是 null 或空字符串。
三、定义数据库字段类型映射
ThinkPHP 不会根据数据库实际类型自动推断 PHP 处理方式，必须通过 $type 属性手动声明字段类型，否则 datetime 字段读取后仍为字符串，无法调用 Carbon 方法。
1、在模型类中声明 protected $type 数组，键名为数据库字段名（不含表前缀），值为框架认可的类型标识。
2、对 DATETIME/TIMESTAMP 字段，写入 'create_time' => 'datetime'；读取时返回 Carbon 实例。
3、对 INT 类型存储的时间戳，写入 'create_time' => 'timestamp'；读取时返回整型秒级时间戳。
4、字段名必须与数据库列名完全一致（含大小写、下划线），且$type中键名不能带表前缀或别名。
四、确保时间字段未被字段白名单过滤
当使用 allowField(true) 或显式传入 field 参数时，若未包含时间字段名，模型将跳过其写入，导致字段为空或触发 NOT NULL 约束报错。
1、检查 save() 调用处是否传入了 field 限制，如 save($data, ['field' => ['name', 'status']]) —— 此时 create_time 将被排除。
2、若使用 allowField(true)，确认数据库表结构中确实存在对应的时间字段列名（如 create_time），框架仅校验字段存在性，不校验语义。
3、调试时可在 save() 前调用 dump($model->getData())，确认时间字段是否已生成并存在于数据数组中。
五、使用修改器（Mutator）定制写入逻辑
当标准自动时间戳无法满足业务需求（如仅在 create_time 为空时填充、或根据状态动态写入 disable_time），应使用修改器在写入前干预原始值。
1、在模型类中定义方法 setCreateTimeAttr，格式为 set + 字段名首字母大写 + Attr。
2、方法接收原始值（可能为 null），返回最终入库值，例如：return $value ?: date('Y-m-d H:i:s');
3、该修改器仅在 save()、create() 等模型方法中触发，where()->update() 或 Db::insert() 不会执行任何修改器逻辑。
