PHP SOAP擴展使用指南：從零構建Web服務的完整教程

M66 2025-10-28

PHP SOAP擴展使用指南：從零構建Web服務

在現代Web開發中，Web服務已成為系統間數據交互的重要方式。 SOAP（Simple Object Access Protocol，簡單對象訪問協議）作為一種基於XML的通信協議，被廣泛用於不同平台、語言間的遠程調用。本文將帶你深入了解如何使用PHP的SOAP擴展來創建和使用Web服務。

安裝與配置SOAP擴展

在開始開發之前，需要確保PHP環境已正確安裝並啟用了SOAP擴展。請按照以下步驟操作：

打開PHP安裝目錄下的php.ini配置文件。
找到以下配置項，並移除前面的分號以啟用SOAP擴展：

 ;extension=php_soap.dll

保存文件後重啟Web服務器，使配置生效。

完成上述步驟後，SOAP擴展即可使用。

創建SOAP Web服務

下面通過一個簡單的示例來演示如何創建PHP SOAP服務器。新建文件soap_server.php並添加以下代碼：

<?php
class HelloWorld {
    public function sayHello() {
        return "Hello, World!";
    }
}

$options = array(
    'uri' => &#39;http://localhost/soap_server.php&#39;
);

$server = new SoapServer(null, $options);
$server->setClass(&#39;HelloWorld&#39;);
$server->handle();
?>

在以上代碼中：

定義了一個名為HelloWorld的類，其中的sayHello()方法返回一個簡單的問候語。
使用SoapServer創建了一個SOAP服務器並指定URI地址。
通過setClass()方法將類與服務器綁定，並調用handle()方法處理客戶端請求。

創建SOAP客戶端

接下來，我們編寫一個客戶端腳本來調用剛剛創建的SOAP服務。新建文件soap_client.php並輸入以下代碼：

<?php
$options = array(
    'uri' => &#39;http://localhost/soap_server.php&#39;,
    &#39;location&#39; => &#39;http://localhost/soap_server.php&#39;
);

$client = new SoapClient(null, $options);
$result = $client->sayHello();

echo $result;
?>

在這個示例中：

SoapClient類用於創建SOAP客戶端實例。
通過配置uri和location參數與服務器進行通信。
調用sayHello()方法即可從服務端獲取返回的結果。

運行與測試Web服務

將soap_server.php和soap_client.php文件放入Web服務器的根目錄中。然後：

訪問http://localhost/soap_server.php可測試服務器是否正常響應。
訪問http://localhost/soap_client.php則可看到返回的結果Hello, World! 。

如果輸出正確，說明SOAP服務和客戶端通信成功。

總結

通過以上步驟，我們實現了一個基礎的PHP SOAP Web服務示例。從安裝配置到服務端、客戶端的創建與調用，SOAP為PHP開發者提供了一種穩定、高效的遠程通信方案。熟悉這些基礎知識後，你可以根據業務需求擴展更複雜的服務接口，實現系統間的靈活交互。