PHP 處理阿里大魚 SimpleXMLElement 物件取值技巧

背景

對接阿里大魚（現阿里雲通訊）API 回傳 XML 回應，PHP 用 simplexml_load_string() 解析後得到 SimpleXMLElement Object，直接屬性存取需注意命名空間與巢狀結構。

案例一：平層結構

SimpleXMLElement Object
(
    [code] => 15
    [msg] => Remote service error
    [sub_code] => isv.MOBILE_NUMBER_ILLEGAL
    [sub_msg] => 號碼格式錯誤
    [request_id] => zqbnzcj7btxy
)

直接用物件屬性語法：

$result = $obj->sub_msg; // 結果：號碼格式錯誤

案例二：巢狀結構

SimpleXMLElement Object
(
    [result] => SimpleXMLElement Object
        (
            [err_code] => 0
            [model] => 100863158072^1101308124312
            [success] => true
        )
    [request_id] => 101yy013xxd
)

逐層存取：

$result = $obj->result->success; // 結果：true

進階技巧

• 若屬性名含特殊字元（如連字號），用 $obj->{'attr-name'}。
• 需轉純量型別時：(string)$obj->sub_msg 或 (int)$obj->code。
• 檢查節點是否存在：isset($obj->sub_code)。
• 命名空間節點：$obj->children('ns', true)->node。

常見坑點提醒

1. 別用 print_r 判斷結構：SimpleXMLElement 物件 print_r 輸出不全，建議用 var_dump 或轉 JSON：json_decode(json_encode($xml), true) 轉陣列再處理。
2. 型別轉換陷阱：直接比較 $obj->success == 'true' 可能失敗，務必強制轉型 (string)$obj->success === 'true'。
3. 空節點處理：$obj->empty_node 回傳物件而非 null，需用 count($obj->empty_node) 判斷。