Laravel模型事件可在Eloquent模型生命周期中触发自定义逻辑，如创建、更新、删除等操作。1. 内置事件包括retrieved、creating/created、updating/updated、saving/saved、deleting/deleted及软删除恢复相关事件，适用于日志记录、通知发送和缓存清理等场景。2. 可在模型的boot方法中直接注册事件回调，适合简单逻辑，例如创建后记录日志、更新后清除缓存、删除时移除关联数据。3. 当逻辑复杂时推荐使用观察者模式，通过artisan命令生成观察者并在AppServiceProvider中注册，将处理逻辑分离到独立类中，提升可维护性与测试便利性。4. 常见应用场景包括操作审计、缓存管理、消息通知、级联删除和搜索索引同步。根据项目规模选择回调或观察者模式，核心是将副作用逻辑从控制器解耦，交由模型事件统一处理。
Laravel 的模型事件（Model Events）允许你在 Eloquent 模型生命周期的特定时刻自动执行某些操作，比如创建、更新、删除或查询时触发自定义逻辑。通过合理使用模型事件，你可以解耦业务代码，提升可维护性。
1. 什么是 Laravel 模型事件
Eloquent 提供了多个内置事件，可在模型状态变化时被监听：
- retrieved：从数据库获取记录后触发
- creating / created：插入前/插入后触发
- updating / updated：更新前/更新后触发
- saving / saved：保存前/保存后（包括新增和更新）
- deleting / deleted：删除前/删除后
- restoring / restored：软删除恢复过程中触发
这些事件可用于记录日志、发送通知、缓存清理等场景。
2. 在模型中直接使用事件回调
最简单的方式是在模型的 boot 方法中注册事件监听：
class Article extends Model
{
protected static function boot()
{
parent::boot();
static::created(function ($article) {
\Log::info("新文章已创建: {$article->title}");
});
static::updated(function ($article) {
\Cache::forget("article_{$article->id}");
});
static::deleted(function ($article) {
// 删除相关评论
$article->comments()->delete();
});
}
}
这种写法适合逻辑简单、仅与当前模型相关的操作。
3. 使用观察者（Observers）分离逻辑
当事件处理逻辑变复杂时，推荐使用观察者模式来保持模型干净。
生成观察者：
php artisan make:observer ArticleObserver --model=Article
注册观察者： 在 AppServiceProvider 中：
use App\Models\Article;
use App\Observers\ArticleObserver;
public function boot()
{
Article::observe(ArticleObserver::class);
}
编写观察者逻辑：
class ArticleObserver
{
public function created(Article $article)
{
\Mail::to($article->author->email)->send(
new NewArticlePublished($article)
);
}
public function updating(Article $article)
{
if ($article->isDirty('status') && $article->status === 'published') {
$article->published_at = now();
}
}
}
观察者让事件处理更清晰，便于测试和维护。
4. 常见应用场景
- 日志记录：用户操作、数据变更审计
- 缓存管理：模型更新后清除对应缓存
- 消息通知：订单创建后发送邮件或短信
- 关联清理：主模型删除时级联删除子数据
- 搜索索引同步：配合 Scout 更新 Algolia 或 Meilisearch
基本上就这些方法，根据项目规模选择直接回调或观察者模式即可。关键是把副作用逻辑从控制器中剥离出来，交给模型事件统一管理。
