PHP 提供 8 個魔術常量(依上下文變化)與 12 個魔術方法(特定生命周期自動調用),是元編程、框架開發、調試追蹤的利器。本文系統梳理定義、觸發時機、代碼示例與避坑指南。
| 常量 | 含義 | 示例輸出 |
|---|---|---|
__LINE__ | 當前行號 | 25 |
__FILE__ | 完整路徑(含文件名),解析符號鏈接 | /var/www/index.php |
__DIR__ | 所在目錄(無尾斜槓),等價 dirname(__FILE__) | /var/www |
__FUNCTION__ | 函數名(區分大小寫,PHP 5+) | test |
__CLASS__ | 類名(含命名空間,區分大小寫) | App\Models\User |
__TRAIT__ | Trait 名(含命名空間,PHP 5.4+) | App\Traits\Loggable |
__METHOD__ | 類方法名 Class::method | App\Models\User::save |
__NAMESPACE__ | 當前命名空間(編譯時確定) | App\Controllers |
**不區分大小寫**,但建議全大寫下劃線風格。
| 方法 | 觸發時機 | 典型用途 |
|---|---|---|
__construct() | 實例化 new Class() | 初始化屬性、注入依賴 |
__destruct() | 對象銷毀(引用計數歸零、腳本結束) | 釋放資源、關閉連接、寫日誌 |
__call($name, $args) | 調用不可訪問/不存在的**實例方法** | 動態代理、方法欄位映射、鏈式調用 |
__callStatic($name, $args) | 調用不可訪問/不存在的**靜態方法** | 靜態工廠、門面模式 |
__get($name) | 讀取不可訪問/不存在的**屬性** | 延遲加載、虛擬屬性、數組訪問代理 |
__set($name, $value) | 寫入不可訪問/不存在的**屬性** | 驗證、自動轉型、觸發事件 |
__isset($name) | isset($obj->prop) 檢測不可訪問屬性 | 配合 __get 實現 empty() 正確語義 |
__unset($name) | unset($obj->prop) 刪除不可訪問屬性 | 清理快取、觸發監聽 |
__sleep() | serialize($obj) 前 | 返回需序列化屬性名陣列,排除資源/大對象 |
__wakeup() | unserialize($data) 後 | 重建連接、初始化狀態 |
__toString() | 對象作字符串使用 echo $obj | 返回標識字符串、JSON、XML 片段 |
__invoke() | 對象作函數調用 $obj() | 可調用對象、閉包替代、策略模式 |
__set_state($arr) | var_export() 導出時 | 返回重建對象的靜態工廠方法 |
__clone() | clone $obj 後 | 深拷貝資源、重置 ID、解除單例綁定 |
__debugInfo() | var_dump($obj) / print_r()(PHP 5.6+) | 控制調試輸出字段、隱藏敏感信息 |
注:__autoload() 已棄用(PHP 7.2+),請使用 spl_autoload_register()。
class Entity {
private $data = [];
public function __get($k) { return $this->data[$k] ?? null; }
public function __set($k, $v) { $this->data[$k] = $v; }
public function __isset($k) { return isset($this->data[$k]); }
}
$e = new Entity();
$e->name = 'John'; // __set
echo $e->name; // __get → John
isset($e->name); // __isset → true
unset($e->name); // __unset
class DiscountStrategy {
public function __invoke($price, $userLevel) {
return match($userLevel) {
'vip' => $price * 0.8,
'gold' => $price * 0.9,
default => $price,
};
}
}
$calc = new DiscountStrategy();
echo $calc(100, 'vip'); // 80
class User {
public $id, $name, $passwordHash;
public function __debugInfo() {
return ['id'=>$this->id, 'name'=>$this->name]; // 隱藏 passwordHash
}
}
var_dump(new User(1, 'John', 'secret')); // 不會顯示 passwordHash
trait Logger {
public function log() {
echo __CLASS__ . '::' . __FUNCTION__; // 調用類名 + 當前方法
}
}
class Service { use Logger; }
(new Service())->log(); // Service::log
__unserialize() (PHP 7.4+)。clone。魔術方法是 PHP 物件模型的「擴展點」,善用能實現極具表達力的 DSL、代理、序列化控制;濫用則導致代碼難讀、難測試、難優化。原則:**業務邏輯用顯式方法,基礎設施用魔術方法**。