PHP 反射機制實戰：動態獲取類別與方法的檔案位置與行號

PHP 反射機制實戰：動態獲取類別與方法的檔案位置與行號

PHP 的 Reflection API 可在執行時檢查類別、介面、方法、屬性等結構資訊。常見用途包含：框架路由掃描、註解解析、除錯工具、程式碼產生器等。本文示範如何取得類別/方法的定義檔案路徑、起始行號與結束行號。

基本用法：ReflectionMethod

getStartLine(); // 方法定義起始行
$endLine   = $method->getEndLine();   // 方法定義結束行
$fileName  = $method->getFileName();  // 所在檔案完整路徑

echo "檔案: $fileName\n";
echo "行號範圍: $startLine - $endLine\n";
?>

通用工具函數：支援函數與方法

getMessage() . "\n";
        return;
    }

    $name = is_array($callable) ? $callable[1] : $reflector->getName();
    $file = $reflector->getFileName();
    $start = $reflector->getStartLine();
    $end = $reflector->getEndLine();

    echo "函數/方法 [$name] 定義於: $file (第 $start - $end 行)\n";
}

// 使用範例
function demoFunc() { /* ... */ }
class DemoClass { public function demoMethod() { /* ... */ } }

dumpFunctionLocation('demoFunc');
dumpFunctionLocation(['DemoClass', 'demoMethod']);
dumpFunctionLocation([new DemoClass(), 'demoMethod']);
?>

進階應用：讀取方法原始碼片段

getFileName();
    $start = $rm->getStartLine() - 1; // 轉 0-based 索引
    $end = $rm->getEndLine();

    $lines = file($file);
    return implode('', array_slice($lines, $start, $end - $start));
}

// 輸出完整方法原始碼
echo getMethodSource('UnifiedOrder_pub', 'getPrepayId');
?>

常用 ReflectionMethod 方法速查

效能提醒

• Reflection 操作較重，避免在高頻熱點路徑（如每請求上百次）直接呼叫。
• 建議搭配快取（如 APCu、Redis、靜態陣列）儲存解析結果。
• 生產環境可使用 opcache 加速檔案載入與編譯。