函式名稱:SoapClient::__setLocation()
適用版本:PHP 5 >= 5.0.1, PHP 7, PHP 8
函式描述:該函式用於設定SOAP客戶端請求的目標位置(即Web服務的URL)。它允許在呼叫Web服務之前更改目標位置。
語法:public SoapClient::__setLocation(string $new_location): bool
引數:
- $new_location:新的目標位置,即Web服務的URL。它是一個字串型別。
返回值:該函式返回一個布林值。如果成功設定目標位置,則返回true,否則返回false。
示例:
// 建立一個SOAP客戶端物件
$client = new SoapClient('http://example.com/webservice.wsdl');
// 獲取當前的目標位置
$current_location = $client->__getLocation();
echo "當前目標位置:" . $current_location . "<br>";
// 設定新的目標位置
$new_location = 'http://example.com/new_webservice';
$result = $client->__setLocation($new_location);
// 檢查是否成功設定目標位置
if ($result) {
echo "目標位置設定成功!<br>";
} else {
echo "目標位置設定失敗!<br>";
}
// 再次獲取當前的目標位置
$current_location = $client->__getLocation();
echo "新的目標位置:" . $current_location . "<br>";
上述示例中,首先建立了一個SOAP客戶端物件。然後,透過呼叫__getLocation()
方法獲取當前的目標位置,並將其輸出到螢幕上。接下來,使用__setLocation()
方法將新的目標位置設定為"http://example.com/new_webservice"。然後,透過檢查返回值,判斷是否成功設定目標位置,並將結果輸出到螢幕上。最後,再次呼叫`__getLocation()`方法獲取新的目標位置,並將其輸出到螢幕上。
請注意,__setLocation()
方法是在SOAP客戶端物件上呼叫的,而不是在SOAP服務物件上呼叫。