萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 觀察者模式深度解析:SplSubject/SplObserver 內置接口與實戰應用

模式意圖

定義對象間**一對多依賴**,當一個對象 (Subject/被觀察者) 狀態變化時,自動通知所有依賴對象 (Observer/觀察者) 更新。別名:發布-訂閱、模型-視圖、源-監聽器。

核心角色

角色接口/類職責
抽象主題SplSubject (PHP 內置)維護觀察者列表,提供 attach/detach/notify
具體主題實現 SplSubject 的類持有業務狀態,狀態變更時調用 notify()
抽象觀察者SplObserver (PHP 內置)聲明 update(SplSubject $subject)
具體觀察者實現 SplObserver 的類持有對主題引用,update 中同步狀態/執行副作用

PHP 內置接口定義 (SPL)

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']);

觀察者模式 vs 事件驅動架構 (EDA)

維度觀察者模式事件驅動 (Event Dispatcher)
耦合度主題依賴觀察者接口雙向解耦,通過事件類
同步/異步默認同步阻塞易擴展異步 (隊列、Swoole、ReactPHP)
生命周期進程內可跨進程、跨服務 (消息總線)
調試難度調用棧清晰需事件日誌/追蹤系統
適用規模單體應用、模塊內微服務、大型單體、領域事件

典型應用場景

  1. 用戶註冊/狀態變更:郵件、短信、積分、風控、搜索索引更新
  2. 訂單狀態流轉:支付成功 → 庫存扣減、物流創建、發票生成、推送通知
  3. 緩存失效:數據更新 → 通知相關緩存標記過期
  4. 插件/擴展系統:核心流程預留鉤子,插件掛載業務邏輯
  5. UI 綁定:模型變更 → 視圖自動更新 (Vue/React 響應式原理同源)

最佳實踐與避坑

  • ✅ **單一職責**:每個觀察者只做一件事 (發郵件、寫日誌、清緩存)
  • ✅ **異步化**:耗時操作 (郵件、HTTP 請求) 必須推入隊列,notify() 只分發事件
  • ✅ **異常隔離**:一個觀察者拋異常不應影響其他觀察者,用 try-catch 包裹
  • ✅ **去重防重**:同一事件可能重複觸發,觀察者內部冪等處理 (Redis SetNX、數據庫唯一鍵)
  • ❌ **避免循環依賴**:觀察者別反向修改主題狀態再觸發 notify,導致無限循環
  • ❌ **避免上帝觀察者**:一個觀察者處理十幾種邏輯,拆分為多個小觀察者

總結

PHP 內置 SplSubject/SplObserver 提供了標準化觀察者模式骨架,配合**事件分發器**可構建低耦合、高擴展的業務系統。核心思想:**發布者不關心誰訂閱,訂閱者不關心誰發布,只關心事件本身**。對於分佈式系統,建議升級為基於消息隊列 (Kafka/RabbitMQ/Redis Stream) 的事件驅動架構。

copyright © 萬盛學電腦網 all rights reserved