PHP stdClass Object 轉 Array 三大實用方法與效能比較

前言

在 PHP 開發中，json_decode()、SOAP 回傳、資料庫 ORM 查詢常產生 stdClass 物件。若需陣列操作（如 array_map、array_filter、鍵名存取），需先轉為陣列。本文整理三種主流轉換方法，並針對大資料量進行效能分析。

方法一：遞迴型轉換（傳統寫法）

<?php
/**
 * 遞迴將物件轉為陣列
 * @param mixed $data
 * @return array
 */
function object_to_array($data) {
    if (is_object($data)) {
        $data = (array) $data;
    }
    if (is_array($data)) {
        foreach ($data as $key => $value) {
            $data[$key] = object_to_array($value);
        }
    }
    return $data;
}

// 使用範例
$obj = json_decode('{"id":1,"name":"John","tags":["a","b"],"meta":{"age":25}}');
$arr = object_to_array($obj);
var_dump($arr);

優點：純 PHP 實作，無擴充套件依賴，相容所有 PHP 版本。
缺點：遞迴呼叫開銷大，10 萬筆資料耗時約 1 秒，結構越複雜越慢（可達 3 秒以上）。

方法二：JSON 繞道法（推薦生產環境）

<?php
/**
 * 透過 JSON 序列化/反序列化快速轉換
 * @param mixed $data
 * @return array
 */
function object_to_array_fast($data) {
    return json_decode(json_encode($data), true);
}

// 使用範例
$obj = json_decode('{"id":1,"name":"John","tags":["a","b"],"meta":{"age":25}}');
$arr = object_to_array_fast($obj);
var_dump($arr);

優點：C 底層實作，速度極快（10 萬筆約 0.05 秒），程式碼極簡潔。
缺點：

• 僅支援 UTF-8 編碼，非 UTF-8 需先 mb_convert_encoding()。
• 無法處理資源型別、Closure、循環參考物件。
• 浮點數精度可能因 JSON 格式化產生微小差異。

方法三：傳址遞迴優化版（適用特殊需求）

<?php
/**
 * 以傳址方式遞迴轉換，減少記憶體複製
 * @param mixed &$data
 * @return array
 */
function object_to_array_ref(&$data) {
    if (is_object($data)) {
        $data = (array) $data;
    }
    if (is_array($data)) {
        foreach ($data as $key => &$value) {
            object_to_array_ref($value);
        }
        unset($value); // 解除參考
    }
    return $data;
}

傳址方式可減少大陣列複製的記憶體峰值，但速度仍不如 JSON 法。

效能實測對比（10 萬筆、三層巢狀結構）

實務建議

1. 首選 JSON 繞道法：現代 PHP (7.0+) 專案，資料來源為 API/資料庫/設定檔，皆為 UTF-8 純資料結構時。
2. 遇到編碼問題：先統一轉 UTF-8 再用 JSON 法，或改用遞迴法。
3. 含不可序列化資料：資源控制代、Closure、PDOStatement 等，必須用遞迴法並加入型別判斷跳過。
4. 大量資料分批處理：搭配 Generator (yield) 分批轉換，避免一次載入導致記憶體溢位。

進階：自訂序列化介面

若掌管物件類別，可實作 JsonSerializable 介面精確控制輸出：

<?php
class User implements JsonSerializable {
    private $password;
    public $id, $name, $email;

    public function jsonSerialize() {
        return [
            'id' => $this->id,
            'name' => $this->name,
            'email' => $this->email,
            // 敏感欄位不輸出
        ];
    }
}

$user = new User();
$user->id = 1; $user->name = 'John'; $user->email = 'john@example.com'; $user->password = 'secret';
$arr = json_decode(json_encode($user), true);
// 結果不含 password