處理 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() 只能取得公開屬性,私有/保護屬性需用 ReflectionClassfunction 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;
}