萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 魔術方法完全指南:12 個魔術方法的觸發時機與實戰應用

PHP 魔術方法:面向對象編程的隱藏超能力

魔術方法是 PHP 面向對象的特有特性,以雙下劃線 `__` 開頭,在特定生命週期或操作時自動觸發。本文系統梳理 12 個魔術方法的觸發條件、參數、返回值與實戰應用場景。

12 大魔術方法速覽表

方法觸發時機典型用途返回值要求
__construct實例化對象時初始化屬性、依賴注入無
__destruct對象銷毀/腳本結束釋放資源、關閉連接、寫日誌無
__get讀取不可訪問/不存在屬性動態屬性、代理訪問、懶加載屬性值
__set寫入不可訪問/不存在屬性屬性驗證、日誌記錄、虛擬屬性無
__issetisset()/empty() 檢測不可訪問屬性動態屬性存在性判斷bool
__unsetunset() 不可訪問屬性清理動態屬性、緩存失效無
__call調用不可訪問/不存在實例方法方法代理、動態方法、API 客戶端任意
__callStatic調用不可訪問/不存在靜態方法靜態工廠、門面模式任意
__sleepserialize() 序列化前指定序列化屬性、關閉資源string[] 屬性名數組
__wakeupunserialize() 反序列化後重建連接、初始化資源無
__cloneclone 關鍵字複製對象時深拷貝、重置標識、解除引用無
__toString對象作為字符串使用時友好顯示、調試輸出string
__invoke對象作為函數調用時可調用對象、閉包替代、策略模式任意
__set_statevar_export() 導出類時 (static)還原對象狀態、單例模式object
__debugInfovar_dump() 輸出對象時 (PHP 5.6+)隱藏敏感屬性、自定義調試視圖array

完整演示類

<?php
class MagicDemo {
    public $publicProp = 'public';
    protected $protectedProp = 'protected';
    private $privateProp = 'private';
    private $dynamicData = [];
    
    public function __construct() {
        echo "__construct: 對象創建\n";
    }
    
    public function __destruct() {
        echo "__destruct: 對象銷毀\n";
    }
    
    public function __set(string $name, $value): void {
        echo "__set: 設置 \$this->$name = " . var_export($value, true) . "\n";
        $this->dynamicData[$name] = $value;
    }
    
    public function __get(string $name): mixed {
        echo "__get: 讀取 \$this->$name\n";
        return $this->dynamicData[$name] ?? null;
    }
    
    public function __isset(string $name): bool {
        echo "__isset: 檢查 \$this->$name\n";
        return isset($this->dynamicData[$name]);
    }
    
    public function __unset(string $name): void {
        echo "__unset: 刪除 \$this->$name\n";
        unset($this->dynamicData[$name]);
    }
    
    public function __call(string $name, array $arguments): mixed {
        echo "__call: 調用 $name(" . implode(', ', $arguments) . ")\n";
        return "Called $name with " . count($arguments) . " args";
    }
    
    public static function __callStatic(string $name, array $arguments): mixed {
        echo "__callStatic: 靜態調用 $name(" . implode(', ', $arguments) . ")\n";
        return "Static $name called";
    }
    
    public function __sleep(): array {
        echo "__sleep: 準備序列化\n";
        return ['publicProp', 'dynamicData']; // 僅序列化這些屬性
    }
    
    public function __wakeup(): void {
        echo "__wakeup: 反序列化恢復\n";
        $this->dynamicData['restored'] = true;
    }
    
    public function __clone(): void {
        echo "__clone: 對象克隆\n";
        $this->publicProp .= '_cloned';
    }
    
    public function __toString(): string {
        return "__toString: MagicDemo@" . spl_object_id($this);
    }
    
    public static function __set_state(array $properties): object {
        echo "__set_state: var_export 還原\n";
        $obj = new self();
        foreach ($properties as $k => $v) $obj->$k = $v;
        return $obj;
    }
    
    public function __debugInfo(): array {
        echo "__debugInfo: var_dump 定制\n";
        return [
            'public' => $this->publicProp,
            'dynamic_keys' => array_keys($this->dynamicData),
            'hidden' => '***PROTECTED***' // 隱藏敏感信息
        ];
    }
}

// 測試所有魔術方法
$obj = new MagicDemo();           // __construct
$obj->dynamic = 'test';           // __set
echo $obj->dynamic;               // __get
isset($obj->dynamic);             // __isset
unset($obj->dynamic);             // __unset
$obj->undefinedMethod(1, 2);      // __call
MagicDemo::staticMethod('test');  // __callStatic
$serialized = serialize($obj);    // __sleep
$unserialized = unserialize($serialized); // __wakeup
$cloned = clone $obj;             // __clone
echo $obj;                        // __toString
$obj();                           // __invoke
eval('$restored = ' . var_export($obj, true) . ';'); // __set_state
var_dump($obj);                   // __debugInfo
?>

實戰應用模式

1. 動態屬性代理 (Active Record 模式)

<?php
class Model {
    private $attributes = [];
    private $original = [];
    
    public function __get($name) {
        return $this->attributes[$name] ?? null;
    }
    
    public function __set($name, $value) {
        $this->attributes[$name] = $value;
    }
    
    public function isDirty($name = null) {
        if ($name) return ($this->attributes[$name] ?? null) !== ($this->original[$name] ?? null);
        return $this->attributes !== $this->original;
    }
    
    public function syncOriginal() { $this->original = $this->attributes; }
}
?>

2. 流式 API 建構器 (__call + __invoke)

<?php
class QueryBuilder {
    private $query = [];
    
    public function __call($method, $args) {
        $this->query[$method] = $args;
        return $this; // 鏈式調用
    }
    
    public function __invoke() {
        return $this->build();
    }
    
    private function build() { /* 生成 SQL */ return 'SELECT * FROM users'; }
}

$sql = (new QueryBuilder())->select('*')->from('users')->where('id', 1)->orderBy('name')->();
?>

3. 安全序列化控制

<?php
class SecureModel {
    private $passwordHash;
    private $apiToken;
    public $username;
    
    public function __sleep(): array {
        // 排除敏感字段
        return ['username']; // 只序列化 username
    }
    
    public function __wakeup(): void {
        // 反序列化後重新初始化敏感字段
        $this->passwordHash = null;
        $this->apiToken = null;
    }
}
?>

避坑指南

  • ❌ __get 遞歸調用導致無限循環:訪問不存在屬性觸發 __get,內部再訪問同屬性
  • ❌ __sleep 返回父類私有屬性名導致錯誤:只能返回當前類可見屬性
  • ❌ __wakeup 中依賴外部資源 (DB 連接) 可能失效
  • ✅ __debugInfo 隱藏密碼、Token 等敏感信息
  • ✅ __serialize/__unserialize (PHP 7.4+) 替代舊版序列化機制
copyright © 萬盛學電腦網 all rights reserved