萬盛學電腦網

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

PHP 物件轉陣列遞迴函式實作

處理 API 回傳、資料庫 ORM 物件、JSON 解碼結果時,常需將 stdClass 物件完整轉為陣列。本文提供遞迴函式支援多層巢狀結構轉換。

核心轉換函式

<?php
/**
 * 遞迴將物件轉換為陣列
 * @param object|array $data 物件或陣列
 * @return array
 */
function object_to_array($data) {
    // 非物件直接返回
    if (!is_object($data) && !is_array($data)) {
        return $data;
    }

    // 物件取得屬性陣列
    if (is_object($data)) {
        $data = get_object_vars($data);
    }

    // 遞迴處理每個元素
    $result = [];
    foreach ($data as $key => $value) {
        $result[$key] = object_to_array($value);
    }
    return $result;
}

// 別名函式 (相容原始碼命名)
function std_class_object_to_array($stdclassobject) {
    return object_to_array($stdclassobject);
}
?>

使用範例

<?php
// 建立測試物件
$obj = new stdClass();
$obj->id = 1;
$obj->name = '測試';
$obj->tags = ['php', 'array', 'object'];
$obj->meta = new stdClass();
$obj->meta->created = '2024-01-01';
$obj->meta->author = new stdClass();
$obj->meta->author->name = 'Admin';

// 轉換
$arr = object_to_array($obj);

echo "<pre>";
print_r($arr);
echo "</pre>";
?>

輸出結果

Array
(
    [id] => 1
    [name] => 測試
    [tags] => Array
        (
            [0] => php
            [1] => array
            [2] => object
        )
    [meta] => Array
        (
            [created] => 2024-01-01
            [author] => Array
                (
                    [name] => Admin
                )
        )
)

替代方案比較

方法優點缺點
json_decode(json_encode($obj), true)一行搞定、效能好、處理循環引用私有/保護屬性會遺失、資源型別會變 null
(array) $obj 強制轉型語法簡單只轉第一層、私有屬性鍵名會變 "\0ClassName\0prop"
get_object_vars()只取公開屬性只轉第一層、需配合遞迴
本文遞迴函式完整遞迴、保留所有層級、可控制邏輯效能較差、需自行處理循環引用

注意事項

  • 循環引用:物件間相互參考會導致無限遞迴,建議加入 $visited = [] 追蹤已處理物件 (spl_object_id)
  • 私有屬性:get_object_vars() 只能取得公開屬性,私有/保護屬性需用 ReflectionClass
  • 資源型別:資料庫連線、檔案指標等 resource 無法轉陣列,會變成 null

加強版:支援循環引用檢測

function object_to_array_safe($data, &$visited = []) {
    if (!is_object($data) && !is_array($data)) return $data;
    
    if (is_object($data)) {
        $oid = spl_object_id($data);
        if (isset($visited[$oid])) return '[Circular Reference]';
        $visited[$oid] = true;
        $data = get_object_vars($data);
    }
    
    $result = [];
    foreach ($data as $k => $v) {
        $result[$k] = object_to_array_safe($v, $visited);
    }
    return $result;
}
copyright © 萬盛學電腦網 all rights reserved