信息发布→ 登录 注册 退出

Laravel如何实现事件和监听器?(Event & Listener实战)

发布时间:2025-12-15

点击量:
Laravel事件与监听器机制用于解耦业务逻辑,通过定义事件类、创建监听器、注册关系及触发事件四步实现;事件为数据载体,监听器处理逻辑,需在EventServiceProvider中配置映射,并确保EventServiceProvider已注册。

Laravel 的事件与监听器机制,是解耦业务逻辑、响应系统动作的常用方式。它不是“必须用”,但当某个操作需要触发多个后续行为(比如用户注册后发邮件、写日志、通知管理员),用事件+监听器比硬编码更清晰、更易维护。

1. 定义事件类

事件本质是一个普通 PHP 类,通常不带逻辑,只负责携带数据。运行命令生成:

php artisan make:event UserRegistered

生成的 UserRegistered.php 默认在 app/Events 目录下。你可以往里面加一个 public 属性,比如:

class UserRegistered
{
    public $user;

    public function __construct(User $user)
    {
        $this->user = $user;
    }
}

2. 创建监听器

监听器是真正干活的地方。生成命令:

php artisan make:listener SendWelcomeEmail --event=UserRegistered

生成的监听器位于 app/Listeners,Laravel 会自动把事件实例注入到 handle 方法中:

class SendWelcomeEmail
{
    public function handle(UserRegistered $event)
    {
        // $event->user 就是注册的用户对象
        Mail::to($event->user)->send(new WelcomeMail($event->user));
    }
}

3. 注册事件与监听器关系

打开 app/Providers/EventServiceProvider.php,在 $listen 数组里配对:

protected $listen = [
    Events\UserRegistered::class => [
        Listeners\SendWelcomeEmail::class,
        Listeners\LogUserRegistration::class,
        Listeners\NotifyAdmin::class,
    ],
];

配好之后,Laravel 启动时会自动绑定。你不需要手动触发绑定。

4. 触发事件

在业务代码里(比如控制器或服务类中),用 event() 辅助函数或 Event::dispatch()

  • event(new UserRegistered($user));
  • Event::dispatch(new UserRegistered($user));

只要事件被触发,所有注册的监听器就会按顺序执行(默认同步)。如果想异步执行,监听器需实现 ShouldQueue 接口,并确保队列服务已配置。

基本上就这些。不复杂但容易忽略的是:别忘了在 config/app.php 中确认 App\Providers\EventServiceProvider::class 已在 providers 数组里注册——新项目默认已有,老项目升级或手动搭建时可能漏掉。

标签:# 事件  # 已在  # 你可  # 你不  # 已有  # 多个  # 就会  # 组里  # 是一个  # 的是  # 绑定  # 异步  # php  # Event  # public  # class  # 接口  # red  # 用户注册  # ai  # app  # 编码  # laravel  
在线客服
服务热线

服务热线

4008888355

微信咨询
二维码
返回顶部
×二维码

截屏,微信识别二维码

打开微信

微信号已复制,请打开微信添加咨询详情!