PHP 魔術常數與魔術方法完整圖解：從 __LINE__ 到 __serialize()

PHP 提供九個魔術常數 (值隨程式碼位置改變) 與十七個魔術方法 (特定生命週期自動觸發)。掌握它們能大幅簡化除錯、序列化、物件行為控制等常見任務。本文分類整理、附實際輸出範例、說明常見誤區與最佳實踐。

一、九大魔術常數 (編譯時解析)

實際輸出範例

<?php
namespace App\Controllers;

class Demo {
    public function test() {
        echo "__LINE__: " . __LINE__ . "\n";        // 5
        echo "__FILE__: " . __FILE__ . "\n";        // /path/to/Demo.php
        echo "__DIR__: " . __DIR__ . "\n";          // /path/to
        echo "__FUNCTION__: " . __FUNCTION__ . "\n"; // test
        echo "__CLASS__: " . __CLASS__ . "\n";       // App\Controllers\Demo
        echo "__METHOD__: " . __METHOD__ . "\n";     // App\Controllers\Demo::test
        echo "__NAMESPACE__: " . __NAMESPACE__ . "\n"; // App\Controllers
    }
}
(new Demo())->test();

二、十七大魔術方法 (生命週期鉤子)

1. 建構/解構/複製

2. 屬性存取攔截

3. 方法呼叫攔截

4. 字串/序列化/匯出

5. 自動載入 (已棄用)

// PHP 7.2 棄用，8.0 移除，請改用 spl_autoload_register()
function __autoload($class) { /* ... */ }

三、常見誤區與最佳實踐

1. __toString 必須回傳字串：回傳非字串會拋出 Error (PHP 7.4+) 或 E_RECOVERABLE_ERROR。
2. __sleep 回傳陣列決定序列化哪些屬性：若省略父類屬性，父類 __sleep 不會自動被呼叫，需手動 array_merge(parent::__sleep(), [...])。
3. __serialize/__unserialize 取代 __sleep/__wakeup：新版更直觀、支援類型提示、不依賴屬性可見性。
4. __call/__callStatic 僅攔截「不可見」方法：public 方法不會觸發。
5. __destruct 例外無法被捕捉：在解構子中避免拋出例外，改用 error_log()。
6. 魔術常數在 include/require 中行為不同：__FILE__ 為被包含檔案路徑，__DIR__ 同理。

四、實戰範例：動態屬性代理類

class Entity
{
    private array $data = [];
    private array $original = [];

    public function __construct(array $data = []) {
        $this->data = $data;
        $this->original = $data;
    }

    public function __get(string $name) {
        return $this->data[$name] ?? null;
    }

    public function __set(string $name, $value): void {
        $this->data[$name] = $value;
    }

    public function __isset(string $name): bool {
        return isset($this->data[$name]);
    }

    public function __unset(string $name): void {
        unset($this->data[$name]);
    }

    public function isDirty(): bool {
        return $this->data !== $this->original;
    }

    public function getChanges(): array {
        return array_diff_assoc($this->data, $this->original);
    }

    public function __serialize(): array {
        return ['data' => $this->data, 'original' => $this->original];
    }

    public function __unserialize(array $data): void {
        $this->data = $data['data'];
        $this->original = $data['original'];
    }
}

// 使用
$user = new Entity(['name' => 'Alice']);
$user->email = 'alice@example.com'; // __set
echo $user->name; // __get -> Alice
serialize($user); // __serialize

魔術常數提供「程式碼感知」能力，魔術方法提供「物件行為擴展」能力。善用它們能讓框架級程式碼更優雅、業務邏輯更聚焦，但濫用會導致隱式行為難以追蹤，建議在基礎設施層 (Model 基類、DTO、Repository) 使用，業務層盡量顯式。