PHP 提供 8 個魔術常量,在編譯期依據所在位置解析為對應值。它們不是變數、不區分大小寫(慣例全大寫)、前後各兩底線。本文提供完整測試代碼、輸出結果解析、Trait/命名空間情境下的行為差異,並說明與 debug_backtrace() 的本質不同。
<?php
// 檔案:/var/www/project/src/Demo/MagicConstants.php
namespace Demo;
trait Loggable {
public function log(string $msg): void {
echo "[LOG] " . __METHOD__ . " : $msg\n"; // Demo\Loggable::log
}
}
class MagicConstants {
use Loggable;
public const VERSION = '1.0';
public function demonstrate(): void {
echo "=== 魔術常量輸出 ===\n";
echo "__CLASS__ = " . __CLASS__ . "\n"; // Demo\MagicConstants
echo "__FUNCTION__ = " . __FUNCTION__ . "\n"; // demonstrate
echo "__METHOD__ = " . __METHOD__ . "\n"; // Demo\MagicConstants::demonstrate
echo "__LINE__ = " . __LINE__ . "\n"; // 當前行號
echo "__FILE__ = " . __FILE__ . "\n"; // 完整絕對路徑
echo "__DIR__ = " . __DIR__ . "\n"; // 目錄路徑
echo "__TRAIT__ = " . __TRAIT__ . "\n"; // Demo\Loggable (在 trait 方法中)
echo "__NAMESPACE__ = " . __NAMESPACE__ . "\n"; // Demo
}
}
// 全域函式測試
function globalFunc() {
echo "\n=== 全域函式 ===\n";
echo "__FUNCTION__ = " . __FUNCTION__ . "\n"; // globalFunc
echo "__METHOD__ = " . __METHOD__ . "\n"; // globalFunc (同 FUNCTION)
echo "__CLASS__ = " . __CLASS__ . "\n"; // (空字串)
echo "__NAMESPACE__= " . __NAMESPACE__ . "\n"; // Demo
}
// 執行
$obj = new MagicConstants();
$obj->demonstrate();
$obj->log("測試訊息"); // 觸發 Trait 方法
globalFunc();
?>
=== 魔術常量輸出 ===
__CLASS__ = Demo\MagicConstants
__FUNCTION__ = demonstrate
__METHOD__ = Demo\MagicConstants::demonstrate
__LINE__ = 15
__FILE__ = /var/www/project/src/Demo/MagicConstants.php
__DIR__ = /var/www/project/src/Demo
__TRAIT__ = Demo\Loggable
__NAMESPACE__ = Demo
=== 全域函式 ===
__FUNCTION__ = globalFunc
__METHOD__ = globalFunc
__CLASS__ =
__NAMESPACE__ = Demo
__CLASS__、__METHOD__、__TRAIT__、__NAMESPACE__ 皆包含完整命名空間,區分大小寫。__FUNCTION__ 在類方法中只回傳方法名(不含類別),全域函式同 __METHOD__。__TRAIT__ 僅在 Trait 定義內部有意義,外部呼叫時解析為使用該 Trait 的類別方法。__FILE__ 為實際檔案絕對路徑(已解析 symlink),__DIR__ 等同 dirname(__FILE__) 但更快。<?php
namespace App;
trait T1 {
public function foo() { echo __METHOD__ . "\n"; } // App\T1::foo
}
trait T2 {
public function foo() { echo __METHOD__ . "\n"; } // App\T2::foo
}
class Base {
use T1 {
T1::foo as baseFoo;
}
public function test() {
echo "Base::__METHOD__ = " . __METHOD__ . "\n"; // App\Base::test
$this->baseFoo();
}
}
class Child extends Base {
use T2 {
T2::foo insteadof T1;
}
public function test() {
echo "Child::__METHOD__ = " . __METHOD__ . "\n"; // App\Child::test
$this->foo(); // 來自 T2
}
}
$c = new Child();
$c->test();
/*
Child::__METHOD__ = App\Child::test
App\T2::foo
*/
?>
| 特性 | 魔術常量 | debug_backtrace() |
|---|---|---|
| 解析時機 | 編譯期 | 執行期 |
| 呼叫堆疊感知 | 無(寫死位置) | 完整堆疊 |
| 效能 | O(1) 極快 | O(n) 較慢 |
| 可取得參數值 | 否 | 是 (預設) |
| 適用場景 | 靜態日誌、路徑基準、編譯期資訊 | 動態追蹤、除錯器、效能分析 |
<?php
// composer 自動載入器常見模式
$loader = require __DIR__ . '/../vendor/autoload.php'; // __DIR__ 為專案根目錄
?>
<?php
function logInfo(string $message, array $context = []): void {
$context += [
'class' => __CLASS__,
'method' => __METHOD__,
'line' => __LINE__,
'file' => basename(__FILE__),
'time' => microtime(true),
];
// 送至 Monolog、Elasticsearch 等
}
?>
<?php
$anon = new class {
public function test() {
echo __CLASS__ . "\n"; // class@anonymous\n/path/file.php:10
}
};
$anon->test();
?>
誤區:
__CLASS__在繼承子類別中會變成子類別名。
事實:__CLASS__永遠是定義該常量的類別。需取得實際類別用static::class(PHP 5.5+) 或get_class($this)。誤區:
__DIR__結尾有斜線。
事實:無尾隨斜線,需自行__DIR__ . '/config.php'。誤區:魔術常量可用
defined()檢查。
事實:defined('__CLASS__')永遠回傳false,它們非define()定義。
魔術常量是 PHP 靜態資訊的「編譯期快照」,零成本、高可靠。掌握 __CLASS__/__METHOD__/__DIR__ 三大核心,搭配 static::class 處理繼承多態,即可覆蓋 95% 除錯與日誌需求。將本文測試代碼存為專案 tests/MagicConstantsTest.php,新成員跑一次即可建立直覺。