Eloquent Attribute Time Events 并非 Laravel 官方概念，而是指通过 Accessor/Mutator 处理时间格式转换与时区调整，或借助模型事件（如 saving）实现时间校验、自动赋值等业务逻辑。
什么是 Eloquent Attribute Time Events？
这其实不是 Laravel 官方概念，而是开发者对「在模型属性读写时自动触发时间相关逻辑」的一种口语化描述。比如：读取 $user->last_login_at 时自动转成北京时间；保存 published_at 前强制设为当前时间；或在 created_at 被赋值时拦截并校验是否早于当前时刻。Laravel 并不提供叫 TimeEvents 的钩子，真正能用的是访问器（Accessors）、修改器（Mutators）和模型事件（creating、saving 等）。
用 Accessor/Mutator 处理读写时的时间转换
这是最轻量、最常用的方式，适合单字段、无副作用的格式转换或时区调整。
- 访问器（Accessor）在读取属性时触发，函数名必须是
get{ColumnName}Attribute，例如getPublishedAtAttribute - 修改器（Mutator）在设置属性时触发，函数名是
set{ColumnName}Attribute，例如setPublishedAtAttribute - 注意：数据库字段名是
published_at，但 accessor/mutator 中去掉下划线并驼峰首字母大写，且必须含Attribute后缀 - 如果字段本身是
datetime类型，Eloquent 默认会转成Carbon实例，直接调用format()或tz('Asia/Shanghai')即可，无需手动new Carbon()
示例：将数据库存储的 UTC 时间，在读取时自动转为东八区，并格式化为中文日期
public function getPublishedAtAttribute($value)
{
return $value ? $value->tz('Asia/Shanghai')->format('Y年m月d日 H:i') : null;
}
用模型事件实现带业务逻辑的时间干预
当需要在保存前做时间校验、联动更新其他时间字段、或调用外部服务时，模型事件比 accessor/mutator 更合适，因为它发生在数据库操作前/后，且可中断流程（通过 return false）。
立即学习“PHP免费学习笔记（深入）”；
- 常用事件：
creating（插入前）、updating（更新前）、saving（插入或更新前）、saved（成功后） - 在
boot()中注册，避免重复绑定；使用static::saving而非$this->saving - 修改属性值需直接操作
$model->attribute = ...，不能依赖 mutator——因为saving在 mutator 之后执行，此时值已处理完毕 - 若想在
saving中阻止保存（如发布时间未来超过 24 小时），直接return false
示例：发布文章时，若未填 published_at，自动设为当前时间；若已填，则确保不早于 created_at
protected static function boot()
{
parent::boot();
static::saving(function ($article) {
if (empty($article->published_at)) {
$article->published_at = now();
} elseif ($article->created_at && $article->published_at->lt($article->created_at)) {
return false; // 阻止保存
}
});
}
为什么不要在 Accessor 里改数据库、不要在 Mutator 里调 API
Accessor 和 Mutator 是纯数据转换层，设计上不承担副作用。一旦在里面写 $this->save() 或 Http::post()，会出现几个典型问题：
- 读取一个属性（比如
$post->title）意外触发数据库写入，违反直觉，调试困难 - 在循环中遍历模型集合时，每个
$post->published_at都发起 HTTP 请求，性能崩盘 - Laravel 的序列化（如 API 返回 JSON）会触发所有 accessor，导致不可控的副作用扩散
- 测试时难以 mock，因为逻辑被隐式耦合进属性访问
真正需要异步或持久化的时间逻辑，应拆到 Service 类、Job 或模型事件中，保持各层职责清晰。时间转换类逻辑放 Accessor/Mutator，带状态变更的放 Event 或 explicit method（比如 $post->publishNow()）。
