作者:samisa
以下文中的翻譯名稱對照表 :
payload: 交談內(nèi)容
object: 實例
function: 函數(shù)
使用 php來實現(xiàn)網(wǎng)絡(luò)服務(wù)
使用框架： WSO2 WSF/PHP
安裝環(huán)境： windows 或者 linux
（厭惡于眼下計算機文章夾雜無數(shù)難懂的翻譯以及術(shù)語，此處盡量使用口語以及漢語。）
WSMessages 類：
在調(diào)用網(wǎng)絡(luò)服務(wù)的過程中，需要兩個消息，發(fā)送的消息和接受的消息，又來有往方能來往不是。 WSMessages 這個類就是在 Web services framework for php (簡稱 WSF)這個開源框架中，用來封裝這兩個消息的類。
WSMessages 有一個很重要的變量 str來保存消息內(nèi)容，以 xml格式來保存“有效的載荷” (他們把這個叫做 payload，我查英文字典，就是這個意思，但是它來回的出現(xiàn)，反復(fù)的出現(xiàn)，今觀之，也就是交談內(nèi)容，實際上就是除去那些 xml的定義，以及一些其他的所謂‘命名空間' ->namespace的定義而已。要搞清楚什么是命名空間，請查看 xml的 W3C定義 )。有效載荷實在是莫名其妙，我以后還是用‘交談內(nèi)容'來指代它把。
如果你通過客戶程序發(fā)送一個請求，那么你需要構(gòu)造一個 WSMessage 的實例，并且用 xml形式的交談內(nèi)容填寫好這個實例。對應(yīng)請求的回應(yīng)，也還是一個‘交談內(nèi)容'會通過你的程序返回，并且返回的東西也仍然是一個 WSMessage 實例。
也就是說，你的客戶端函數(shù)掉應(yīng)一個網(wǎng)絡(luò)服務(wù)，那么他的返回值也是一個 WSMessage 實例。
你可以在一個函數(shù)中發(fā)送請求，調(diào)用網(wǎng)絡(luò)服務(wù)的程序，并且把返回內(nèi)容放在 WSMessage實例中，并且讓函數(shù)返回這個 WSMessage實例。
WSMessage 更傾向于發(fā)送和接受比較復(fù)雜的內(nèi)容比如有附件什么的。下面就來詳細解釋一下如何使用 WSMessage 來實現(xiàn)客戶端和服務(wù)端的交流。
處理交談內(nèi)容：
在此之前已經(jīng)講解過如何使用 php來創(chuàng)建網(wǎng)絡(luò)服務(wù)，并且已經(jīng)做了一個簡單的客戶 -服務(wù)端程序來說明工作流程。但是這些程序并沒有深入的解釋我們怎么處理‘交談內(nèi)容'。換句話來說，我們只是把 xml格式的交談內(nèi)容發(fā)送到了服務(wù)端，但并沒有想到去處理它。在這里，我們來詳細的解釋一下如何處理交談內(nèi)容并且把它用到計算程序中去。
交談內(nèi)容是一個商業(yè)邏輯定義的內(nèi)容，并且用 SOAP（ Simple Object Access Protocol）來封裝的，（請參見 SOAP w3c的文章）。讓我們用個例子來說明如何計算一個階乘吧。
客戶端需要發(fā)送的交談內(nèi)容：
<getFactorial>
<param>6</param>
</getFactorial>
服務(wù)端需要明白這個交談內(nèi)容并且把變量分辨出來并且計算它的階乘。下面就是服務(wù)端程序：
function getFactorial ( $message ) {
$simplexml = new SimpleXMLElement ( $message -> str ) ;
$value = $simplexml -> param [ 0 ] ;
$result = factorial ( $value ) ;
$responsePayloadString = <<<XML
<getFactorialResponse>
<result> $result </result>
</getFactorialResponse>
XML;
return $responsePayloadString ;
}
第 3行，我們用輸入的‘交談內(nèi)容'創(chuàng)建了一個 simpleXmlElement 的實例。你可以看到，輸入的交談內(nèi)容被保存到了通過函數(shù)參數(shù)傳遞進來的 WSMessage 實例 $message的 str變量中。注： SimpleXml是一個 php的擴展，用于處理 xml文件或者字符串。 WSO2 WSF/PHP并沒有規(guī)定我們必須使用哪一個 php擴展來處理 xml。你可以使用你喜歡的人和 xml php 擴展來處理，比如 domdocument， saxdom之類。
第 4行將交談內(nèi)容中的參數(shù)值提取出來，這表示服務(wù)程序需要知道如何理解這些參數(shù)，比如說參數(shù)類型之類的東西。（正常來說需要在交談內(nèi)容中說明這個參數(shù)的類型）。函數(shù)中剩下的就是正常的處理階乘。在第六行，階乘通過調(diào)用其他函數(shù)被計算出來。從 8到 12行，回復(fù)的交談內(nèi)容也被寫好并且準被返回此內(nèi)容。第 14行我們返回回復(fù)的交談內(nèi)容。
回復(fù)的交談內(nèi)容應(yīng)該差不多是這樣的：
<getFactorialResponse>
<result>720</result>
</getFactorialResponse>
同樣的，客戶端也可以用同樣的方法處理回復(fù)的交談內(nèi)容：
$response = $client -> request ( $reqestPayloadString ) ;
$simplexml = new SimpleXMLElement ( $response -> str ) ;
echo "Result = " . $simplexml -> result [ 0 ] . "<br/>" ;
在第 3行，用回復(fù)的交談內(nèi)容創(chuàng)建了一個 SimpleXMLElement 實例。同樣的 $response 也是一個 WSMessage的實例，我們可以訪問他的成員變量 str，這個變量保存了 xml格式的回復(fù)的交談內(nèi)容。我們把它交給一個 SimpleXMLElement 構(gòu)造函數(shù)，由此創(chuàng)建一個 SimpleXMLElement的實例。然后我們就可以訪問結(jié)果元素 (或者叫節(jié)點？ element， xml里面可以稱之為元素，但對于樹狀結(jié)構(gòu)的它來說，節(jié)點也不為過？ )
現(xiàn)在你應(yīng)該學(xué)會如何處理交談信息中的內(nèi)容，不管是客戶端的申請也好還是服務(wù)端的回應(yīng)也好。
注：在服務(wù)端的 getFactorial函數(shù) (14行 )，你可以之間返回一個 WSmessage而不是一個回復(fù)的交談內(nèi)容。你可以用下面的這一小段程序來實現(xiàn)這個功能。
$outMessage = new WSMessage( $responsePayloadString );
return $outMessage ;
這其實也就是說服務(wù)端程序及可以返回 xml格式的交談內(nèi)容也可以返回 WSMessage的實例
完整的程序?qū)⒃谶@篇文章的末尾附上。
跟蹤消息
通過 WSO2 Web services framework for PHP ,你可以跟蹤 SOAP消息被客戶端發(fā)出，然后客戶端又收到了來自服務(wù)端的消息，（即他們的交談內(nèi)容）。網(wǎng)絡(luò)客戶服務(wù)類， WSClient 有兩個函數(shù)可以實現(xiàn)這個目的： getLastReauest()和 getLastResponse()?？蛻舳嗽谑褂?request()這個函數(shù)以后，你可以通過這兩個函數(shù)去得到交談信息。
$response = $client -> request ( $reqestPayloadString ) ;
printf ( "<br/> Request = %s </br>" ,
htmlspecialchars ( $client -> getLastRequest ())) ;
printf ( "<br/> Response = %s </br>" ,
htmlspecialchars ( $client -> getLastResponse ())) ;
以上的程序片段會顯示 request()這個函數(shù)實現(xiàn)的請求與回復(fù)的內(nèi)容。
實際上，這段程序差不多會輸出這樣的東西：
Request = <soapenv:Envelope xmlns:soapenv="http://www.w3.org/2003/05/soap-envelope"><soapenv:Header/><soapenv:Body><getFactorial> <param>6</param> </getFactorial></soapenv:Body></soapenv:Envelope>
Response = <soapenv:Envelope xmlns:soapenv="http://www.w3.org/2003/05/soap-envelope"><soapenv:Header/><soapenv:Body><getFactorialResponse> <result>720</result> </getFactorialResponse></soapenv:Body></soapenv:Envelope>
跟蹤 SOAP消息對于研究呼叫的服務(wù)是非常有用的，特別是對于查找服務(wù)和客戶端的 bug。比如說，你可以確認所有的客戶端發(fā)出的消息以及服務(wù)端回復(fù)的消息，并且，你可以確認交談內(nèi)容的格式 (客戶端的以及服務(wù)端的。 )
Debugging(這個詞是如此的普遍，那么我在這里就不翻譯它了，盡管我的夢想是有一天程序用中文來寫，顯而易見的是這個夢已經(jīng)離我們越來越遙遠。 )
用戶在使用 php WSF有時會碰到兩個問題：
安裝 wsf。 你怎么能確定這個 wsf已經(jīng)正常工作了？好吧，第一，你可以通過 phpinfo()這個函數(shù)來檢查， (要是你不知道這個函數(shù)以及怎么使用它，呃，查查 php手冊吧。 ) 你只需要創(chuàng)建一個 php文件，并且在上面寫下這幾句話，然后用個瀏覽器打開它。
<?php
phpinfo () ;
?>
如果所有的擴展都被正確的安裝的話，你會找到一個項目叫 wsf，在一個以 wsf作為標題的表里，你應(yīng)當看到 'wsf support'之類的字樣。這個東東是在 php.ini里定義的，（或者比如說我就沒有在 php.ini 里面定義而是在 /etc/php5/conf.d/里寫了一個新的文件叫做 wsf.ini，實際上這個文件夾里面所有的文件到后來都會被合并到 php.ini里，所有如果你沒有在 php.ini里找到相應(yīng)的設(shè)置但是你的 wsf缺能用，你不妨來這里看看。 )
如果這個擴這沒有顯示在 phpinfo里，那么你需要去找安裝指南來好好研究一下，如果找不到可以給我發(fā) email： ferdinandfly@yahoo.ca
當你成功的安裝了以后，第二個問題就是你好像并不能讓這個例子正確運行。同樣的，你需要檢查一些設(shè)置是否正確。 首先是 php.ini記錄中，經(jīng)常會設(shè)置一些日志文件的路徑，也許他不存在或者是說他設(shè)定的路徑 php5無法讀寫。還有，你應(yīng)到確認 php.ini是否包含了一些腳本文件，而這些腳本文件都是可讀的。
如果以上的這些都是正確的但是 wsf就是不干活，你可以查看一下日志文件。日志文件會被寫到 wsf.log_path這條記錄所確定的路徑中。這個東東在 php.ini里進行設(shè)定。如果他沒有被設(shè)定，那么 log就在 /tmp里（ linux）。需要知道的是，在 windows平臺中，默認的路徑很可能不存在，因此你必須為他指定一個日志路徑。和服務(wù)有關(guān)的日志記錄在 wsf_php_server.log中，和客戶端有關(guān)的保存在 wsf_php_client.log中，如果你的客戶機和服務(wù)主機不是一臺機器，那么這兩個文件都在服務(wù)器上哦。你可以通過調(diào)節(jié)記錄的等級來獲得不同詳細程度的日志文件。如果是調(diào)試，你可以把它設(shè)置為 level 4，當然如果是成熟的軟件，你可以設(shè)置為 0（僅僅是嚴重錯誤）或者是 1（錯誤）。
如果你想確認來往的交談內(nèi)容（ SOAP）是你所想要的格式的話，你可以用 SOAP 消息跟蹤來調(diào)試，正如我們前面所講的。
總結(jié)：
在這篇文章中，我解釋了 WSMessage這個類以及怎樣處理交談內(nèi)容并且使用它，客戶端或者服務(wù)端都可以通過調(diào)用 str這個 WSMessage的成員變量來獲得交談內(nèi)容（ xml）。通常交談內(nèi)容的格式都是通過 WSDL來定義的，因此我們要求客戶端和服務(wù)端需要遵守同樣的格式是合理的。下一章我們會討論如何通過 WSO2 WSF/PHP和 WSDL協(xié)同工作 .