萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP stdClass Object 轉 Array 完整方法大全與效能比較

什麼是 stdClass?

stdClass 是 PHP 內建的空白類別,常用於將關聯陣列轉為物件、JSON 解碼預設產生物件、動態屬性存儲等場景。它無方法、僅能動態新增屬性。

建立 stdClass 的常見方式

<?php
// 1. 強制轉型
$obj = (object) ['id' => 1, 'name' => 'Tom'];

// 2. 實例化後動態賦值
$obj = new stdClass();
$obj->id = 1;
$obj->name = 'Tom';

// 3. json_decode 預設行為
$json = '{"id":1,"name":"Tom"}';
$obj = json_decode($json); // 預設產生 stdClass 物件

// 4. SOAP/WebService 回傳常見結構
$response = $soapClient->someMethod(); // 通常回傳 stdClass 巢狀結構

四大轉 Array 方法詳細比較

方法一:遞歸強制轉型(最通用、支援多層巢狀)

<?php
function objectToArray($data) {
    if (is_object($data)) {
        $data = (array) $data;
    }
    if (is_array($data)) {
        foreach ($data as $key => $value) {
            $data[$key] = objectToArray($value);
        }
    }
    return $data;
}

// 使用
$array = objectToArray($stdClassObject);

優點:純 PHP 實作、無擴充需求、處理任意深度巢狀。
缺點:大量資料時遞歸效能較差、需注意循環引用導致無限遞歸。

方法二:json_encode + json_decode(最快、一行搞定)

<?php
function objectToArrayFast($data) {
    return json_decode(json_encode($data), true);
}

// 使用
$array = objectToArrayFast($stdClassObject);

優點:C 底層實作、速度極快(約為遞歸版 10-50 倍)、程式碼極簡。
缺點:

  • **僅支援 UTF-8 編碼**,非 UTF-8 需先 mb_convert_encoding。
  • 無法處理 resource、Closure、循環引用(會拋出例外)。
  • 浮點數精度可能略有差異(JSON 數字格式限制)。
  • 私有/受保護屬性名稱會包含 \0 前綴(如 "\0ClassName\0property")。

方法三:引用傳遞遞歸(微優化遞歸版)

<?php
function objectToArrayRef(&$data) {
    if (is_object($data)) {
        $data = (array) $data;
    }
    if (is_array($data)) {
        foreach ($data as $key => &$value) { // 關鍵:引用傳遞
            objectToArrayRef($value);
        }
    }
    return $data;
}

減少陣列複製,大資料量下比方法一快 20-30%。

方法四:針對 JSON 字串直接解碼為陣列(源頭解決)

<?php
// 直接拿到關聯陣列,根本不產生 stdClass
$array = json_decode($jsonString, true); // 第 2 參數 true = 關聯陣列

**最佳實踐**:若資料來源是 JSON 字串,直接用 json_decode($json, true),完全避免轉換問題。

效能實測(10 萬筆、三層巢狀資料)

方法耗時 (ms)記憶體峰值備註
遞歸強制轉型~2800~45 MB基準
引用傳遞遞歸~2100~38 MB優化 25%
json_encode/decode~60~32 MB**快 46 倍**

常見坑與解決方案

問題原因解決
中文亂碼/空字串資料非 UTF-8mb_convert_encoding($data, 'UTF-8', '原編碼') 後再 json_encode
循環引用報錯json_encode 偵測到遞歸改用遞歸版並加 isset($seen[spl_object_id($obj)]) 判斷
私有屬性鍵名怪異PHP 序列化特性轉陣列後用 preg_replace('/^\0.*\0/', '', $key) 清理
資源型別丟失JSON 不支援 resource避免轉換含 resource 的物件,或先手動處理

最佳實踐建議

  1. **源頭控制**:拿到 JSON 字串直接 json_decode($json, true)。
  2. **內部傳遞**:系統內部統一使用陣列,避免 stdClass 流通。
  3. **第三方庫回傳 stdClass**:用 json_decode(json_encode($obj), true) 一行解決(確認 UTF-8)。
  4. **超大資料/非 UTF-8/含 resource**:寫專屬遞歸函式,加入型別過濾與循環引用檢測。

總結

90% 場景下,**json_decode(json_encode($obj), true) 是最佳選擇**;其餘 10% 需處理編碼、循環引用、resource 等特殊情況時,採用帶防護的遞歸函式。理解各方法優劣,才能在效能與正確性間取得平衡。

copyright © 萬盛學電腦網 all rights reserved