Laravel Eloquent模型可自定义时间戳:一、设$timestamps=false禁用;二、重写CREATED_AT/UPDATED_AT常量改字段名;三、设其一为null启用单时间戳;四、重写updateTimestamps()动态控制;五、手动赋值跳过自动填充。

如果您在Laravel中使用Eloquent ORM操作数据库,但希望模型的时间戳字段不使用默认的created_at和updated_at,而是采用自定义字段名或禁用时间戳功能,则需要调整模型的时间戳行为。以下是实现模型时间戳自定义的具体步骤:
一、禁用时间戳功能
当模型不需要自动维护任何时间戳字段时,可通过设置$timestamps属性为false来完全关闭该机制。此方式适用于日志表、中间表或第三方同步数据等无需记录创建/更新时间的场景。
1、打开对应模型文件,例如app/Models/User.php。
2、在类定义内部添加protected $timestamps = false;语句。
3、保存文件后,Eloquent将不再尝试写入或更新created_at与updated_at字段。
二、自定义时间戳字段名称
若需保留时间戳逻辑但使用不同字段名(如add_time和edit_time),可通过重写CREATED_AT和UPDATED_AT常量实现。Eloquent会依据这两个常量识别并自动填充对应字段。
1、在模型类中声明public const CREATED_AT = 'add_time';。
2、在模型类中声明public const UPDATED_AT = 'edit_time';。
3、确保数据库表中存在add_time和edit_time字段,且类型兼容(如DATETIME或TIMESTAMP)。
4、执行create()或save()操作时,Eloquent将自动向add_time和edit_time写入当前时间。
三、仅启用单一时间戳字段
某些业务场景下只需记录创建时间而无需更新时间(如归档记录),或反之。此时可将其中一个常量设为null,使Eloquent跳过对该字段的处理。
1、若仅需created_at逻辑,在模型中添加public const UPDATED_AT = null;。
Laravel Cloud(cloud.laravel.com)。此技能用于处理所有 Laravel Cloud 请求,包括搜索和读取数据。只要任务涉及 Laravel Cloud,即使用此技能。
2、若仅需updated_at逻辑,在模型中添加public const CREATED_AT = null;。
3、注意:设置为null后,对应字段不会被自动写入,但手动赋值仍可正常保存到数据库。
四、动态控制时间戳写入行为
通过重写updateTimestamps()方法,可在运行时决定是否写入时间戳。该方法在模型保存前被调用,允许根据条件跳过默认赋值逻辑。
1、在模型类中定义protected function updateTimestamps() {}方法。
2、在方法体内添加条件判断,例如if ($this->shouldUpdateTimestamps === false) { return; }。
3、在业务逻辑中提前设置$this->shouldUpdateTimestamps = false;以临时禁用时间戳更新。
4、调用save()时,Eloquent将跳过对CREATED_AT和UPDATED_AT字段的自动赋值。
五、使用Carbon实例自定义时间戳值
当需要为时间戳字段赋予特定时间(如导入历史数据时指定创建时间),可直接为CREATED_AT和UPDATED_AT对应的属性赋值,Eloquent将跳过自动覆盖。
1、实例化模型对象后,显式设置模型实例->add_time = '2022-01-01 10:00:00';(假设已自定义字段名为add_time)。
2、调用save()方法前,确保未启用自动时间戳或已将$timestamps设为false。
3、Eloquent将把指定字符串或Carbon实例写入对应字段,而非使用当前系统时间。

















