PHP stdClass 完整指南：動態物件建立與資料傳遞實戰

stdClass 是 PHP 內建的預定義類別，也是最基礎的「空白類別」。它沒有任何屬性與方法，卻因其動態特性，成為快速建立資料傳輸物件（DTO）的首選工具。本文將系統整理 stdClass 的核心特性、建立方式、存取技巧與常見陷阱。

核心特性

• 內建基類：Zend Engine 保留，無需 require 或 include。
• 動態屬性：實例化後可隨時新增公開屬性（$obj->prop = 'value'），但無法動態新增方法。
• 陣列互轉：支援 (object)$array 與 (array)$object 強制轉型，鍵值對完整保留。
• JSON 序列化首選：json_encode() 輸出物件時預設產生 {} 結構，與前端交互極為方便。

三種建立方式比較

1. 直接實例化（最常用）

$user = new stdClass();
$user->id = 101;
$user->name = 'Alice';
$user->roles = ['admin', 'editor'];

2. 陣列強制轉型

$data = ['id' => 101, 'name' => 'Alice'];
$user = (object) $data;
// 等同於 new stdClass() 後逐一賦值

3. 匿名類別（PHP 7+）替代方案

$user = new class {
    public $id = 101;
    public $name = 'Alice';
};

匿名類別可定義方法，適合需要行為封裝的場景。

巢狀結構與存取範例

$response = new stdClass();
$response->status = 'success';
$response->data = new stdClass();
$response->data->user = new stdClass();
$response->data->user->name = 'Bob';
$response->data->user->tags = ['php', 'oop'];

// 存取
echo $response->data->user->name;        // Bob
echo $response->data->user->tags[1];     // oop

常見陷阱與最佳實踐

進階技巧：實作陣列存取介面

若需同時支援 $obj->key 與 $obj['key']，可讓類別實作 ArrayAccess 介面，或直接使用 ArrayObject 替代 stdClass。

總結

stdClass 以「零定義、動態屬性、JSON 友善」三大優勢，成為 PHP 中輕量級資料容器的標準選擇。掌握其建立、轉型、巢狀操作與避坑指南，能顯著提升開發效率與程式碼可讀性。