摘要：類也是一個只包含構造器的低級類，與和類相似。安裝擴展對于平臺，需要在中加入如下代碼上面的工作完成之后，還需要注意的是擴展在配置文件中有獨立的代碼片段這些配置項主要是用來指定處理文件時使用緩存的行為。支持與擴展類似的。

原文地址：PHP SOAP 擴展，本文在原文基礎上添加了一些內容和章節，也加入了一些注釋，請讀者注意。

前兩篇文章 《SOAP 介紹》 和 《SOAP Web 服務介紹》 已經對 SOAP 相關知識做了比較詳細的介紹。現在以 PHP 的 SOAP 擴展為例，綜合運用一下學習到的知識。

PHP 的 SOAP 擴展可以用來提供和使用 Web Services。換句話說，PHP 開發者可以利用這個 PHP 擴展來寫他們自己的 Web Services，也可以寫一些客戶端來使用給定的 Web Services。

PHP5 中的這個 SOAP 擴展目的是為了實現 PHP 對 Web Services 的支持。與其它實現 PHP 對 Web Services 的支持的方法不同，SOAP 擴展是用 C 寫的，因此它比其它方法具有速度優勢。注：SOAP 擴展是在 PHP5 才開始提供，所以在此之前人們要使用 SOAP 去調用 Web Services 時，一般是使用第三方提供的 SOAP 封裝庫來實現，比如：NuSOAP。

SOAP 擴展支持以下規范：

SOAP 1.1

SOAP 1.2

WSDL 1.1

SOAP 擴展主要用來處理 RPC 形式的 Web Services。不過，你也可以使用文本形式的 WSDL 文件配合 WSDL 模式的服務端和客戶端。

這個擴展使用 GNOME XML 庫來處理XML。

這個擴展實現了6個類。其中有三個高級的類，它們的方法很有用，它們是 SoapClient、SoapServer 和SoapFault。另外三個類除了構造器外沒有其它別的方法，這三個是低級的類，它們是 SoapHeader、SoapParam 和 SoapVar。

SOAP 擴展關系圖：

上圖并不是很準確，因為 SoapServer 也可以在響應時發送 SoapHeader。所有會有下面這個更加準確的關系圖：

這個類用來使用 Web Services。SoapClient 類可以作為給定 Web Services 的客戶端。
它有兩種操作形式：

WSDL 模式

Non-WSDL 模式

在 WSDL 模式中，構造器可以使用 WSDL 文件名作為參數，并自動從 WSDL 中提取使用服務時所需要的信息。

Non-WSDL 模式中使用參數來設置使用服務時所需要的信息。這個類有許多可以用來使用服務的有用的方法。其中 SoapClient::__soapCall() 是最重要的。這個方法可以用來調用服務中的某個操作。

這個類可以用來提供 Web Services。與 SoapClient 類似，SoapServer 也有兩種操作模式：WSDL 模式和 non-WSDL模式。這兩種模式的意義跟 SoapClient 的兩種模式一樣。在 WSDL 模式中，服務實現了 WSDL 提供的接口；在 non-WSDL 模式中，參數被用來管理服務的行為。

在 SoapServer 類的眾多方法中，有三個方法比較重要。它們是 SoapServer::setClass()、SoapServer::addFunction() 和 SoapServer::handle()。

SoapServer::setClass()方法設定用來實現 Web Services 的類。SoapServer::setClass 所設定的類中的所有公共方法將成為 Web Services 的操作（operation）。

SoapServer::addFunction() 方法用來添加一個或多個作為 Web Services 操作（operation）的函數。

SoapServer:: handle() 方法指示 Web Services 腳本開始處理進入的請求。Web Services 腳本是用 PHP 腳本寫的一個或多個 SoapServer 對象的實例。盡管你可以有不止一個的 SoapServer 對象，但通常的習慣是一個腳本只擁有一個 SoapServer 實例。在調用 SoapServer::handle() 方法之前，Web Services 腳本會使用設置在 SoapServer 對象實例上的任何信息來處理進入的請求和輸出相應的內容。

這個類從 Exception 類繼承而來，可以用來處理錯誤。SoapFault 實例可以拋出或獲取 Soap 錯誤的相關信息并按程序員的要求處理。

