laravel如何利用模型事件(Model Events)触发动作_Laravel模型事件触发动作方法-Laravel-PHP中文网

laravel如何利用模型事件(Model Events)触发动作_Laravel模型事件触发动作方法

裘德小鎮的故事

发布： 2025-10-02 23:35:02

原创

266人浏览过

Laravel模型事件可在Eloquent模型生命周期中触发自定义逻辑，如创建、更新、删除等操作。1. 内置事件包括retrieved、creating/created、updating/updated、saving/saved、deleting/deleted及软删除恢复相关事件，适用于日志记录、通知发送和缓存清理等场景。2. 可在模型的boot方法中直接注册事件回调，适合简单逻辑，例如创建后记录日志、更新后清除缓存、删除时移除关联数据。3. 当逻辑复杂时推荐使用观察者模式，通过artisan命令生成观察者并在AppServiceProvider中注册，将处理逻辑分离到独立类中，提升可维护性与测试便利性。4. 常见应用场景包括操作审计、缓存管理、消息通知、级联删除和搜索索引同步。根据项目规模选择回调或观察者模式，核心是将副作用逻辑从控制器解耦，交由模型事件统一处理。

laravel如何利用模型事件(model events)触发动作_laravel模型事件触发动作方法

Laravel 的模型事件（Model Events）允许你在 Eloquent 模型生命周期的特定时刻自动执行某些操作，比如创建、更新、删除或查询时触发自定义逻辑。通过合理使用模型事件，你可以解耦业务代码，提升可维护性。

1. 什么是 Laravel 模型事件

Eloquent 提供了多个内置事件，可在模型状态变化时被监听：

retrieved：从数据库获取记录后触发
creating / created：插入前/插入后触发
updating / updated：更新前/更新后触发
saving / saved：保存前/保存后（包括新增和更新）
deleting / deleted：删除前/删除后
restoring / restored：软删除恢复过程中触发

这些事件可用于记录日志、发送通知、缓存清理等场景。

2. 在模型中直接使用事件回调

最简单的方式是在模型的 boot 方法中注册事件监听：

立即进入“豆包AI人工智官网入口”；

立即学习“豆包AI人工智能在线问答入口”；

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）分离逻辑

当事件处理逻辑变复杂时，推荐使用观察者模式来保持模型干净。

豆包大模型

字节跳动自主研发的一系列大型语言模型

834

查看详情

生成观察者：

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();
        }
    }
}

登录后复制

观察者让事件处理更清晰，便于测试和维护。