PHP 反射機制深度解析與實戰範例

PHP 5 引入完整的 Reflection API，讓開發者能在執行期動態檢查類別、介面、函式、方法與擴充套件的結構資訊，甚至讀取文件註解。這為框架開發、依賴注入、自動載入等進階應用奠定基礎。

核心類別速覽

實戰範例：動態分析類別結構

<?php
class Foo {
    public $foo = 1;
    protected $bar = 2;
    private $baz = 3;

    /** 範例方法文件註解 */
    public function myMethod() {
        echo 'hello world';
    }
}

$ref = new ReflectionClass('Foo');

// 1. 列出所有屬性（含 private/protected）
foreach ($ref->getProperties() as $prop) {
    echo $prop->getName() . PHP_EOL;
}
// 輸出：foo, bar, baz

// 2. 取得特定方法並動態呼叫
$method = $ref->getMethod('myMethod');
$instance = $ref->newInstance();
$method->invoke($instance);  // 輸出：hello world
?>

框架級應用：Kohana 風格 MVC 分派器

許多 PHP 框架（Kohana、Yii、Laravel 早期版本）利用反射實現控制器自動實例化與動作分派：

<?php
// 簡化版分派器邏輯
$controllerClass = ucfirst(Router::$controller) . '_Controller';
$ref = new ReflectionClass($controllerClass);
$controller = $ref->newInstance();

$actionMethod = $ref->getMethod(Router::$method);
$actionMethod->invokeArgs($controller, $arguments);
?>

此模式解耦了路由解析與控制器實例化，支援外掛式架構擴充。

進階技巧：讀取文件註解實現屬性映射

<?php
class User {
    /** @Column(type="integer", primary=true) */
    public $id;
    /** @Column(type="string", length=100) */
    public $name;
}

$ref = new ReflectionClass('User');
foreach ($ref->getProperties() as $prop) {
    $doc = $prop->getDocComment();
    // 解析 @Column 註解建立 ORM 映射
}
?>

效能與最佳實務

• 反射涉及元資料讀取，效能較一般呼叫低；高頻路徑建議快取 ReflectionClass 實例。
• 生產環境可搭配 opcache 減少重複解析開銷。
• 僅在真正需要動態性（外掛系統、序列化、測試雙工）時使用，避免濫用增加複雜度。

掌握 Reflection API，能讓你編寫更靈活、可擴充的 PHP 程式庫與框架核心元件。