PHP 反射機制實現動態代理模式完整範例

PHP 5 的反射 API（Reflection API）提供了在執行時檢查類別、介面、方法與屬性的能力。本文透過兩個完整範例，示範如何利用反射機制實現動態代理模式，將方法呼叫委派給目標物件。

範例一：建構子自動註冊目標物件

<?php
class ClassOne {
  function callClassOne() {
    print "In Class One";
  }
}

class ClassOneDelegator {
  private $targets;
  
  function __construct() {
    $this->target[] = new ClassOne();
  }
  
  function __call($name, $args) {
    foreach ($this->target as $obj) {
      $r = new ReflectionClass($obj);
      if ($method = $r->getMethod($name)) {
        if ($method->isPublic() && !$method->isAbstract()) {
          return $method->invoke($obj, $args);
        }
      }
    }
  }
}

$obj = new ClassOneDelegator();
$obj->callClassOne();  // 輸出：In Class One
?>

範例二：動態新增目標物件

<?php
class ClassOne {
  function callClassOne() {
    print "In Class One";
  }
}

class ClassOneDelegator {
  private $targets;
  
  function addObject($obj) {
    $this->target[] = $obj;
  }
  
  function __call($name, $args) {
    foreach ($this->target as $obj) {
      $r = new ReflectionClass($obj);
      if ($method = $r->getMethod($name)) {
        if ($method->isPublic() && !$method->isAbstract()) {
          return $method->invoke($obj, $args);
        }
      }
    }
  }
}

$obj = new ClassOneDelegator();
$obj->addObject(new ClassOne());
$obj->callClassOne();  // 輸出：In Class One
?>

核心原理解析

1. __call 魔術方法： 當呼叫不存在的方法時自動觸發，接收方法名稱與參數陣列
2. ReflectionClass： 取得目標物件的類別反射資訊
3. getMethod()： 取得指定名稱的方法反射物件
4. isPublic() / isAbstract()： 過濾僅呼叫公開且非抽象方法
5. invoke()： 在目標物件上執行方法並傳遞參數

應用場景

• 多重繼承模擬（PHP 不支援多重繼承）
• AOP 切面導向程式設計的方法攔截
• 動態擴充第三方類別功能
• 代理模式與裝飾器模式的實現

效能考量

反射操作較一般方法呼叫有額外開銷，高頻率呼叫場景建議快取反射物件或採用代碼生成方式優化。