PHP __clone() 魔術方法深度解析：淺拷貝、深拷貝與對象屬性克隆控制

__clone() 是 PHP 對象克隆的核心擴展點。當執行 $obj2 = clone $obj1 時，引擎先執行淺拷貝（標量值拷貝、對象屬性引用拷貝），隨後調用 __clone() 允許開發者修正狀態。本文通過三個遞進案例，徹底講透淺/深拷貝差異、關聯對象深拷貝模式、以及常見陷阱。

一、克隆流程與淺拷貝本質

$obj2 = clone $obj1;
// 內部等效於：
$obj2 = $obj1;           // 1. 淺拷貝：標量複製，對象屬性共享引用
$obj2->__clone();        // 2. 調用 __clone()（若存在）

淺拷貝示例：未定義 __clone()

class Fruit {
    public $name = '水果';
    public $color = '顏色';
}
$apple = new Fruit();
$apple->name = '大蘋果';
$apple->color = '紅色';

$clone = clone $apple; // 淺拷貝
$clone->name = '小蘋果';
$clone->color = '青色';

// 結果：$apple 不受影響（標量獨立）
// 若有對象屬性，則共享同一對象實例

二、定義 __clone() 修正克隆行為

class Fruit {
    public $name = '水果';
    public $color = '顏色';

    public function __clone() {
        $this->name = '克隆水果'; // 統一標記為克隆體
    }
}

$apple = new Fruit();
$apple->name = '大蘋果';
$apple->color = '紅色';

$clone = clone $apple;
$clone->color = '青色'; // 只改顏色

echo $apple->name;  // 大蘋果（原對象保留）
echo $clone->name;  // 克隆水果（__clone 覆蓋）
echo $clone->color; // 青色

關鍵點

• __clone() 無參數、無返回值
• 調用時機：淺拷貝完成後、返回新對象前
• 常用於：重置 ID、生成新標識、深拷貝關聯對象

三、深拷貝關聯對象：標準模式

當對象包含其他對象屬性時，淺拷貝會導致雙方共享同一關聯對象，修改屬性會相互影響。必須在 __clone() 中手動 clone 關聯對象。

class Account {
    public $balance;
    public function __construct($b) { $this->balance = $b; }
}

class Person {
    public $id;
    public $name;
    public $account; // Account 對象

    public function __construct($name, $age, Account $account) {
        $this->name = $name;
        $this->account = $account;
    }

    public function setId($id) { $this->id = $id; }

    public function __clone() {
        $this->id = 0;                       // 重置標識
        $this->account = clone $this->account; // 深拷貝關鍵！
    }
}

// 測試
$person = new Person('peter', 15, new Account(1000));
$person->setId(1);

$person2 = clone $person;
$person2->account->balance = 250; // 只修改克隆體的賬戶

var_dump($person->account->balance);  // 1000（原對象不受影響）
var_dump($person2->account->balance); // 250

對比：若省略 $this->account = clone $this->account

// 共享同一 Account 實例
$person2->account->balance = 250;
var_dump($person->account->balance);  // 250 ← 原對象被污染！

四、進階：遞歸深拷貝與 __sleep/__wakeup 配合

對象圖極其複雜時，可考慮：

1. 在 __clone() 中遞歸遍歷屬性，對所有對象屬性 clone
2. 實現 __sleep() 返回需序列化屬性名，__wakeup() 重建資源，配合 serialize/unserialize 實現深拷貝（性能較差）
3. 引入成熟庫如 deepcopy 或 cloner（Composer 可用）

五、常見陷阱與最佳實踐

六、禁用克隆模式

class Singleton {
    private static $instance;
    private function __construct() {}
    private function __clone() {}        // 禁用 clone
    private function __wakeup() {}       // 禁用反序列化

    public static function getInstance() {
        if (!self::$instance) self::$instance = new self();
        return self::$instance;
    }
}

七、總結

1. clone = 淺拷貝 + __clone()
2. 標量自動獨立，對象屬性默認共享
3. 需獨立關聯對象 → __clone() 中 clone $this->prop
4. 單例/資源類 → private __clone() 禁用
5. 繼承鏈中 → 記得 parent::__clone()

精準控制 __clone()，是編寫健壯領域模型、避免「神秘數據變更」Bug 的關鍵技能。