這個類可以用來描述 SOAP headers。它只是一個只包含構造器方法的數據容器。

SoapParam 也是一個只包含構造器方法的數據容器。這個方法可以用來描述傳遞給 Web Services 操作的參數。在 non-WSDL 模式中這是一個很有用的類，可以用來傳遞所期望格式的參數信息。

SoapVar 也是一個只包含構造器的低級類，與 SoapHeader 和 SoapParam 類相似。這個類可以用來給一個Web Services 操作傳遞編碼參數。這個類對 non-WSDL 中傳遞類型信息是非常有用的。

注：SoapParam 和 SoapVar 主要用來封裝用于放入 SOAP 請求中的數據，他們主要在 non-WSDL 模式下使用。事實上，在 WSDL 模式下，SOAP 請求的參數可以通過數組方式包裝，SOAP 擴展會根據 WSDL 文件將這個數組轉化成為 SOAP 請求中的數據部分，所以并不需要這兩個類。而在 non-WSDL 模式下，由于沒有提供 WSDL 文件，所以必須通過這兩個類進行包裝。

SoapHeader 類用來構造 SOAP 頭，SOAP 頭可以對 SOAP 的能力進行必要的擴展。SOAP 頭的一個主要作用就是用于簡單的身份認證。

Web Services 有兩種實現模式：契約先行（Contract first）模式和代碼先行（Code first）模式。

契約先行模式使用了一個用 XML 定義的服務接口的WSDL文件。WSDL 文件定義了服務必須實現或客戶端可以使用的接口。SoapServer 和 SoapClient 的 WSDL 模式就基于這個概念。

在代碼先行模式中，首先要先寫出實現服務的代碼。然后在大多數情況下，代碼會產生一個契約（可以借助一些工具生成），換種說法，一個 WSDL 文件。接著客戶端在使用服務的時候就可以使用那個 WSDL 來獲得服務的接口及其他信息。盡管如此，PHP5 的擴展并沒有從代碼輸出一個 WSDL 的實現，考慮到這種情況，可以在 non-WSDL 模式下使用 SoapServer 和 SoapClient。

這一節介紹如何使用 WSDL 模式和 non-WSDL 模式來實現服務和客戶端。相對而言，使用 WSDL 模式來實現服務和客戶端會比較容易，假定已經有一個定義好了接口的 WSDL 文件。因此這一節會先介紹如何使用 WSDL 模式實現一個 Web Service。

對于 Windows 平臺，需要在 php.ini 中加入如下代碼：

extension = php_soap.dll

上面的工作完成之后，還需要注意的是 SOAP 擴展在配置文件中有獨立的代碼片段：

[soap]
; Enables or disables WSDL caching feature.
; http://php.net/soap.wsdl-cache-enabled
soap.wsdl_cache_enabled=1

; Sets the directory name where SOAP extension will put cache files.
; http://php.net/soap.wsdl-cache-dir
soap.wsdl_cache_dir="D:/wamp/tmp"

; (time to live) Sets the number of second while cached file will be used
; instead of original one.
; http://php.net/soap.wsdl-cache-ttl
soap.wsdl_cache_ttl=86400

; Sets the size of the cache limit. (Max. number of WSDL files to cache)
soap.wsdl_cache_limit = 5

這些配置項主要是用來指定 PHP 處理 WSDL 文件時使用緩存的行為。這幾個配置項分別說明：是否開啟 WSDL 文件緩存、文件緩存位置、緩存時間、以及最大緩存文件數量。啟用緩存會加快 PHP 處理 WSDL 文件的速度，但最好在調試代碼時關閉緩存，以避免一些因緩存行為而出現的問題。

在這個 Hello World 例子的服務中有一個被命名為 greet 的操作。這個操作有一個字符串形式的名字參數并返回一個字符串形式的 Hello + 名字。所用到的 WSDL 如下：

下面是 WSDL 模式的服務使用 SOAP 擴展來實現提供服務的代碼：

name;
    $result = [
        "greetReturn" => $value
    ];
    return $result;
}

$server = new SoapServer("hello.wsdl");
$server->addFunction("greet");
$server->handle();

在這個服務的實現過程中，函數實現了WSDL所定義的服務操作 greet，greet 操作有一個 WSDL 指定的參數，按照 greet 操作的語義，這個參數是一個用戶的名字。最后 handle 調用了觸發處理請求的服務對象。

