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

原文地址：PHP SOAP 擴(kuò)展，本文在原文基礎(chǔ)上添加了一些內(nèi)容和章節(jié)，也加入了一些注釋，請讀者注意。

前兩篇文章 《SOAP 介紹》 和 《SOAP Web 服務(wù)介紹》 已經(jīng)對 SOAP 相關(guān)知識做了比較詳細(xì)的介紹。現(xiàn)在以 PHP 的 SOAP 擴(kuò)展為例，綜合運(yùn)用一下學(xué)習(xí)到的知識。

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

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

SOAP 擴(kuò)展支持以下規(guī)范：

SOAP 1.1

SOAP 1.2

WSDL 1.1

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

這個擴(kuò)展使用 GNOME XML 庫來處理XML。

這個擴(kuò)展實(shí)現(xiàn)了6個類。其中有三個高級的類，它們的方法很有用，它們是 SoapClient、SoapServer 和SoapFault。另外三個類除了構(gòu)造器外沒有其它別的方法，這三個是低級的類，它們是 SoapHeader、SoapParam 和 SoapVar。

SOAP 擴(kuò)展關(guān)系圖：

上圖并不是很準(zhǔn)確，因?yàn)?SoapServer 也可以在響應(yīng)時發(fā)送 SoapHeader。所有會有下面這個更加準(zhǔn)確的關(guān)系圖：

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

WSDL 模式

Non-WSDL 模式

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

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

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

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

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

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

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

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

這個類可以用來描述 SOAP headers。它只是一個只包含構(gòu)造器方法的數(shù)據(jù)容器。

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

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

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

SoapHeader 類用來構(gòu)造 SOAP 頭，SOAP 頭可以對 SOAP 的能力進(jìn)行必要的擴(kuò)展。SOAP 頭的一個主要作用就是用于簡單的身份認(rèn)證。

Web Services 有兩種實(shí)現(xiàn)模式：契約先行（Contract first）模式和代碼先行（Code first）模式。

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

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

這一節(jié)介紹如何使用 WSDL 模式和 non-WSDL 模式來實(shí)現(xiàn)服務(wù)和客戶端。相對而言，使用 WSDL 模式來實(shí)現(xiàn)服務(wù)和客戶端會比較容易，假定已經(jīng)有一個定義好了接口的 WSDL 文件。因此這一節(jié)會先介紹如何使用 WSDL 模式實(shí)現(xiàn)一個 Web Service。

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

extension = php_soap.dll

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

[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

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

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

下面是 WSDL 模式的服務(wù)使用 SOAP 擴(kuò)展來實(shí)現(xiàn)提供服務(wù)的代碼：

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

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

在這個服務(wù)的實(shí)現(xiàn)過程中，函數(shù)實(shí)現(xiàn)了WSDL所定義的服務(wù)操作 greet，greet 操作有一個 WSDL 指定的參數(shù)，按照 greet 操作的語義，這個參數(shù)是一個用戶的名字。最后 handle 調(diào)用了觸發(fā)處理請求的服務(wù)對象。

客戶端代碼如下:

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());
}

客戶端代碼中，首先創(chuàng)建一個使用 WSDL 文件作參數(shù)的 SoapClient 實(shí)例。接著使用 __soapCall() 調(diào)用 greet 方法，并傳入?yún)?shù)。

下面是客戶端所發(fā)送的 SOAP 請求：

    
        
            Suhua
        
    

下面是服務(wù)端響應(yīng)上訴請求而發(fā)送的 SOAP 響應(yīng)：

    
        
            Hello Suhua
        
    

上面的 SOAP 消息都是利用 WSDL 模式下的服務(wù)端和客戶端來獲取的（可以使用 __getLastResponse 和 __getLastRequest 這兩個方法獲取，前提是客戶端初始化時，要把 trace 參數(shù)設(shè)置為 true）。也可以利用 non-WSDL 模式的服務(wù)端和客戶端來產(chǎn)生與上面相同的 SOAP 消息。但是，PHP 代碼必須有一點(diǎn)改變。下一節(jié)會說明如何使用 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 模式一樣首先實(shí)現(xiàn) greet 函數(shù)的功能，但是函數(shù)實(shí)現(xiàn)的方式跟 WSDL 模式稍稍有所不同。在 non-WSDL 模式中，我們必須返回一個 SoapParam 對象作為響應(yīng)，而不是一個數(shù)組。創(chuàng)建服務(wù)時，第一個參數(shù)設(shè)為 null，說明沒有提供 WSDL；接著傳遞一個選項(xiàng)作為參數(shù)，這個選項(xiàng)參數(shù)是服務(wù)的 URI。最后像 WSDL 模式一樣調(diào)用剩下的方法。

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 模式中，因?yàn)闆]有使用 WSDL，傳遞了一個包含服務(wù)所在位置（location）和服務(wù) URI 的參數(shù)數(shù)組作為參數(shù)。然后像 WSDL 模式中一樣調(diào)用 __soapCall() 方法，但是使用了 SoapParam 類用指定格式打包參數(shù)。返回的結(jié)果將獲取 greet 方法的響應(yīng)。

注：客戶端實(shí)例化時所傳入的服務(wù) URI，實(shí)際上，我們可以把它看作該服務(wù)的一個命名空間（namespace）?？蛻舳怂鶄魅氲?URI 必與服務(wù)端所命名的 URI 一樣。

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

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

PHP SOAP 擴(kuò)展

PHP SOAP Extension

PHP SOAP 擴(kuò)展詳解