PHP 的魔術方法是物件導向程式設計中的核心特性,它們在特定情況下自動被呼叫,讓開發者能夠優雅地處理物件的序列化、複製與類別載入等行為。本文將詳細解析三個實用的魔術方法:__set_state()、__clone() 與 __autoload(),並透過實際程式碼範例說明其運作機制與應用場景。
var_export() 函式可將變數輸出為合法的 PHP 程式碼字串。自 PHP 5.1.0 起,若類別定義了靜態方法 __set_state(),var_export() 在匯出物件實例時,會產生呼叫該方法的程式碼。此方法接收一個陣列參數,包含物件所有屬性的鍵值對。
<?php
class Example {
public $skill = 'php';
public static function __set_state($arr) {
$obj = new self();
foreach ($arr as $key => $value) {
$obj->$key = $value;
}
return $obj;
}
}
$instance = new Example();
$instance->age = 21;
// 匯出並重新建立物件
eval('$restored = ' . var_export($instance, true) . ';');
print_r($restored);
/*
輸出:
Example Object
(
[skill] => php
[age] => 21
)
*/
?>
關鍵點: __set_state() 必須宣告為 static,且回傳新的物件實例。這對於快取、除錯或物件持久化非常有用。
PHP 5 中物件賦值預設為參考傳遞。使用 clone 關鍵字可建立淺層複製,但若物件包含其他物件屬性,這些屬性仍指向同一實例。__clone() 方法允許你自訂複製行為,實現深層複製。
<?php
class Address {
public $city = 'Taipei';
}
class User {
public $name = 'John';
public $address;
public function __construct() {
$this->address = new Address();
}
}
$user1 = new User();
$user2 = clone $user1;
$user1->address->city = 'Kaohsiung';
echo $user2->address->city; // 輸出 'Kaohsiung' — 非預期行為
?>
<?php
class User {
public $name = 'John';
public $address;
public function __construct() {
$this->address = new Address();
}
public function __clone() {
$this->address = clone $this->address;
}
}
$user1 = new User();
$user2 = clone $user1;
$user1->address->city = 'Kaohsiung';
echo $user2->address->city; // 輸出 'Taipei' — 正確獨立
?>
最佳實務: 當物件包含資源控制代碼、資料庫連線或其他物件參考時,務必實作 __clone() 以避免非預期的共享狀態。
注意: __autoload() 自 PHP 7.2.0 起被棄用,PHP 8.0.0 移除。現代專案應使用 spl_autoload_register() 或 Composer 的 PSR-4 自動載入。
歷史上,__autoload() 在實例化不存在的類別時自動被呼叫,接收類別名稱作為參數:
<?php
function __autoload($className) {
$file = '/home/surfchen/project/' . $className . '.php';
if (file_exists($file)) {
require $file;
} else {
die("Class {$className} Not Found");
}
}
// 嘗試建立 Test 類別實例,若類別不存在會觸發 __autoload()
$obj = new Test();
?>
<?php
// 註冊多個自動載入器
spl_autoload_register(function ($className) {
$file = __DIR__ . '/src/' . str_replace('\\', '/', $className) . '.php';
if (file_exists($file)) {
require $file;
}
});
// 或使用 Composer 自動載入(推薦)
require_once __DIR__ . '/vendor/autoload.php';
?>
| 魔術方法 | 觸發時機 | 主要用途 | PHP 版本狀態 |
|---|---|---|---|
__set_state() | var_export() 匯出物件時 | 物件序列化為可執行 PHP 程式碼 | 支援中 |
__clone() | 使用 clone 關鍵字時 | 自訂物件複製行為(深層複製) | 支援中 |
__autoload() | 實例化未定義類別時 | 自動載入類別檔案 | PHP 8.0 移除,請改用 spl_autoload_register() |