调用ASMX服务时PHP为何将返回的单元素数组识别为对象？

问题原因 #

1. PHP内置SoapClient的默认解析逻辑存在设计取舍：解析SOAP响应XML时，仅根据节点的实际出现次数判断返回类型，而非优先读取WSDL中预定义的数组类型约束。如果指定节点仅出现1次，就会被直接解析为stdClass对象；只有节点出现≥2次时才会被解析为数组。
2. C#创建服务引用时会完整解析WSDL的Schema结构，提前识别出标记为可重复的数组类型节点，因此无论返回多少个元素，都会统一封装为数组类型，不会出现单元素被识别为对象的问题。

解决方案 #

方案1（推荐）：开启SoapClient单元素数组特性

初始化SoapClient时添加SOAP_SINGLE_ELEMENT_ARRAYS特性参数，即可让所有WSDL中定义为数组类型的节点，即使仅返回1个元素也会被自动封装为数组，无需额外判断：

$wsdl = "www.some_url.com/app/webservice.asmx?wsdl";
$client = new SoapClient($wsdl, [
    'cache_wsdl' => WSDL_CACHE_NONE,
    'features' => SOAP_SINGLE_ELEMENT_ARRAYS // 新增这一行即可
]);
$result = $client->{$function_name}($parameters)->{$web_service."Result"};

方案2：编写通用转换函数兼容两种场景

如果无法修改SoapClient的初始化配置，可以封装一个通用工具函数统一处理类型：

/**
 * 确保返回值为数组，单对象会被包裹为单元素数组
 */
function ensure_array(mixed $data): array
{
    return is_array($data) ? $data : [$data];
}

// 调用示例
$audit_details = ensure_array($result->audit_dets->audit_details);
// 后续直接用count()、array_search()等数组函数处理即可

内容的提问来源于stack exchange，提问作者Leventogenna