萬盛學電腦網

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

PHP 設計模式實戰:觀察者模式實現事件驅動與解耦

模式定義

定義對象間一對多依賴,當一個對象狀態改變,所有依賴者自動收到通知並更新。
—— 《設計模式》GoF

又稱發布-訂閱模式,是事件驅動架構的基石。

角色結構

  1. Subject (主題/被觀察者): 維護觀察者集合,提供 attach()、detach()、notify()。
  2. Observer (觀察者接口): 定義 update() 方法。
  3. ConcreteSubject (具體主題): 存儲狀態,狀態變更時調用 notify()。
  4. ConcreteObserver (具體觀察者): 實現 update(),同步主題狀態或執行副作用。

核心代碼實現

<?php
// 1. 主題接口
interface Subject {
    public function attach(Observer $observer): void;
    public function detach(Observer $observer): void;
    public function notify(): void;
}

// 2. 觀察者接口
interface Observer {
    public function update(Subject $subject): void;
}

// 3. 具體主題:股票價格
class Stock implements Subject {
    private string $symbol;
    private float $price;
    private array $observers = [];
    
    public function __construct(string $symbol, float $initialPrice) {
        $this->symbol = $symbol;
        $this->price = $initialPrice;
    }
    
    public function attach(Observer $observer): void {
        $this->observers[] = $observer;
    }
    
    public function detach(Observer $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 setPrice(float $price): void {
        $this->price = $price;
        echo "[$this->symbol] 價格更新: $price\n";
        $this->notify();
    }
    
    public function getPrice(): float { return $this->price; }
    public function getSymbol(): string { return $this->symbol; }
}

// 4. 具體觀察者:投資者
class Investor implements Observer {
    private string $name;
    private float $threshold;
    
    public function __construct(string $name, float $threshold) {
        $this->name = $name;
        $this->threshold = $threshold;
    }
    
    public function update(Subject $subject): void {
        if ($subject instanceof Stock) {
            $price = $subject->getPrice();
            if ($price >= $this->threshold) {
                echo "📢 [{$this->name}] 警報: {$subject->getSymbol()} 達到 $price (閾值: {$this->threshold})\n";
            } else {
                echo "📝 [{$this->name}] 關注: {$subject->getSymbol()} 當前 $price\n";
            }
        }
    }
}

// 5. 客戶端測試
$stock = new Stock('AAPL', 150.00);

$stock->attach(new Investor('張三', 155.00)); // 關注 155 以上
$stock->attach(new Investor('李四', 160.00)); // 關注 160 以上

$stock->setPrice(152.00); // 僅張三收到警報
$stock->setPrice(158.00); // 張三警報,李四關注
$stock->setPrice(162.00); // 兩人均警報

$stock->detach($stock->observers[0]); // 移除張三
$stock->setPrice(170.00); // 僅李四收到

PHP 內置支持:SplSubject / SplObserver

<?php
class UserList implements SplSubject {
    private array $users = [];
    private array $observers = [];
    
    public function attach(SplObserver $observer): void {
        $this->observers[] = $observer;
    }
    
    public function detach(SplObserver $observer): void {
        foreach ($this->observers as $key => $obs) {
            if ($obs === $observer) unset($this->observers[$key]);
        }
    }
    
    public function notify(): void {
        foreach ($this->observers as $observer) {
            $observer->update($this);
        }
    }
    
    public function addUser(string $name): void {
        $this->users[] = $name;
        $this->notify();
    }
}

class UserListLogger implements SplObserver {
    public function update(SplSubject $subject): void {
        if ($subject instanceof UserList) {
            error_log("用戶列表變更,當前數量: " . count($subject->users));
        }
    }
}

$list = new UserList();
$list->attach(new UserListLogger());
$list->addUser('Alice');
$list->addUser('Bob');

現代框架中的觀察者模式

Laravel Events & Listeners

// 事件類
class OrderShipped {
    public function __construct(public Order $order) {}
}

// 監聽器
class SendShipmentNotification {
    public function handle(OrderShipped $event): void {
        $event->order->user->notify(new ShipmentNotification($event->order));
    }
}

// 註冊 (EventServiceProvider)
protected $listen = [
    OrderShipped::class => [SendShipmentNotification::class],
];

// 觸發
event(new OrderShipped($order)); // 同步
OrderShipped::dispatch($order);  // 異步 (配合 ShouldQueue)

Symfony EventDispatcher

use Symfony\Contracts\EventDispatcher\Event;

class OrderEvent extends Event {
    public const NAME = 'order.placed';
    public function __construct(public Order $order) {}
}

// 訂閱器
class OrderSubscriber implements EventSubscriberInterface {
    public static function getSubscribedEvents(): array {
        return [OrderEvent::NAME => ['onOrderPlaced', 10]];
    }
    public function onOrderPlaced(OrderEvent $event): void { /* ... */ }
}

PSR-14 Event Dispatcher (框架無關標準)

composer require symfony/event-dispatcher nyholm/psr7

use Psr\EventDispatcher\EventDispatcherInterface;
use Psr\EventDispatcher\StoppableEventInterface;

$dispatcher = new \Symfony\Component\EventDispatcher\EventDispatcher();
$dispatcher->dispatch(new OrderEvent($order));

推模式 vs 拉模式

模式推模式 (Push)拉模式 (Pull)
update 簽名update(data) 推送具體數據update(subject) 觀察者自行拉取
耦合度觀察者依賴數據結構觀察者依賴主題接口,更鬆散
靈活性主題決定推什麼觀察者按需獲取
適用數據較小、固定數據大、觀察者關注點不同

上文代碼採用拉模式(傳遞 Subject 實例),觀察者自行調用 getPrice()。

優缺點與注意事項

  • ✅ 解耦主題與觀察者,動態添加/移除觀察者。
  • ✅ 支持廣播通信,一對多通知。
  • ✅ 符合開閉原則,新增觀察者無需修改主題。
  • ⚠️ 循環引用風險: 觀察者持有主題引用 + 主題持有觀察者引用 → 內存洩漏。PHP 5.3+ GC 能處理循環引用,但長運行進程建議 WeakReference (PHP 7.4+)。
  • ⚠️ 通知風暴: 狀態頻繁變更觸發大量通知。解決:批量合併通知、節流、異步隊列。
  • ⚠️ 異常傳播: 某觀察者拋出異常會中斷後續通知。notify() 內捕獲異常並記錄。
  • ⚠️ 同步阻塞: 耗時觀察者拖慢主題響應。解決:異步事件總線 (RabbitMQ、Redis Streams、Laravel Queue)。

總結

觀察者模式是實現低耦合、高擴展事件驅動系統的核心。PHP 原生 SplSubject/SplObserver 提供標準契約,現代框架 (Laravel Events, Symfony EventDispatcher, PSR-14) 提供開箱即用的異步、優先級、事務集成能力。設計時注意異步化、異常隔離、弱引用三大工程化課題。

copyright © 萬盛學電腦網 all rights reserved