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