定義對象間**一對多依賴**,當一個對象 (Subject/被觀察者) 狀態變化時,自動通知所有依賴對象 (Observer/觀察者) 更新。別名:發布-訂閱、模型-視圖、源-監聽器。
| 角色 | 接口/類 | 職責 |
|---|---|---|
| 抽象主題 | SplSubject (PHP 內置) | 維護觀察者列表,提供 attach/detach/notify |
| 具體主題 | 實現 SplSubject 的類 | 持有業務狀態,狀態變更時調用 notify() |
| 抽象觀察者 | SplObserver (PHP 內置) | 聲明 update(SplSubject $subject) |
| 具體觀察者 | 實現 SplObserver 的類 | 持有對主題引用,update 中同步狀態/執行副作用 |
interface SplSubject {
public function attach(SplObserver $observer): void;
public function detach(SplObserver $observer): void;
public function notify(): void;
}
interface SplObserver {
public function update(SplSubject $subject): void;
}
<?php
/**
* 具體主題:用戶註冊服務
* 狀態:用戶數據
* 事件:註冊成功、資料更新
*/
class UserService implements SplSubject
{
private array $observers = [];
private array $userData = [];
public function attach(SplObserver $observer): void
{
$this->observers[] = $observer;
}
public function detach(SplObserver $observer): void
{
$key = array_search($observer, $this->observers, true);
if ($key !== false) unset($this->observers[$key]);
}
public function notify(): void
{
foreach ($this->observers as $observer) {
$observer->update($this);
}
}
// 業務方法
public function register(array $data): int
{
// ... 驗證、入庫邏輯 ...
$userId = 123; // 模擬
$this->userData = ['id' => $userId, ...$data, 'created_at' => date('Y-m-d H:i:s')];
// 狀態變更 -> 通知觀察者
$this->notify();
return $userId;
}
public function getUserData(): array
{
return $this->userData;
}
}
/** 觀察者 1:發送歡迎郵件 */
class EmailNotifier implements SplObserver
{
public function update(SplSubject $subject): void
{
if ($subject instanceof UserService) {
$user = $subject->getUserData();
// 異步發送郵件 (實際應推入隊列)
mail($user['email'], '歡迎註冊', "親愛的 {$user['name']},歡迎加入!");
error_log("[Email] 發送歡迎郵件給 {$user['email']}");
}
}
}
/** 觀察者 2:初始化用戶默認配置 */
class ProfileInitializer implements SplObserver
{
public function update(SplSubject $subject): void
{
if ($subject instanceof UserService) {
$user = $subject->getUserData();
// 初始化默認設置、創建空間間等
error_log("[Profile] 為用戶 {$user['id']} 初始化默認配置");
}
}
}
/** 觀察者 3:風控記錄 */
class RiskLogger implements SplObserver
{
public function update(SplSubject $subject): void
{
if ($subject instanceof UserService) {
$user = $subject->getUserData();
error_log("[Risk] 新用戶註冊: IP={$_SERVER['REMOTE_ADDR']}, UA={$_SERVER['HTTP_USER_AGENT']}");
}
}
}
// 使用示例
$service = new UserService();
$service->attach(new EmailNotifier());
$service->attach(new ProfileInitializer());
$service->attach(new RiskLogger());
$userId = $service->register([
'name' => '張三',
'email' => 'zhangsan@example.com',
'password' => 'hashed_pwd',
]);
echo "用戶 $userId 註冊完成,觀察者已異步處理副作用\n";
避免主題直接依賴具體觀察者類,引入**事件調度中心**:
/** 事件基類 */
abstract class Event {
public readonly string $name;
public readonly DateTimeImmutable $occurredAt;
public function __construct() {
$this->name = static::class;
$this->occurredAt = new DateTimeImmutable();
}
}
/** 具體事件 */
class UserRegistered extends Event {
public function __construct(public readonly array $userData) { parent::__construct(); }
}
/** 事件分發器 */
class EventDispatcher
{
private array $listeners = []; // eventClass => [callable, priority][]
public function listen(string $eventClass, callable $listener, int $priority = 0): void
{
$this->listeners[$eventClass][] = [$listener, $priority];
usort($this->listeners[$eventClass], fn($a, $b) => $b[1] <=> $a[1]); // 高優先級先執行
}
public function dispatch(Event $event): void
{
$class = $event::class;
if (empty($this->listeners[$class])) return;
foreach ($this->listeners[$class] as [$listener, $priority]) {
$listener($event);
}
}
}
/** 服務使用分發器 */
class UserServiceV2
{
private EventDispatcher $dispatcher;
public function __construct(EventDispatcher $dispatcher) {
$this->dispatcher = $dispatcher;
}
public function register(array $data): int
{
$userId = 123;
$userData = ['id' => $userId, ...$data];
// 發布事件,不知誰在聽,只管發布
$this->dispatcher->dispatch(new UserRegistered($userData));
return $userId;
}
}
// 組裝 (通常在 Service Provider / Bootstrap 階段)
$dispatcher = new EventDispatcher();
$dispatcher->listen(UserRegistered::class, fn($e) => mail($e->userData['email'], 'Welcome', '...'));
$dispatcher->listen(UserRegistered::class, fn($e) => initProfile($e->userData['id']));
$dispatcher->listen(UserRegistered::class, fn($e) => logRisk($e->userData));
$service = new UserServiceV2($dispatcher);
$service->register(['email' => 'test@test.com']);
| 維度 | 觀察者模式 | 事件驅動 (Event Dispatcher) |
|---|---|---|
| 耦合度 | 主題依賴觀察者接口 | 雙向解耦,通過事件類 |
| 同步/異步 | 默認同步阻塞 | 易擴展異步 (隊列、Swoole、ReactPHP) |
| 生命周期 | 進程內 | 可跨進程、跨服務 (消息總線) |
| 調試難度 | 調用棧清晰 | 需事件日誌/追蹤系統 |
| 適用規模 | 單體應用、模塊內 | 微服務、大型單體、領域事件 |
notify() 只分發事件try-catch 包裹PHP 內置 SplSubject/SplObserver 提供了標準化觀察者模式骨架,配合**事件分發器**可構建低耦合、高擴展的業務系統。核心思想:**發布者不關心誰訂閱,訂閱者不關心誰發布,只關心事件本身**。對於分佈式系統,建議升級為基於消息隊列 (Kafka/RabbitMQ/Redis Stream) 的事件驅動架構。