萬盛學電腦網

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

PHP 實作事件機制:基於 debug_backtrace 的觀察者模式

PHP 核心未內建事件機制,但利用 debug_backtrace() 可獲取呼叫堆疊,實作「只有直接持有事件的物件才能觸發」的受限觀察者模式。本文解析一個精簡的 Event 類別實作。

核心設計概念

  • 事件持有者:建立 Event 實例的物件(在建構子中透過 debug_backtrace() 記錄)。
  • 監聽者:任意可呼叫物件(Closure、陣列 [$obj, 'method'])。
  • 觸發限制:notify() 檢查呼叫堆疊最底層的物件是否為持有者,否則拋出例外。

Event 類別完整程式碼

<?php
class Event {
    private $callbacks = [];
    private $holder;

    public function __construct() {
        $bt = debug_backtrace();
        if (count($bt) < 2) {
            $this->holder = null;
            return;
        }
        $this->holder = &$bt[1]['object']; // 記錄建立者
    }

    // 註冊監聽者
    public function attach() {
        $args = func_get_args();
        switch (count($args)) {
            case 1:
                if (is_callable($args[0])) $this->callbacks[] = $args[0];
                break;
            case 2:
                if (is_object($args[0]) && is_string($args[1])) {
                    $this->callbacks[] = [$args[0], $args[1]];
                }
                break;
        }
    }

    // 觸發事件(含持有者驗證)
    public function notify() {
        $bt = debug_backtrace();
        if ($this->holder &&
            ((count($bt) >= 2 && $bt[count($bt)-1]['object'] !== $this->holder) ||
             (count($bt) < 2))
        ) {
            throw new Exception('Notify can only be called in holder');
        }
        $args = func_get_args();
        foreach ($this->callbacks as $callback) {
            call_user_func_array($callback, $args);
        }
    }
}

使用範例

class User {
    public $onLogin;
    public function __construct() {
        $this->onLogin = new Event();
    }
    public function login($name) {
        echo "User $name logged in.\n";
        $this->onLogin->notify($name); // 只有 User 實例能觸發
    }
}

$user = new User();
// 註冊監聽器
$user->onLogin->attach(function($name) {
    echo "發送歡迎郵件給 $name\n";
});
$user->onLogin->attach($logger, 'logLogin'); // 假設 $logger 有 logLogin 方法

$user->login('Alice');
// 輸出:
// User Alice logged in.
// 發送歡迎郵件給 Alice

優缺點分析

優點缺點
純 PHP 實作,無額外擴充需求debug_backtrace() 效能較差,不適合高頻觸發
封裝性好,防止外部任意觸發依賴內部實作細節,PHP 版本升級可能失效
語法直觀,符合觀察者模式直覺無法跨檔案/跨請求持久化事件

現代替代方案

  • Symfony EventDispatcher:成熟、標準化、支援優先順序、停止傳播。
  • Laravel Events:基於 Symfony、整合 Queue、Broadcast。
  • League/Event:輕量、PSR-14 相容。
  • ReactPHP / Amp:非同步事件循環架構。

此實作適合教學理解或極簡專案;生產環境建議採用成熟的事件分發器套件。

copyright © 萬盛學電腦網 all rights reserved