在框架開發、日誌記錄、除錯追蹤、動態路由等場景,常需在執行期取得目前類別名、方法名、函式名、行號、檔案路徑。PHP 提供魔術常量(編譯期解析)與反射 API(執行期檢視)兩套機制。本文完整比較兩者差異、適用場景與效能特性。
| 常量 | 回傳值 | 支援版本 | 典型用途 |
|---|---|---|---|
__CLASS__ | 類別名稱(含命名空間,區分大小寫) | PHP 4.3+ | 日誌、例外訊息、靜態工廠 |
__FUNCTION__ | 函式/方法名稱(區分大小寫) | PHP 4.3+ | 除錯、追蹤器 |
__METHOD__ | 類別名::方法名 | PHP 5.0+ | 精確識別呼叫點 |
__LINE__ | 目前行號 | PHP 4.3+ | 錯誤回報、原始碼對應 |
__FILE__ | 完整絕對路徑(已解析符號連結) | PHP 4.3+ | 包含檔案、自動載入 |
__DIR__ | 檔案所在目錄(等同 dirname(__FILE__)) | PHP 5.3+ | 相對路徑基準、配置載入 |
__TRAIT__ | Trait 名稱(含命名空間) | PHP 5.4+ | Trait 衝突檢測 |
__NAMESPACE__ | 目前命名空間名稱 | PHP 5.3+ | 動態類別名組裝 |
defined('__CLASS__') 為 false。<?php
namespace App\Models;
class User {
public function save(): void {
echo "Class: " . __CLASS__ . "\n"; // App\Models\User
echo "Function: " . __FUNCTION__ . "\n"; // save
echo "Method: " . __METHOD__ . "\n"; // App\Models\User::save
echo "Line: " . __LINE__ . "\n";
echo "File: " . __FILE__ . "\n";
echo "Dir: " . __DIR__ . "\n";
}
}
$user = new User();
$user->save();
?>
ReflectionClass:類別/介面/Trait 結構ReflectionMethod / ReflectionFunction:方法/函式簽名ReflectionParameter:參數資訊(型別、預設值、屬性)ReflectionProperty:屬性可視性、預設值、屬性<?php
function debugTrace(): void {
$trace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 2);
$caller = $trace[1] ?? []; // 上一層呼叫者
echo "呼叫者檔案: " . ($caller['file'] ?? 'unknown') . "\n";
echo "呼叫者行號: " . ($caller['line'] ?? 'unknown') . "\n";
echo "呼叫者函式: " . ($caller['function'] ?? 'unknown') . "\n";
echo "呼叫者類別: " . ($caller['class'] ?? 'global') . "\n";
}
class Demo {
public function test() {
debugTrace();
}
}
(new Demo())->test();
?>
<?php
class ApiController {
public function index() {}
public function show($id) {}
protected function internal() {}
private function secret() {}
}
$ref = new ReflectionClass(ApiController::class);
$publicMethods = array_filter(
$ref->getMethods(ReflectionMethod::IS_PUBLIC),
fn($m) => $m->getDeclaringClass()->getName() === ApiController::class
);
foreach ($publicMethods as $method) {
echo $method->getName() . "\n"; // index, show
}
?>
| 維度 | 魔術常量 | 反射 API |
|---|---|---|
| 解析時機 | 編譯期 | 執行期 |
| 效能 | 極快(常量替換) | 較慢(物件建立、檢視) |
| 資訊豐富度 | 基本身分資訊 | 完整結構(參數、屬性、註解、修飾詞) |
| 動態性 | 靜態固定 | 可檢視任意類別/物件 |
| 繼承行為 | 父類別寫死父類名 | 可動態判斷實際類別 |
| 典型用途 | 日誌、除錯、自動載入基準路徑 | 框架核心、DI 容器、序列化、API 文件生成 |
<?php
class ParentClass {
public function whoAmI() {
echo "Magic __CLASS__: " . __CLASS__ . "\n"; // ParentClass
echo "Reflection: " . (new ReflectionClass($this))->getName() . "\n"; // 實際子類別
}
}
class ChildClass extends ParentClass {}
(new ChildClass())->whoAmI();
/*
Magic __CLASS__: ParentClass
Reflection: ChildClass
*/
?>
<?php
namespace App\Support;
class Debug {
/** 取得呼叫者資訊(跳過本函式) */
public static function caller(int $skip = 1): array {
$trace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, $skip + 1);
$frame = $trace[$skip] ?? [];
return [
'file' => $frame['file'] ?? 'unknown',
'line' => $frame['line'] ?? 0,
'function' => $frame['function'] ?? 'unknown',
'class' => $frame['class'] ?? '',
'type' => $frame['type'] ?? '', // :: 或 ->
];
}
/** 格式化輸出 */
public static function dumpCaller(int $skip = 1): string {
$c = self::caller($skip + 1);
return "{$c['class']}{$c['type']}{$c['function']}() at {$c['file']}:{$c['line']}";
}
}
// 使用
class Service {
public function process() {
echo Debug::dumpCaller() . "\n"; // Service->process() at /path/file.php:12
}
}
?>
| 操作 | 百萬次耗時 | 記憶體 |
|---|---|---|
__FUNCTION__ | 0.03s | 0 B |
__METHOD__ | 0.03s | 0 B |
debug_backtrace() | 1.20s | ~40 MB |
new ReflectionClass($this) | 0.85s | ~20 MB |
結論:高頻路徑(日誌、熱點代碼)只用魔術常量;啟動期、框架核心、開發工具才用反射。
魔術常量是「編譯期快照」,反射 API 是「執行期 X 光」。記住:日誌用 __METHOD__、路徑用 __DIR__、繼承多態用反射、高頻禁用反射。將 Debug::caller() 納入專案共用庫,統一除錯輸出格式,團隊協作更順暢。