PHP SOAP 連接正式環境失敗「Could not connect to host」排查指南

問題現象

使用 PHP SoapClient 調用 WebService 時，測試環境正常，但正式環境拋出 Could not connect to host 異常。代碼片段如下：

$url = "https://bcsz.xms.foxhis.com:8080/ItfServerWS/XmsWS?wsdl";
$client = new SoapClient($url, array("trace" => true, "connection_timeout" => 100));
$return = $client->getRoomAmount(array('arg0' => $postjson));

核心排查方向

1. 網路連通性驗證

• 在部署 PHP 的伺服器上執行 telnet bcsz.xms.foxhis.com 8080 或 curl -v https://bcsz.xms.foxhis.com:8080/ItfServerWS/XmsWS?wsdl，確認 TCP 端口可達。
• 檢查防火牆/安全組是否放行出站 8080 端口。

2. DNS 解析檢查

對比測試與正式環境域名解析結果：

dig bcsz.xms.foxhis.com
dig xms.foxhis.com

若正式環境域名解析到內網 IP，而 PHP 所在伺服器無路由，需配置 hosts 或調整 DNS。

3. WSDL 內部端點地址

部分 WebService 的 WSDL 內部 <soap:address location="..."/> 可能指向內網 IP。解決方案：

• 下載 WSDL 至本地，修改 endpoint 地址為可訪問的公網 IP/域名。
• 實例化時指定 'location' => 'https://public-ip:8080/...' 覆蓋 WSDL 內部地址。

4. PHP 環境差異

• 確認 php.ini 中 openssl、soap 擴展已啟用。
• 檢查 allow_url_fopen 設置。
• 對比測試/正式機 PHP 版本與擴展版本差異。

5. 目標服務狀態

聯繫正式環境運維確認：WebService 進程是否運行、端口監聽正常、並發連接數未達上限。

調試技巧

啟用 SoapClient 追蹤：

$client = new SoapClient($url, ['trace' => 1, 'exceptions' => 0]);
try {
    $result = $client->getRoomAmount(['arg0' => $postjson]);
} catch (SoapFault $f) {
    var_dump($client->__getLastRequest());
    var_dump($client->__getLastResponse());
    var_dump($client->__getLastRequestHeaders());
    var_dump($client->__getLastResponseHeaders());
}

通過請求/響應頭定位具體失敗環節。