事件系统用于解耦业务逻辑，如用户注册后发送邮件。1. 创建userregistered事件类传递用户数据；2. 创建sendwelcomeemail监听器处理发邮件逻辑；3. 在config/event.php中绑定事件与监听器；4. 使用event::trigger()触发事件；5. 监听器可返回false阻止后续执行；6. 实现shouldqueue接口支持异步队列。合理使用可提升可维护性，避免逻辑分散。
ThinkPHP 的事件（Event）和监听器（Listener）机制是一种解耦代码、实现模块化开发的好方式。通过事件系统，你可以在不修改原有逻辑的前提下，动态添加额外功能，比如用户注册后发送邮件、记录日志等。
1. 创建事件
事件是一个标识，代表某个动作发生了。比如“用户注册成功”可以定义为一个事件。
在 ThinkPHP 中，事件通常只是一个类名，不需要继承特定类（但建议命名清晰）。
示例：创建一个用户注册成功的事件在 app/event/UserRegistered.php 中：
立即学习“PHP免费学习笔记（深入）”；
<?php
namespace app\event;
use app\model\User;
class UserRegistered
{
public $user;
public function __construct(User $user)
{
$this->user = $user;
}
}
2. 创建监听器
监听器是具体执行逻辑的地方。当某个事件被触发时，对应的监听器会被调用。
使用命令行生成监听器（推荐）：
php think make:listener SendWelcomeEmail
生成的文件位于 app/listener/SendWelcomeEmail.php：
<?php
namespace app\listener;
use app\event\UserRegistered;
class SendWelcomeEmail
{
public function handle(UserRegistered $event)
{
// 获取事件中的用户对象
$user = $event->user;
// 模拟发送欢迎邮件
echo "已向用户 {$user->email} 发送欢迎邮件";
}
}
3. 绑定事件与监听器
需要告诉框架哪个事件由哪些监听器处理。可以在 app/provider.php 或者通过配置文件绑定。
在 config/event.php 中添加绑定关系：
'bind' => [
'UserRegistered' => [
'SendWelcomeEmail',
// 可以添加多个监听器
// 'LogUserRegistration',
]
],
或者使用类名完整绑定：
'bind' => [
\app\event\UserRegistered::class => [
\app\listener\SendWelcomeEmail::class,
],
],
4. 触发事件
在业务逻辑中触发事件，比如用户注册完成后：
use think\facade\Event; use app\event\UserRegistered; // 假设 $user 是刚注册的用户模型 Event::trigger(new UserRegistered($user));
这样所有绑定到 UserRegistered 事件的监听器都会被执行。
也可以使用静态方法：
Event::dispatch(new UserRegistered($user));
5. 监听器返回值与停止传播
如果某个监听器返回 false，会中断后续监听器的执行：
public function handle(UserRegistered $event)
{
if (!$event->user->email) {
return false; // 停止其他监听器运行
}
// 发送邮件逻辑...
}
6. 异步监听（高级用法）
ThinkPHP 支持将某些监听器设置为异步执行（需配合队列），适合耗时操作如发邮件、推送消息。
只需让监听器实现 think\contract\ShouldQueue 接口：
use think\contract\ShouldQueue;
class SendWelcomeEmail implements ShouldQueue
{
public function handle(UserRegistered $event)
{
// 这个方法将被放入队列异步执行
}
}
基本上就这些。ThinkPHP 的事件系统简单灵活，合理使用能显著提升项目可维护性。关键是把事件当作“通知”，监听器负责响应，做到低耦合。实际开发中注意别滥用，避免逻辑分散难追踪。
