06.5.4.8 事件监听与广播
所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.5 PHP 后端 / 06.5.4 Laravel
覆盖范围
- 事件与监听器注册、订阅者与模型事件
- ShouldBroadcast、频道类型与私有授权
- 队列化广播、驱动差异与事务注意事项
基础事件注册概念见 06.5.1.1 框架架构与生命周期;本页聚焦事件与广播机制纵深。
06.5.4.8-001 事件类与监听器如何通过 Event::listen 注册?
一句话结论
Event::listen(事件类或名称, 监听器类/闭包) 把事件与处理逻辑登记到事件分发器;事件分发时按注册顺序调用匹配的监听器,监听器可由容器解析注入依赖。
概念解释
事件类携带数据,监听器负责响应。注册通常在服务提供者 boot 阶段完成;监听器类的 handle 方法接收事件实例,构造依赖由容器注入。
原理流程
- 定义事件类,公开属性承载数据。
- 提供者中
listen(Event::class, Listener::class)登记映射。 - 事件分发时分发器遍历匹配监听器。
- 容器解析监听器并调用 handle。
代码或图示
// 事件
class OrderCreated
{
public function __construct(public readonly Order $order) {}
}
// 注册
Event::listen(OrderCreated::class, SendOrderNotification::class);
// 监听器
class SendOrderNotification
{
public function handle(OrderCreated $event): void { /* ... */ }
}
常见误区
- 监听器 handle 形参类型与事件类不匹配:分发时类型提示无法赋值,方法不被正确调用。
- 在 register 阶段注册监听:虽可执行,但其他提供者监听尚未齐备,放 boot 更稳妥。
追问
- 一个事件能挂多个监听器吗?答:可以,按注册顺序依次调用;监听器间无直接返回值传递。
- 闭包监听器与类监听器如何选?答:简单逻辑用闭包;有依赖注入、队列化、复用需求用类监听器。
06.5.4.8-002 事件自动发现与订阅者(subscribe)两种注册方式有什么区别?
一句话结论
自动发现按命名约定把事件类映射到同名监听器,无需手写映射;订阅者在一个类内定义 subscribe 方法,绑定多个事件到多个处理方法,集中管理一组相关监听。
概念解释
- 自动发现:框架按监听器类名推断对应事件,需遵循命名约定(具体约定以当前版本文档为准)。
- 订阅者:实现订阅接口,
subscribe(Dispatcher $events)内用$events->listen配置方法映射。
原理流程
- 自动发现:生成/扫描监听类,按约定解析事件映射并缓存。
- 订阅者:类实现订阅契约,subscribe 方法登记事件 → 方法名。
- 分发器按两种来源合并监听器清单。
- 事件触发时调用对应处理方法。
代码或图示
class EventSubscriber implements Subscriber
{
public function subscribe(Dispatcher $events): array
{
return [
OrderCreated::class => 'onCreated',
OrderUpdated::class => 'onUpdated',
];
}
public function onCreated(OrderCreated $event): void { /* ... */ }
}
常见误区
- 订阅者方法名与映射不一致:事件触发时找不到处理方法。
- 自动发现依赖类名约定却随意命名:映射失败,事件无监听器响应。
追问
- 订阅者注册到哪里?答:在事件配置/提供者中登记订阅者类,分发器调用其 subscribe 完成绑定。
- 自动发现缓存何时刷新?答:监听清单编译进启动缓存,新增/改名监听器后需刷新事件缓存。
06.5.4.8-003 dispatch / event 分发事件的内部流程是什么?
一句话结论
分发事件时,分发器按事件名/类名匹配监听器清单,逐个解析监听器并调用处理方法;队列化监听器转入队列执行,同步监听器在当前请求内执行完毕后返回。
概念解释
event() 助手与 Event::dispatch 等价入口。分发流程区分监听器是否队列化:同步直接调用,队列化推入队列后异步处理。事件数据随事件实例传递。
原理流程
- 调用
event(new OrderCreated($order))。 - 分发器按类名/名称匹配监听器数组。
- 同步监听器:容器解析并调用 handle。
- 队列监听器:封装为任务入队;分发结束返回。
代码或图示
event(new OrderCreated($order));
// 等价入口
Event::dispatch(new OrderCreated($order));
常见误区
- 以为事件分发是异步的:默认监听器同步执行,异步需实现队列化接口或标记队列属性。
- 事件构造函数注入服务实例:事件对象可能被序列化入队/广播,只应携带可序列化数据。
追问
- 监听器执行顺序如何保证?答:按注册顺序调用;强顺序依赖应在同一监听器内编排,不依赖跨监听器先后。
- 分发后如何获知执行结果?答:同步监听器可通过事件对象回写属性;队列化监听器无即时返回值。
06.5.4.8-004 模型事件钩子 created/updated/saved/deleting 等触发时机是什么?
一句话结论
模型在持久化前后触发对应钩子:saving/saved 覆盖创建与更新,creating/created 针对新增,updating/updated 针对更新,deleting/deleted 针对删除;删除前可阻止操作。
概念解释
钩子挂在模型生命周期节点:保存前(saving/creating/updating)可校验或修改,保存后(saved/created/updated)做副作用通知,删除前(deleting)可取消删除,删除后(deleted)清理关联。
原理流程
- 调用 save/create/update/delete。
- 保存前触发 before 钩子(saving → creating/updating)。
- 执行数据库写入。
- 写入后触发 after 钩子(saved → created/updated);删除流程对应 deleting/deleted。
代码或图示
protected static function booted(): void
{
static::creating(function (Post $post) {
$post->slug = Str::slug($post->title);
});
static::deleted(function (Post $post) {
$post->comments()->delete();
});
}
常见误区
- 在 after 钩子阻止删除:deleting 才是删除前钩子,deleted 时记录已删除。
- 钩子内再次 save 同一模型:递归触发事件,需用无事件保存或标志位避免循环。
追问
- 模型事件与观察者关系?答:观察者是钩子的独立类形式,方法名对应事件名;闭包钩子写在 booted 内,二者机制相同。
- 批量 insert 触发模型事件吗?答:查询构造器批量插入不经过模型生命周期,不触发钩子。
06.5.4.8-005 观察者 Observer 与闭包监听器如何选择?
一句话结论
单个模型的多个生命周期行为用观察者类集中管理;跨模型、与特定业务事件耦合的响应使用独立事件监听器;闭包钩子适合简单临时逻辑,复杂行为抽类。
概念解释
观察者绑定模型事件,方法名即事件名;事件监听器响应自定义业务事件。闭包钩子写在模型 booted 内,逻辑复杂会膨胀模型类。
原理流程
- 判断行为属于模型生命周期还是业务事件。
- 模型生命周期:注册观察者或闭包钩子。
- 业务领域事件:定义事件类并挂监听器/订阅者。
- 复杂依赖与队列化需求使用类形式。
代码或图示
// 观察者注册(位置与 API 以当前版本为准)
Post::observe(PostObserver::class);
class PostObserver
{
public function created(Post $post): void { /* ... */ }
public function deleted(Post $post): void { /* ... */ }
}
常见误区
- 把跨模块业务通知写进模型观察者:模型与外部业务耦合,模块边界模糊。
- 观察者方法未声明事件类型提示:容器解析时无法确定事件实例。
追问
- 观察者支持队列化吗?答:观察者方法对应的事件处理可按队列监听器方式配置;具体支持粒度以版本源码为准。
- 多个观察者监听同一模型事件如何执行?答:按注册顺序调用,与多监听器规则一致。
06.5.4.8-006 ShouldBroadcast 接口如何把事件推到广播通道?
一句话结论
事件类实现 ShouldBroadcast 契约后,分发时框架把事件序列化推送到广播驱动器,按 broadcastOn() 指定的频道发布;前端订阅对应频道接收消息。
概念解释
广播事件是“推送到前端”的特殊事件。接口标记事件需广播,频道、载荷、命名在事件类方法/属性中定义。广播默认走队列异步发送(ShouldBroadcastNow 除外)。
原理流程
- 事件类实现
ShouldBroadcast。 - 定义
broadcastOn()返回频道数组,broadcastWith()定义载荷。 - 事件分发时框架序列化并推入广播队列。
- 广播驱动向指定频道推送,前端订阅接收。
代码或图示
class ReportGenerated implements ShouldBroadcast
{
public function __construct(public readonly Report $report) {}
public function broadcastOn(): Channel
{
return new PrivateChannel('reports.' . $this->report->user_id);
}
public function broadcastWith(): array
{
return ['id' => $this->report->id, 'title' => $this->report->title];
}
}
常见误区
- 事件携带不可序列化资源(容器、连接):广播序列化失败,载荷只放标量/数组/模型 ID。
- 私有频道未做授权:前端订阅被拒绝,消息收不到。
追问
- 广播事件还会执行普通监听器吗?答:实现广播接口不影响事件监听注册;同一事件可同时有监听器与广播推送。
- 广播在什么队列执行?答:默认使用队列系统异步广播;连接/队列名可在事件属性中指定,见后续题。
06.5.4.8-007 ShouldBroadcastNow 与队列化广播的区别是什么?
一句话结论
ShouldBroadcastNow 在当前进程同步执行广播推送,不入广播队列;ShouldBroadcast 把广播任务推入队列异步发送,牺牲即时性换取主流程不被推送阻塞。
概念解释
同步广播适合必须立即推送、队列不可用或调试场景;队列化广播解耦推送延迟与消费者处理能力。两者都实现广播契约,标记接口决定执行方式。
原理流程
- 事件实现 Now 接口:分发时直接调用广播驱动推送。
- 事件实现普通广播接口:封装广播任务入队。
- 队列 worker 消费任务执行推送。
- 主流程不等待推送结果(队列化场景)。
代码或图示
// 同步广播
class InstantNotification implements ShouldBroadcastNow
{
// broadcastOn / broadcastWith ...
}
// 队列化广播
class QueuedNotification implements ShouldBroadcast
{
// ...
}
常见误区
- 在请求高频路径用 Now 广播:外部推送延迟直接计入响应时间。
- 队列未启动仍依赖广播:队列化事件堆积,前端长时间收不到消息。
追问
- Now 广播失败会影响主流程吗?答:同步异常在当前进程抛出,需按异常处理策略捕获;队列化失败进入队列重试/失败流程。
- 如何选择默认方式?答:业务推送走队列化;调试、低并发强实时场景用 Now。
06.5.4.8-008 公共、私有、Presence 频道的访问控制差异是什么?
一句话结论
公共频道(Channel)无需授权即可订阅;私有频道(PrivateChannel)需后端授权回调通过;Presence 频道(PresenceChannel)在私有授权基础上额外跟踪在线成员列表,可广播谁在加入/离开。
概念解释
- 公共:匿名/登录用户均可订阅,适合公告类。
- 私有:频道名与资源归属相关,后端校验当前用户是否有权订阅。
- Presence:授权同时返回成员信息,频道维护在线成员集合。
原理流程
- 前端订阅频道,广播驱动向后端发起授权请求(私有/Presence)。
- 授权路由回调校验用户归属。
- 私有通过即订阅;Presence 额外上报成员信息并维护列表。
- 事件按频道类型推送给对应订阅者。
代码或图示
// 公共频道
new Channel('announcements');
// 私有频道
new PrivateChannel('reports.' . $userId);
// Presence 频道
new PresenceChannel('room.' . $roomId);
常见误区
- 敏感数据走公共频道:未授权用户可直接订阅接收。
- Presence 频道滥用:成员状态维护有服务端成本,仅在线协作场景使用。
追问
- 频道名规则有约定吗?答:私有频道前缀由广播驱动约定;业务标识(用户 ID、资源 ID)拼入频道名,授权回调解析。
- 同一用户多端在线如何处理?答:Presence 按连接/身份维护成员,多端连接的合并规则由驱动与前端库实现决定。
06.5.4.8-009 私有频道授权路由 routes/channels.php 与 Broadcast::channel 如何工作?
一句话结论
授权回调在频道路由文件中用 Broadcast::channel(频道模式, 回调) 注册;订阅私有/Presence 频道时,后端解析频道名调用回调,返回 true 授权通过,回调接收当前认证用户与频道参数。
概念解释
频道路由文件集中定义授权规则。回调签名 function (User $user, string $channelName, ...参数),按资源归属判断;返回布尔值,Presence 场景还可返回成员信息数组。
原理流程
- 在频道路由文件登记频道模式与授权回调。
- 前端订阅私有频道,驱动请求授权端点。
- 后端匹配频道模式,注入用户与参数调用回调。
- 回调通过则建立订阅,拒绝则返回 403。
代码或图示
// routes/channels.php
Broadcast::channel('reports.{userId}', function (User $user, int $userId) {
return $user->id === $userId;
});
Broadcast::channel('room.{roomId}', function (User $user, int $roomId) {
return $user->inRoom($roomId); // Presence 可返回成员信息数组
});
常见误区
- 授权回调只判登录不判归属:登录用户可订阅他人资源频道。
- 频道模式参数名与回调形参不一致:参数注入失败,授权判断拿不到资源 ID。
追问
- 频道路由文件在哪里加载?答:由广播服务提供者在引导阶段注册;文件路径随版本约定可能不同,以当前版本配置为准。
- 授权失败前端表现?答:订阅被拒绝,连接进入鉴权失败状态;错误响应码按驱动实现返回。
06.5.4.8-010 广播驱动 pusher / redis / log / null 的差异与选型?
一句话结论
pusher(及兼容服务)托管 WebSocket 推送,前端直连;redis 驱动利用 Redis 发布订阅配合前端 WebSocket 服务;log 驱动把广播写入日志用于开发调试;null 驱动不推送。
概念解释
驱动决定消息送达通道:
| 驱动 | 用途 | 前端接入 |
|---|---|---|
| pusher/ably | 托管实时推送服务 | 官方前端库直连 |
| redis | Redis pub/sub,需自建 WebSocket 网关 | 自有 WS 服务订阅 Redis |
| log | 开发调试,记录广播载荷 | 无实时推送 |
| null | 禁用广播,不产生推送 | 无 |
原理流程
- 配置默认广播驱动。
- 广播任务按驱动序列化消息。
- 驱动发布到对应通道/日志。
- 前端经对应连接接收消息。
代码或图示
// 配置项名称与取值以 config/broadcasting.php 为准
'default' => env('BROADCAST_CONNECTION', 'log'),
// 事件中可指定连接
public function broadcastConnection(): string
{
return 'redis';
}
常见误区
- 生产用 log 驱动:消息只进日志,前端收不到实时更新。
- redis 驱动忽略自建 WS 服务:Redis 只做后端 pub/sub,浏览器不能直接订阅 Redis。
追问
- ably 与 pusher 关系?答:同属托管推送服务,驱动配置按服务提供商选择;具体可用驱动清单以当前版本广播配置为准。
- 驱动切换需要改事件代码吗?答:频道与载荷定义与驱动无关,切换主要改配置与前端连接层。
06.5.4.8-011 broadcastAs / broadcastWith 如何控制频道名与载荷?
一句话结论
broadcastAs() 自定义广播事件名(默认类名),broadcastWith() 返回推送载荷数组;频道由 broadcastOn() 返回的频道对象决定,三者共同定义推送内容与路由。
概念解释
前端按事件名监听消息;默认事件名为类全名,broadcastAs 可缩短或固定契约名。载荷只包含需要下发的数据,避免把整个模型序列化推给前端。
原理流程
- 事件实现广播契约。
broadcastOn返回频道数组。broadcastWith组装下发字段数组。broadcastAs设定前端监听的事件名(可选)。
代码或图示
public function broadcastOn(): PrivateChannel
{
return new PrivateChannel('team.' . $this->team->id);
}
public function broadcastAs(): string
{
return 'report.generated';
}
public function broadcastWith(): array
{
return ['report_id' => $this->report->id];
}
常见误区
- 载荷直接返回 Eloquent 模型:序列化带入隐藏属性与多余字段,应挑字段组装数组。
- 事件名前后端不一致:前端监听默认类名,后端自定义了别名,消息收不到。
追问
- 广播载荷带模型 ID 还是模型数据?答:实时通知可带摘要字段;详情由前端按 ID 拉取,减小推送体积。
- 频道名在哪个方法返回?答:
broadcastOn返回频道对象数组;频道命名规则随驱动约定。
06.5.4.8-012 队列化监听器如何指定连接、队列、延迟与失败处理?
一句话结论
实现 ShouldQueue 契约的监听器成为队列任务,可通过属性或方法指定 $connection、$queue、$delay;失败任务走队列失败流程,可定义 failed 方法处理兜底。
概念解释
队列化监听器与队列任务机制一致:分发时入队,worker 消费。连接/队列名隔离不同优先级任务;延迟控制执行时间;失败回调记录补偿动作。
原理流程
- 监听器实现 ShouldQueue(或框架按类属性标记)。
- 配置连接、队列名、延迟秒数。
- 事件分发时封装任务入队。
- worker 执行;失败进入重试/失败队列,
failed方法兜底。
代码或图示
class SendOrderNotification implements ShouldQueue
{
public ?string $connection = 'redis';
public string $queue = 'notifications';
public int $delay = 10;
public function handle(OrderCreated $event): void { /* ... */ }
public function failed(Throwable $e): void
{
report($e);
}
}
常见误区
- 队列监听器构造函数注入不可序列化对象:任务入队序列化失败,只注入可在 handle 解析的依赖。
- 不设置失败处理:推送/通知静默丢失,需记录告警与补偿。
追问
- 监听器重试次数在哪里配?答:任务属性
$tries与队列配置共同控制;具体属性名以版本源码为准。 - 队列化监听器与同步监听器混在同一事件?答:可以,分发时按各监听器队列标记分别入队或同步执行。
06.5.4.8-013 事件类属性序列化在队列/广播中有什么要求?
一句话结论
进入队列或广播的事件对象会被序列化,属性只应携带可序列化数据(标量、数组、可队列化模型);服务实例、连接、请求对象等不可序列化资源必须避免挂在事件上。
概念解释
序列化后在消费端重建对象。Eloquent 模型可借助模型序列化约定携带主键与类名,取出时重新查询;依赖服务在监听器 handle 中由容器解析,不通过事件传递。
原理流程
- 事件构造函数只接收数据对象/ID。
- 入队/广播时序列化事件属性。
- 消费端反序列化重建事件。
- 监听器通过事件 ID 重新查询所需模型。
代码或图示
class ReportReady implements ShouldBroadcast
{
public function __construct(public readonly int $reportId) {}
public function broadcastWith(): array
{
return ['report_id' => $this->reportId];
}
}
常见误区
- 事件持有
Request或容器引用:序列化报错或消费端状态失效。 - 携带整份大模型集合:序列化体积大,且消费端数据可能已过期。
追问
- 模型如何安全入队?答:使用队列化模型序列化约定(如 SerializesModels 特征),存类名与主键,消费端重新加载;具体机制以版本源码为准。
- 序列化失败如何排查?答:查看队列异常中的不可序列化类型,定位事件属性中的资源对象。
06.5.4.8-014 监听器依赖注入如何由容器解析?
一句话结论
队列化与同步监听器实例都由容器解析,构造函数类型提示的服务按容器绑定注入;handle 方法也可声明类型提示参数,在调用时解析。
概念解释
监听器不是手动 new,分发器解析监听器类时走容器。构造注入适合长期协作依赖;方法注入适合事件数据之外的临时服务。
原理流程
- 分发器取得监听器类名。
- 容器反射构造函数并解析依赖。
- 实例化监听器。
- 调用 handle,事件实例与方法依赖一并传入。
代码或图示
class ReportListener
{
public function __construct(
private readonly NotificationSender $sender,
) {}
public function handle(ReportGenerated $event, Metrics $metrics): void
{
$this->sender->notify($event->report);
$metrics->increment('report.generated');
}
}
常见误区
- 监听器构造函数注入事件实例:事件在 handle 传入,构造期不可用。
- 队列监听器把依赖写进属性序列化:只在 handle 内解析,属性保持可序列化。
追问
- 容器未注册的依赖会怎样?答:解析时抛 BindingResolutionException,需补绑定或改用具体类自动解析。
- 监听器单例复用吗?答:队列 worker 内实例复用行为与任务生命周期相关;避免在监听器属性保存跨任务状态。
06.5.4.8-015 事件停止传播(stopPropagation)如何实现?
一句话结论
监听器在 handle 中返回特定标记(或调用分发器停止方法,具体 API 以版本源码为准)可阻止后续监听器继续执行;用于某监听器已处理完毕、其余监听不应再响应的场景。
概念解释
默认事件分发给全部匹配监听器。需要短路时,监听器通知分发器停止传播;停止语义与返回值约定需核对当前版本事件分发器实现,避免依赖未文档化行为。
原理流程
- 分发器遍历监听器清单。
- 当前监听器判断需要短路。
- 调用停止传播入口或返回停止标记。
- 分发器中断后续监听器调用。
代码或图示
class FirstHandler
{
public function handle(OrderCreated $event)
{
// 已按业务规则处理,阻止其余监听器
// 停止传播 API 名称以当前版本 Dispatcher 源码为准
}
}
常见误区
- 用抛异常替代停止传播:异常走错误处理流程,不等同于正常短路,后续清理逻辑可能受影响。
- 依赖未确认的返回值约定:先核对分发器源码支持的停止方式再使用。
追问
- 停止传播影响广播吗?答:广播任务随事件分发入队;若在监听器层停止传播,后续监听器不执行,已注册的广播行为按其触发时机确认。
- 如何确认版本支持哪种停止方式?答:阅读
Illuminate\Events\Dispatcher中监听器调用与返回值判断逻辑。
06.5.4.8-016 模型事件与自定义业务事件如何分层使用?
一句话结论
模型事件绑定数据生命周期(创建、更新、删除的内部副作用);自定义业务事件表达领域发生的事实(订单已创建、报告已生成),供跨模块订阅与广播;避免把业务通知写进模型钩子。
概念解释
分层原则:模型层只关心自身持久化,业务事实由服务层分发领域事件。跨模块协作、前端推送、审计通知订阅业务事件;模型观察者保持内聚。
原理流程
- 模型保存触发模型事件,处理内部一致性(关联清理、派生字段)。
- 服务层完成业务用例后
event(领域事件)。 - 监听器订阅领域事件,执行通知、广播、同步索引等。
- 模块间通过事件解耦,不直接互相调用。
代码或图示
// 服务层
public function createOrder(array $data): Order
{
$order = Order::create($data);
event(new OrderCreated($order));
return $order;
}
常见误区
- 模型 created 钩子里发跨模块通知:模型依赖外部模块,复用与测试困难。
- 业务事件在模型构造函数里分发:对象尚未持久化,事件数据不完整。
追问
- 一个用例可以分发多个领域事件吗?答:可以,按业务事实逐个分发;监听器独立订阅,互不影响。
- 模型事件需要广播给前端吗?答:前端推送应通过业务事件实现 ShouldBroadcast;模型钩子不直接承担推送职责。
06.5.4.8-017 广播事件授权回调中如何校验当前用户归属?
一句话结论
授权回调接收认证用户与频道参数,按资源归属关系判断(用户 ID 匹配、成员关系、团队权限),通过返回 true 或成员信息,否则拒绝;校验规则与动作 Policy 保持一致口径。
概念解释
频道名携带资源标识(如 reports.{userId}),回调解析参数后查询归属。授权逻辑复用权限判断方法,避免频道授权与接口授权两套口径。
原理流程
- 前端订阅频道,驱动携带认证信息请求授权端点。
- 回调取得当前用户与频道参数。
- 查询用户与资源归属关系。
- 有权限返回 true/Presence 信息;无权限返回 false。
代码或图示
Broadcast::channel('reports.{reportId}', function (User $user, int $reportId) {
$report = Report::find($reportId);
return $report !== null && $report->user_id === $user->id;
});
常见误区
- 回调只检查登录状态:登录不等于有权访问该资源。
- 授权查询未走作用域/权限规则:与接口 Policy 口径不一致,出现直链越权。
追问
- Presence 授权返回什么?答:除布尔结果外可返回成员展示信息数组;具体返回结构以广播文档为准。
- 授权回调性能如何控制?答:按索引字段查询归属,避免在回调中重聚合;高频频道可缓存成员关系。
06.5.4.8-018 广播队列积压与重连失败如何排查?
一句话结论
先核对广播任务是否入队、worker 是否消费;积压看队列长度与消费速率,推送失败看驱动连接配置、凭证与网络;日志区分“未入队”“未消费”“推送失败”三段。
概念解释
广播链路:事件分发 → 广播队列 → worker → 驱动连接 → 频道推送。每段都可能断裂。排查按段定位:队列监控看积压,worker 日志看消费异常,驱动日志看推送错误。
原理流程
- 确认事件实现广播契约,配置默认驱动。
- 检查队列中广播任务数量与 worker 运行状态。
- 查看 worker 异常:序列化失败、连接拒绝、凭证无效。
- 驱动层核对频道推送记录与前端订阅状态。
代码或图示
# 队列与失败任务查看(命令名以版本为准)
php artisan queue:work redis --queue=broadcasting
php artisan queue:failed
常见误区
- 只看前端收不到消息就改前端:后端队列与驱动可能早已失败。
- 广播失败不进失败队列:异常被吞掉,需在监听器/广播异常记录中核对。
追问
- redis pub/sub 积压会堆积吗?答:pub/sub 不留存消息,消费者离线期间消息丢失;需要持久化应选队列驱动或托管推送服务。
- 如何监控广播成功率?答:在广播任务成功/失败回调打点计数,结合队列失败任务数量告警。
06.5.4.8-019 事件订阅者如何在一个类里绑定多个监听方法?
一句话结论
订阅者实现订阅契约,subscribe 方法返回“事件类 → 处理方法名”映射数组;框架注册后,相关事件分发时调用订阅者对应方法,一个类集中管理一组关联监听。
概念解释
订阅者适合 cohesive 的一组事件:如订单模块的创建、更新、取消都在同一订阅类处理。方法接收对应事件实例,依赖由容器注入构造函数。
原理流程
- 类实现订阅者接口。
subscribe返回事件到方法名映射。- 应用/提供者注册订阅者类。
- 事件触发时分发器调用映射方法。
代码或图示
class OrderSubscriber implements Subscriber
{
public function subscribe(Dispatcher $events): array
{
return [
OrderCreated::class => 'onCreated',
OrderCancelled::class => 'onCancelled',
];
}
public function onCreated(OrderCreated $event): void { /* ... */ }
public function onCancelled(OrderCancelled $event): void { /* ... */ }
}
常见误区
- 映射方法不存在:事件触发时调用失败,需核对方法名与可见性。
- 订阅者未注册到事件配置:
subscribe不会被框架调用。
追问
- 订阅者支持队列化吗?答:按队列监听器规则标记;订阅方法是否入队取决于类契约与属性配置,以源码为准。
- 订阅者与多个独立监听器如何选?答:事件紧密关联、共享依赖用订阅者;独立模块各自订阅用独立监听器。
06.5.4.8-020 同步分发与队列分发在事务回滚场景下注意什么?
一句话结论
事务提交前分发的队列任务可能在回滚后被消费,导致基于未提交数据执行;应在事务提交后再分发队列/广播任务,或利用事务提交回调机制,避免脏数据触发异步副作用。
概念解释
队列任务入队不依赖主事务提交;若任务在事务回滚前入队,消费端可能读到不存在或已回滚的数据。同步监听器在事务内执行可见未提交数据,需注意一致性边界。
原理流程
- 业务操作包裹在数据库事务中。
- 避免事务内直接分发队列化事件。
- 事务提交后再触发异步事件,或注册提交后回调。
- 消费端按持久化后的 ID 重新查询数据。
代码或图示
DB::transaction(function () use ($data) {
$order = Order::create($data);
// 队列化事件延迟到提交后分发(具体机制以版本支持为准)
event(new OrderCreated($order));
});
常见误区
- 入队即认为数据已提交:队列消费可能先于主事务提交或在回滚后启动。
- 异步任务信任事件快照数据:回滚后快照与库不一致,任务应按 ID 重新查询并校验存在性。
追问
- 框架有事务提交后分发机制吗?答:部分版本提供提交后回调/事务感知队列配置;具体能力与配置项需核对当前版本文档与源码,属待确认项。
- 同步监听器在事务内能读到未提交数据吗?答:同一连接内可见未提交变更;跨连接/队列任务不可见,边界需按连接与事务隔离级别确认。