函式名稱:SoapServer::__construct()
函式描述:建構函式用於建立一個SoapServer物件。 適用版本:PHP 5, PHP 7
用法:
SoapServer::__construct ( mixed $wsdl [, array $options ] )
引數:
- $wsdl:必需,表示Web服務描述語言(WSDL)檔案的URL或本地檔案路徑。如果為NULL,則表示建立一個SOAP伺服器端點,該端點可以接收任何有效的SOAP訊息。
- $options:可選,一個包含多個選項的關聯陣列。可以使用以下選項:
- 'uri':設定伺服器端點的URI。
- 'soap_version':設定使用的SOAP版本。可以是SOAP_1_1或SOAP_1_2。
- 'encoding':設定使用的編碼方式。預設為UTF-8。
- 'features':設定使用的SOAP特性。可以是SOAP_SINGLE_ELEMENT_ARRAYS、SOAP_WAIT_ONE_WAY_CALLS或SOAP_USE_XSI_ARRAY_TYPE。
- 'classmap':設定用於將SOAP型別對映到PHP類的類對映陣列。
- 'cache_wsdl':設定是否快取WSDL檔案。預設為WSDL_CACHE_NONE。
返回值:無
示例:
// 建立一個SOAP伺服器,使用預設選項
$server = new SoapServer('example.wsdl');
// 建立一個SOAP伺服器,設定選項
$options = array(
'uri' => 'http://example.com/soap-server',
'soap_version' => SOAP_1_2,
'encoding' => 'ISO-8859-1',
'features' => SOAP_SINGLE_ELEMENT_ARRAYS,
'classmap' => array(
'MyClass' => 'MyClass',
'AnotherClass' => 'AnotherClass'
),
'cache_wsdl' => WSDL_CACHE_BOTH
);
$server = new SoapServer('example.wsdl', $options);
上述示例中,第一個示例建立了一個簡單的SOAP伺服器,使用了預設選項。第二個示例建立了一個SOAP伺服器,設定了URI、SOAP版本、編碼方式、SOAP特性、類對映和WSDL快取選項。
注意:在使用SoapServer之前,必須先建立一個WSDL檔案,用於描述Web服務的介面和方法。