PHP stdClass 完整指南：動態物件建立與陣列轉換技巧

什麼是 stdClass？

stdClass 是 PHP 內建的空白類別，沒有任何預設屬性與方法。實例化後可動態新增屬性，常用於：

• 將關聯陣列轉為物件以利屬性存取（$obj->key vs $arr['key']）
• API 回傳結構化資料時，保持型別一致性
• 暫時性資料容器，避免定義正式 DTO 類別

基本用法示範

// 建立空物件並動態賦值
$user = new stdClass();
$user->name = '張三';
$user->email = 'zhangsan@example.com';
$user->roles = ['admin', 'editor'];

// 物件轉關聯陣列
$arr = get_object_vars($user);
print_r($arr);
/* 輸出：
Array (
    [name] => 張三
    [email] => zhangsan@example.com
    [roles] => Array ( [0] => admin [1] => editor )
) */

進階特性：參考傳遞與記憶體效能

與陣列的「複製語意」不同，物件預設為「參考傳遞」。這在處理大量資料時可節省記憶體：

$original = new stdClass();
$original->data = str_repeat('x', 1000000); // 1MB 字串

$ref = $original;          // 參考同一物件
$ref->data = 'modified';   // 修改會影響 $original

echo $original->data;      // 輸出：modified

// 對比陣列行為
$arr = ['data' => str_repeat('x', 1000000)];
$copy = $arr;              // 實際複製 1MB 記憶體
$copy['data'] = 'changed'; // 不影響 $arr

實務應用場景

1. 彈性的 API 回傳結構

function apiResponse($success, $data = null, $message = '') {
    $resp = new stdClass();
    $resp->success = $success;
    $resp->data = $data;
    $resp->message = $message;
    $resp->timestamp = time();
    return $resp;
}

// 使用時
$response = apiResponse(true, ['user_id' => 123], '登入成功');
echo $response->data->user_id; // 123

2. 陣列與物件雙向轉換

// 陣列 → 物件
$arr = ['id' => 1, 'name' => '商品A', 'price' => 99.9];
$obj = (object) $arr; // 或 json_decode(json_encode($arr))

// 物件 → 陣列
$arrAgain = (array) $obj; // 僅轉換第一層
// 深層轉換建議：
$deepArr = json_decode(json_encode($obj), true);

3. 匿名物件當作配選項袋

function connectDB(stdClass $config) {
    $dsn = "mysql:host={$config->host};dbname={$config->dbname};charset={$config->charset}";
    // ...
}

connectDB((object)[
    'host' => 'localhost',
    'dbname' => 'myapp',
    'charset' => 'utf8mb4'
]);

效能與注意事項

最佳實踐：固定結構資料建議使用 class 或 readonly class (PHP 8.1+) 以獲得型別安全與 IDE 提示；臨時、動態、或需頻繁參考傳遞的資料適合用 stdClass。

常見錯誤與除錯

// 錯誤：嘗試存取不存在屬性不會報錯，回傳 null
$obj = new stdClass();
var_dump($obj->missing); // NULL

// 建議搭配 isset() 或 property_exists()
if (property_exists($obj, 'name')) { ... }