stdClass 是 PHP 內建的空白類別,常用於將關聯陣列轉為物件、JSON 解碼預設產生物件、動態屬性存儲等場景。它無方法、僅能動態新增屬性。
<?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 巢狀結構
<?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 實作、無擴充需求、處理任意深度巢狀。
缺點:大量資料時遞歸效能較差、需注意循環引用導致無限遞歸。
<?php
function objectToArrayFast($data) {
return json_decode(json_encode($data), true);
}
// 使用
$array = objectToArrayFast($stdClassObject);
優點:C 底層實作、速度極快(約為遞歸版 10-50 倍)、程式碼極簡。
缺點:
mb_convert_encoding。resource、Closure、循環引用(會拋出例外)。\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%。
<?php
// 直接拿到關聯陣列,根本不產生 stdClass
$array = json_decode($jsonString, true); // 第 2 參數 true = 關聯陣列
**最佳實踐**:若資料來源是 JSON 字串,直接用 json_decode($json, true),完全避免轉換問題。
| 方法 | 耗時 (ms) | 記憶體峰值 | 備註 |
|---|---|---|---|
| 遞歸強制轉型 | ~2800 | ~45 MB | 基準 |
| 引用傳遞遞歸 | ~2100 | ~38 MB | 優化 25% |
| json_encode/decode | ~60 | ~32 MB | **快 46 倍** |
| 問題 | 原因 | 解決 |
|---|---|---|
| 中文亂碼/空字串 | 資料非 UTF-8 | mb_convert_encoding($data, 'UTF-8', '原編碼') 後再 json_encode |
| 循環引用報錯 | json_encode 偵測到遞歸 | 改用遞歸版並加 isset($seen[spl_object_id($obj)]) 判斷 |
| 私有屬性鍵名怪異 | PHP 序列化特性 | 轉陣列後用 preg_replace('/^\0.*\0/', '', $key) 清理 |
| 資源型別丟失 | JSON 不支援 resource | 避免轉換含 resource 的物件,或先手動處理 |
json_decode($json, true)。json_decode(json_encode($obj), true) 一行解決(確認 UTF-8)。90% 場景下,**json_decode(json_encode($obj), true) 是最佳選擇**;其餘 10% 需處理編碼、循環引用、resource 等特殊情況時,採用帶防護的遞歸函式。理解各方法優劣,才能在效能與正確性間取得平衡。