客戶端代碼如下:

try {
    $client = new SoapClient("hello.wsdl");
    $result =  $client->__soapCall("greet", [
        ["name" => "Suhua"]
    ]);
    printf("Result = %s", $result->greetReturn);
} catch (Exception $e) {
    printf("Message = %s",$e->__toString());
}

客戶端代碼中，首先創建一個使用 WSDL 文件作參數的 SoapClient 實例。接著使用 __soapCall() 調用 greet 方法，并傳入參數。

下面是客戶端所發送的 SOAP 請求：

    
        
            Suhua
        
    

下面是服務端響應上訴請求而發送的 SOAP 響應：

    
        
            Hello Suhua
        
    

上面的 SOAP 消息都是利用 WSDL 模式下的服務端和客戶端來獲取的（可以使用 __getLastResponse 和 __getLastRequest 這兩個方法獲取，前提是客戶端初始化時，要把 trace 參數設置為 true）。也可以利用 non-WSDL 模式的服務端和客戶端來產生與上面相同的 SOAP 消息。但是，PHP 代碼必須有一點改變。下一節會說明如何使用 non-WSDL 模式。

function greet($param)
{
    $value = "Hello ".$param;
    return new SoapParam($value, "greetReturn");
}

$server = new SoapServer(null, [
    "uri" => "http://localhost/php-soap/non-wsdl/helloService"
]);

$server->addFunction("greet");
$server->handle();

在 non-WSDL 模式中，像 WSDL 模式一樣首先實現 greet 函數的功能，但是函數實現的方式跟 WSDL 模式稍稍有所不同。在 non-WSDL 模式中，我們必須返回一個 SoapParam 對象作為響應，而不是一個數組。創建服務時，第一個參數設為 null，說明沒有提供 WSDL；接著傳遞一個選項作為參數，這個選項參數是服務的 URI。最后像 WSDL 模式一樣調用剩下的方法。

try {
    $client = new SoapClient(null, [
        "location" => "http://localhost/php-soap/non-wsdl/hello_service_non_wsdl.php",
        "uri" => "http://localhost/php-soap/non-wsdl/helloService"
    ]);

    $result =  $client->__soapCall("greet", [
        new SoapParam("Suhua", "name")
    ]);

    printf("Result = %s", $result);
} catch (Exception $e) {
    printf("Message = %s",$e->__toString());
}

在 non-WSDL 模式中，因為沒有使用 WSDL，傳遞了一個包含服務所在位置（location）和服務 URI 的參數數組作為參數。然后像 WSDL 模式中一樣調用 __soapCall() 方法，但是使用了 SoapParam 類用指定格式打包參數。返回的結果將獲取 greet 方法的響應。

注：客戶端實例化時所傳入的服務 URI，實際上，我們可以把它看作該服務的一個命名空間（namespace）。客戶端所傳入的 URI 必與服務端所命名的 URI 一樣。

這篇文章介紹了 SOAP 擴展，可以在 PHP 中通過它來提供和使用 Web Services。PHP SOAP 擴展的強項是它的簡單和快速。使用 C 寫的 SOAP 擴展來運行服務端和客戶端是非常簡單的。雖然 SOAP 擴展在處理一些簡單的 Web Services 時很有用，但是當用它來處理所有的 Web Services 時就表現出它的局限性。WSO WSF/PHP 就是為了彌補 PHP 擴展的缺陷而開發的，它是開源的，可以實現 SOAP 類似的功能并且支持 MTOM，WS-Addressing，WS- Security 和 WS-RelaiableMessaging。WSO2 WSF/PHP 支持與 SOAP 擴展類似的 API。我們正計劃將 API 打包起來提供跟 SOAP 擴展一樣的 API，會用 C 來寫。

這篇文章的原文 PHP SOAP Extension，中文譯文 PHP SOAP 擴展。在轉載這篇文章的時候，對文章添加了一些注釋以及本人的一些見解，而且例子也是重新編寫的，所以與原文比會有所不同。本文的所有代碼將會被放到 notes 倉庫中，方便以后翻閱和復習。（本文已存檔 GitHub）

PHP SOAP 擴展

PHP SOAP Extension

PHP SOAP 擴展詳解