萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP5 呼叫 Java WebService 實戰避坑指南:從 SOAP 錯誤到 MTOM 附件處理

環境背景

  • 服務端:Spring 3.0.5 + CXF 2.4,JDK 1.6,WSDL 自動生成
  • 客戶端:PHP 5.1.3(內建 SOAP 擴展)
  • 協議:SOAP 1.1/1.2,啟用 MTOM (Message Transmission Optimization Mechanism)

問題一:SOAP-ERROR: Encoding: object has no 'id' property

現象

呼叫建立印章服務時拋出錯誤,但 API 文檔聲稱 id 非必填。

根因分析

  1. 檢視 WSDL Schema:<xs:element name="id" type="xs:long"/> 無 minOccurs="0",預設 minOccurs=1(必填)。
  2. 深入 PHP 原始碼 ext/soap/php_encoding.c 中的 model_to_xml_object 函式,發現當 model->min_occurs == 0 才允許略過,否則拋出「object has no 'xxx' property」。

解決方案

在 SOAP 客戶端請求物件中補上任意 id 值(如 0 或 time()),滿足 Schema 驗證:

$params = [
  'seal' => [
    'id' => 0, // 必填欄位補預設值
    'name' => 'MySeal',
    // ...其他欄位
  ]
];
$client->createSeal($params);

教訓:WSDL 即契約,minOccurs 預設為 1,文檔若與 Schema 不符,以 Schema 為準。

問題二:looks like we got no XML document

現象

抓包發現回應為 multipart/related 格式(MTOM 附件封裝),非純 XML,導致 PHP SOAP 解析失敗:

HTTP/1.1 200 OK
Content-Type: multipart/related; type="application/xop+xml"; boundary="uuid:..."
--uuid:...
Content-Type: application/xop+xml; charset=UTF-8; type="text/xml"
<soap:Envelope>...</soap:Envelope>
--uuid:...--

根因

CXF 伺服端啟用 mtom-enabled=true,PHP 內建 SOAP 擴展 不支援 MTOM 解析。

解決方案對比

方案優點缺點推薦度
要求對方關閉 MTOM零代碼變更需協調對方、可能違反架構規範⭐⭐
改用 WSO2 WSF/PHP 擴展完整支援 MTOM/WS-Security編譯安裝複雜、維護成本高⭐⭐⭐
繼承 SoapClient 重寫 __doRequest(本文採用)無額外依賴、部署簡單、可控性強需手動剖析 MIME 邊界、僅適用簡單場景⭐⭐⭐⭐⭐

核心代碼:ZSoapClient

class ZSoapClient extends SoapClient {
  public function __doRequest($request, $location, $action, $version, $one_way = 0) {
    $response = parent::__doRequest($request, $location, $action, $version, $one_way);
    
    // 1. 若回應已為純 XML 直接返回
    if (strpos($response, '<?xml') === 0 || strpos($response, '<soap:') === 0) {
      return $response;
    }
    
    // 2. 解析 MIME multipart/related,提取 SOAP 部分
    $start = strpos($response, '<soap:Envelope');
    if ($start === false) $start = strpos($response, '<soap:Body');
    if ($start === false) $start = strpos($response, '<?xml');
    
    $end = strrpos($response, '</soap:Envelope>');
    if ($end === false) $end = strrpos($response, '</soap:Body>');
    if ($end === false) $end = strlen($response) - 1;
    
    return substr($response, $start, $end - $start + strlen('</soap:Envelope>'));
  }
}

// 使用
$client = new ZSoapClient($wsdl, ['trace' => 1, 'exceptions' => 1]);
$result = $client->createSeal($params);

進階健壯版(處理多種邊界情況)

protected function extractSoapXml($raw) {
  // 移除 HTTP 標頭(若包含)
  $headerEnd = strpos($raw, "\r\n\r\n");
  if ($headerEnd !== false) $raw = substr($raw, $headerEnd + 4);
  
  // 嘗試直接匹配 SOAP Envelope
  if (preg_match('/(<\?xml[^>]*>)?\s*(<soap:Envelope[^>]*>.*?<\/soap:Envelope>)/s', $raw, $m)) {
    return $m[0];
  }
  
  // 解析 multipart boundary
  if (preg_match('/boundary="([^"]+)"/', $raw, $m)) {
    $boundary = '--' . $m[1];
    $parts = explode($boundary, $raw);
    foreach ($parts as $part) {
      if (strpos($part, '<soap:Envelope') !== false || strpos($part, '<?xml') !== false) {
        return trim($part);
      }
    }
  }
  return $raw; // 兜底
}

延伸建議

  1. 升級 PHP 版本:PHP 5.1.3 已停止維護,建議 ≥ 7.4,享受更好的 SOAP 效能與錯誤處理。
  2. 啟用 WSDL 快取:ini_set('soap.wsdl_cache_enabled', 1); 避免重複下載 WSDL。
  3. 錯誤追蹤:開啟 'trace' => 1,失敗時用 $client->__getLastRequest() / __getLastResponse() 除錯。
  4. 考慮 REST/JSON 替代:新專案優先選擇 RESTful API,避開 SOAP/MTOM 複雜度。

結語

PHP 呼叫 Java WebService 的核心難點在於 WSDL 契約不符 與 MTOM 附件解析。透過補齊必填欄位、繼承 SoapClient 剝離 MIME 封裝,即可在不升級基礎設施前提下穩定對接。若長期維護,建議推動服務端遷移至 REST/JSON 或 gRPC,徹底擺脫 SOAP 歷史包袱。

copyright © 萬盛學電腦網 all rights reserved