PHP观察者模式使用规范及注意事项完整指南

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），由独立消费者处理，架构更清晰。