如何在Laravel中实现事件监听器并触发执行？

一、触发事件的核心操作 #

在业务逻辑发生的节点（比如用户注册完成、文章发布成功时），通过event()辅助函数或事件类的dispatch()方法触发对应事件。

1. 用户注册场景触发示例

在注册控制器完成用户创建后，触发UserRegistered事件：

// app/Http/Controllers/Auth/RegisterController.php
public function store(Request $request)
{
    $this->validator($request->all())->validate();
    $user = $this->create($request->all());

    // 方式1：使用event()辅助函数触发
    event(new \App\Events\UserRegistered($user));

    // 方式2：调用事件类的dispatch()方法（效果完全一致）
    // \App\Events\UserRegistered::dispatch($user);

    return redirect($this->redirectPath());
}

2. 文章发布场景触发示例

在文章创建/更新后，判断状态为发布时触发PostPublished事件：

// app/Http/Controllers/PostController.php
public function store(Request $request)
{
    $post = \App\Models\Post::create($request->validated());

    if ($post->status === 'published') {
        event(new \App\Events\PostPublished($post));
    }

    return redirect()->route('posts.show', $post);
}

二、事件与监听器的补充示例（供参考） #

事件类示例（UserRegistered）

事件类负责传递业务数据，需引入Dispatchable trait：

// app/Events/UserRegistered.php
namespace App\Events;

use Illuminate\Foundation\Events\Dispatchable;
use App\Models\User;

class UserRegistered
{
    use Dispatchable;

    public $user;

    // 构造函数接收需要传递给监听器的业务模型
    public function __construct(User $user)
    {
        $this->user = $user;
    }
}

队列监听器示例（SendWelcomeEmail）

如果需要异步执行任务，只需实现ShouldQueue接口：

// app/Listeners/SendWelcomeEmail.php
namespace App\Listeners;

use App\Events\UserRegistered;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Support\Facades\Mail;
use App\Mail\WelcomeEmail;

class SendWelcomeEmail implements ShouldQueue
{
    public function handle(UserRegistered $event)
    {
        // 执行发送欢迎邮件的逻辑
        Mail::to($event->user->email)->send(new WelcomeEmail($event->user));
        
        // 可添加日志验证执行情况
        \Illuminate\Support\Facades\Log::info("欢迎邮件已发送至：{$event->user->email}");
    }
}

事件与监听器注册（EventServiceProvider）

确保已在$listen数组中完成事件与监听器的绑定：

// app/Providers/EventServiceProvider.php
namespace App\Providers;

use Illuminate\Foundation\Support\Providers\EventServiceProvider as ServiceProvider;
use App\Events\UserRegistered;
use App\Listeners\SendWelcomeEmail;
use App\Events\PostPublished;
use App\Listeners\NotifyAdmins;

class EventServiceProvider extends ServiceProvider
{
    protected $listen = [
        UserRegistered::class => [
            SendWelcomeEmail::class,
        ],
        PostPublished::class => [
            NotifyAdmins::class,
        ],
    ];

    public function boot()
    {
        parent::boot();
    }
}

三、确保监听器执行的关键注意事项 #

1. 队列监听器需启动队列服务：如果监听器实现了ShouldQueue，必须运行队列worker才能处理异步任务：

   # 单次处理队列任务后退出（适合开发环境）
   php artisan queue:work
   
   # 持续监听队列任务（适合生产环境，需配合Supervisor等进程管理器）
   php artisan queue:listen
   

   本地开发可在.env中设置QUEUE_CONNECTION=sync，无需启动队列，监听器会同步执行。

2. 事件缓存刷新：修改EventServiceProvider后，可运行以下命令刷新事件缓存：

   php artisan event:clear
   php artisan event:cache
   

3. 执行验证：可通过查看storage/logs/laravel.log日志、数据库队列表（使用database驱动时）或实际业务效果（如是否收到邮件）验证监听器是否执行。

内容的提问来源于stack exchange，提问作者laravel sagmetic