PHP观察者模式的设计原则,核心可以概括为六个字:解耦、可控、可测。在实际开发中,不必机械地遵循接口契约,而应围绕业务真实需求,构建一套轻量级的事件通知机制。这才是掌握观察者模式的关键所在。

那么具体如何实现呢?我们逐步拆解分析。
避免直接依赖SplSubject与SplObserver接口
PHP标准库(SPL)提供的 SplSubject 和 SplObserver 接口,功能相对简陋,在实际生产环境中几乎无法直接使用。
- 首先,不支持参数传递。调用
notify()时,观察者无法获取事件上下文,导致设计受限。 - 其次,无法区分事件类型。所有通知都通过同一个
update()方法处理,若需区分不同事件,需自行实现逻辑。 - 没有生命周期管理,缺少 detach、once、priority 等功能,执行顺序和条件控制较为困难。
- 最关键的是,实际项目中容易因未先 attach 就调用 notify,导致
Fatal error: Call to a member function update() on null这类致命错误。
因此,建议仅将其作为命名参考,不宜直接用于生产逻辑。
推荐手动编写EventDispatcher类
一个零依赖、易于测试、可复用的轻量级事件调度器,更符合PHP项目的实际开发需求。具体该如何设计呢?
- 使用字符串事件名作为键,支持多事件注册,例如
'user.registered'、'order.paid',结构清晰易懂。 - 触发事件时显式传入数据数组,观察者回调中可直接解构使用,极为便捷。
- 监听器采用
callable即可,无需定义接口或抽象类,侵入性极低。 - 不绑定容器、不强制继承、不依赖自动发现机制,CLI脚本或微服务中也能直接使用,简洁高效。
注意触发时机与生命周期管理
观察者模式的核心要求是:保持无副作用,不阻塞主流程。以下几点需要特别注意:
- 禁止在
__construct()中触发通知,必须确保观察者已注册完成后再执行。 - 避免在观察者回调中执行耗时操作,如远程API调用、文件写入等。若需异步处理,应交给消息队列。
- 不建议在观察者中修改主题对象状态,否则容易导致循环通知或状态不一致。
- 若要按顺序执行,应在调度器层增加优先级支持,而非依赖注册顺序的隐式约定,后者不够可靠。
根据项目规模选择合适的实现方案
不必追求统一架构,根据实际需求选择方案才是明智之举:
- 小型脚本或工具类:使用函数式回调即可,例如
on_user_login(fn($data) => send_welcome_email($data)),简单直接。 - 中型项目(无框架):封装一个
EventDispatcher,配合PSR-14兼容接口,便于未来扩展升级。 - Laravel项目:优先使用原生
event()或dispatch(new UserRegistered($user)),但需注意监听器注册位置和作用域。 - 需要跨进程/服务:观察者仅负责发送消息到队列(如Redis List或AMQP),由独立消费者处理,架构更清晰。
