PHP stdClass 使用指南與實戰技巧

什麼是 stdClass？

stdClass 是 PHP 內建的預定義類別，本質上是一個空白的基類，不包含任何屬性與方法。它常被用作「資料傳遞物件」（DTO），讓開發者無需自行定義類別即可將陣列轉為物件，方便屬性式存取。

核心特性

• 可動態新增屬性，無需預先定義
• 實例化後無法新增方法（僅限屬性）
• 所有 PHP 變數在底層皆可視為 stdClass 實例
• 常用於 API 回傳資料、設定物件、暫存結構化資料

基本用法

1. 從陣列轉換

$andy = array();
$andy = (object)$andy;  // 強制轉型
$andy->a = 1;
$andy->b = 2;
$andy->c = 3;

2. 直接實例化

$a = new stdClass();
$a->id = '11';
$a->username = 'me';
print_r($a);
// 輸出：stdClass Object ( [id] => 11 [username] => me )

資料存取方式

與陣列 $arr['key'] 不同，物件使用箭頭運算子：

$weather->getWeatherbyCityNameResult->string[0]  // 取得「四川」

進階行為差異

未實例化直接轉型（保留原陣列鍵值）

$a = array(1=>2, 2=>3);
$a = (object)$a;
$a->id = '11';
$a->username = 'me';
print_r($a);
// 輸出：stdClass Object ( [1] => 2 [2] => 3 [id] => 11 [username] => me )

實例化後再賦值（原陣列資料清空）

$a = array(1=>2, 2=>3);
$a = (object)$a;
$a = new stdClass();  // 重新實例化，舊資料遺失
$a->id = '11';
$a->username = 'me';
print_r($a);
// 輸出：stdClass Object ( [id] => 11 [username] => me )

注意事項

• 在函式內搭配 global/static 使用 new stdClass 時，避免使用引用賦值（&new stdClass 會失效），直接用 new stdClass() 即可
• 大量資料傳遞時，考慮使用陣列或自訂類別以獲得更好的型別提示與 IDE 支援
• JSON 解碼預設回傳 stdClass：json_decode($json) 等同 json_decode($json, false)

適用場景

• 快速建構資料結構，無需建立正式類別檔案
• 第三方 API 回傳 JSON 直接解碼為物件
• 框架內部的資料傳遞容器（如 Laravel 的 stdClass 基礎模型）

善用 stdClass 可減少樣板代碼，但在大型專案中建議配合介面或資料傳輸物件（DTO）模式使用，提升代碼可維護性。