定義對象間一對多依賴,當一個對象狀態改變,所有依賴者自動收到通知並更新。
—— 《設計模式》GoF
又稱發布-訂閱模式,是事件驅動架構的基石。
attach()、detach()、notify()。update() 方法。notify()。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
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');
// 事件類
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)
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 { /* ... */ }
}
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));
| 模式 | 推模式 (Push) | 拉模式 (Pull) |
|---|---|---|
| update 簽名 | update(data) 推送具體數據 | update(subject) 觀察者自行拉取 |
| 耦合度 | 觀察者依賴數據結構 | 觀察者依賴主題接口,更鬆散 |
| 靈活性 | 主題決定推什麼 | 觀察者按需獲取 |
| 適用 | 數據較小、固定 | 數據大、觀察者關注點不同 |
上文代碼採用拉模式(傳遞 Subject 實例),觀察者自行調用 getPrice()。
WeakReference (PHP 7.4+)。notify() 內捕獲異常並記錄。觀察者模式是實現低耦合、高擴展事件驅動系統的核心。PHP 原生 SplSubject/SplObserver 提供標準契約,現代框架 (Laravel Events, Symfony EventDispatcher, PSR-14) 提供開箱即用的異步、優先級、事務集成能力。設計時注意異步化、異常隔離、弱引用三大工程化課題。