PHP 核心未內建事件機制,但利用 debug_backtrace() 可獲取呼叫堆疊,實作「只有直接持有事件的物件才能觸發」的受限觀察者模式。本文解析一個精簡的 Event 類別實作。
debug_backtrace() 記錄)。[$obj, 'method'])。notify() 檢查呼叫堆疊最底層的物件是否為持有者,否則拋出例外。<?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 版本升級可能失效 |
| 語法直觀,符合觀察者模式直覺 | 無法跨檔案/跨請求持久化事件 |
此實作適合教學理解或極簡專案;生產環境建議採用成熟的事件分發器套件。