函式名稱:SoapClient::__construct()
適用版本:PHP 5, PHP 7
用法:SoapClient::__construct()函式用於建立一個SOAP客戶端物件。
語法:__construct ([ mixed $wsdl [, array $options ]] )
引數:
wsdl(可選):指定要使用的WSDL檔案的URL(Web服務描述語言)。如果省略此引數,則必須在後續呼叫
SoapClient::setLocation()
方法之前呼叫SoapClient::setWsdl()
方法設定WSDL檔案。options(可選):一個關聯陣列,用於配置SOAP客戶端的選項。下面是一些常用的選項:
- location:指定Web服務的URL地址。
- uri:指定名稱空間URI(Uniform Resource Identifier)。
- trace:設定為true時,將在呼叫過程中記錄請求和響應的SOAP訊息。
- exceptions:設定為true時,將在發生SOAP錯誤時丟擲異常。
返回值:建立的SoapClient物件。
示例:
// 建立一個SOAP客戶端物件
$client = new SoapClient("http://example.com/soap/wsdl");
// 使用建立的SOAP客戶端物件呼叫遠端Web服務方法
$result = $client->someMethod($param1, $param2);
// 列印呼叫結果
var_dump($result);
注意事項:
- 如果使用了WSDL檔案,
SoapClient::__construct()
函式將自動根據WSDL檔案的定義建立可用的方法。 - 在建立SOAP客戶端物件之後,可以使用該物件呼叫遠端Web服務的方法。
- 如果需要在呼叫之前設定WSDL檔案或修改其他選項,可以使用
SoapClient::setWsdl()
和SoapClient::setOptions()
方法。 - 如果設定了
trace
選項為true,可以使用SoapClient::__getLastRequest()
和SoapClient::__getLastResponse()
方法獲取請求和響應的SOAP訊息。 - 在PHP 7中,可以使用
SoapClient::__soapCall()
方法替代直接呼叫方法。
以上是SoapClient::__construct()函式的詳細用法和示例。