PHP 物件與陣列雙向轉換：最佳實踐與陷阱

PHP 物件與陣列雙向轉換：最佳實踐與陷阱

API 開發、配置解析、模板渲染中頻繁需要物件↔陣列互轉。PHP 提供多種方式，各有優劣。

方法一：強制類型轉換（最簡單）

$obj = (object) ['name' => 'Tom', 'age' => 25];
$arr = (array) $obj;
print_r($arr); // ['name' => 'Tom', 'age' => 25]

缺點：私有/受保護屬性鍵名會包含 \0 前綴（如 \0ClassName\0prop），序列化/JSON 會洩露結構。

方法二：json_encode/decode（乾淨但有損失）

$arr = json_decode(json_encode($obj), true);

• 優點：移除可見性標記，支援巢狀物件/陣列。
• 缺點：DateTime、Closure、資源型別會丟失；循環引用報錯；效能較差。

方法三：自定義遞歸函數（完全可控）

function objectToArray($obj) {
    if (is_object($obj)) $obj = (array) $obj;
    if (is_array($obj)) {
        return array_map('objectToArray', $obj);
    }
    return $obj;
}

function arrayToObject($arr, $class = 'stdClass') {
    if (!is_array($arr)) return $arr;
    $obj = new $class();
    foreach ($arr as $k => $v) {
        $obj->$k = arrayToObject($v);
    }
    return $obj;
}

方法四：對照介面實現（規範化）

interface Arrayable {
    public function toArray(): array;
    public static function fromArray(array $data): self;
}

class User implements Arrayable {
    public $name; public $email;
    public function toArray() { return ['name' => $this->name, 'email' => $this->email]; }
    public static function fromArray(array $data) {
        $u = new self(); $u->name = $data['name'] ?? ''; $u->email = $data['email'] ?? ''; return $u;
    }
}

場景選型建議