PHP中整合了XML-RPC和SOAP兩種協定的訪問,都是集中在xmlrpc擴充當中。另外,在PHP的PEAR中,不管是PHP 4還是PHP 5,都已經預設集成了XML-RPC擴展,而且該擴展跟xmlrpc擴展無關,能夠獨立實現XML-RPC的協議交互,如果沒有xmlrpc擴展,建議使用PEAR::XML-RPC擴充。
Web Service介紹
Web Service就是為了異質系統的通訊而產生的,它基本的想法就是使用基於XML的HTTP的遠端呼叫提供一個標準的機制,而省去建立一種新協定的需求。目前進行Web Service通訊有兩種協定標準,一種是XML-RPC,另一種是SOAP。 XML-RPC比較簡單,出現時間比較早,SOAP比較複雜,主要是一些需要穩定、健壯、安全且複雜互動的時候使用。
我們這裡主要是以XML-RPC來簡單描述Web Service的互動過程,部分內容來自PHP手冊,更詳細內容,建議參考手冊。
安裝xmlrpc擴充
如果你的系統中沒有安裝xmlrpc的php擴展,那麼請正確安裝。
在Windows平台下,先把PHP安裝目錄下的擴充php_xmlrpc.dll放到C:Windows或C:Winnt目錄下,(PHP4的擴充在C:phpextensions目錄中,PHP5的擴充在C: phpext目錄中),同時在C:Windowsphp.ini或C: Winntphp.ini中把extension=php_xmlrpc.dll前面的分號";"去掉,然後重新啟動Web伺服器後查看phpinfo ()有沒有XML-RPC專案就能夠確定是否已經正確安裝xmlrpc擴充。
在Unix/Linux平台下,如果沒有安裝xmlrpc擴展,請在重新編譯PHP,在configure的時候請加入--with-xmlrpc 選項,然後查看phpinfo()看是否正常安裝xmlrpc。
(注意:以下操作都是建立在xmlrpc擴張正常安裝前提下,請務必正確安裝。)
XML-RPC工作原理
XML-RPC大致就是整個過程就是使用XML來進行通訊。先建構一個RPC 伺服器端用來出來從RPC客戶端傳遞過來的使用XML封裝的請求,並且把處理結果透過XML的形式傳回RPC客戶端,客戶端就去分析XML取得自己需要的資料。
XML-RPC的伺服器端必須有現成的函數提供給客戶端調用,且客戶端提交的請求中的函數和方法必須與伺服器端的一致,否則將無法取得所需的結果。
下面我進行簡單的程式碼來描述整個過程。
XML-RPC實踐
伺服器端使用xmlrpc_server_create函數產生一個伺服器端,然後把需要需要暴露的RPC呼叫介面進行註冊,接受RPC客戶端POST過來的XML數據,然後進行處理,處理結果透過XML的形式顯示給客戶端。
程式碼如下: rpc_server.php
<?php
/**
* 函數:提供給RPC客戶端呼叫的函數
* 參數:
* $method 用戶端需要呼叫的函數
* $params 用戶端需要呼叫的函數的參數數組
* 傳回:傳回指定呼叫結果
*/
function rpc_server_func($method, $params) {
$parameter = $params[0];
if ($parameter == "get"){
$return = ''This data by get method'';
}else{
$return = ''Not specify method or params'';
}
return $return;
}
//產生一個XML-RPC的伺服器端
$xmlrpc_server = xmlrpc_server_create();
//註冊一個伺服器端呼叫的方法rpc_server,實際指向的是rpc_server_func函數
xmlrpc_server_register_method($xmlrpc_server, "rpc_server", "rpc_server_func");
//接受客戶端POST過來的XML數據
$request = $HTTP_RAW_POST_DATA;
//執行呼叫客戶端的XML請求後取得執行結果
$xmlrpc_response = xmlrpc_server_call_method($xmlrpc_server, $request, null);
//把函式處理後的結果XML輸出
header(''Content-Type: text/xml'');
echo $xmlrpc_response;
//銷毀XML-RPC伺服器端資源
xmlrpc_server_destroy($xmlrpc_server);
?>
伺服器端建構好了,那麼再建構我們的RPC客戶端。客戶端大致透過Socket存取XML-RPC伺服器端的80端口,然後把需要調用的RPC接口封裝到XML裡,透過POST請求提交給RPC伺服器端,最後取得伺服器端返回結果。
程式碼如下:rpc_client.php
<?php
/**
* 函數:提供給客戶端進行連接XML-RPC伺服器端的函數
* 參數:
* $host 需要連接的主機
* $port 連接主機的端口
* $rpc_server XML-RPC伺服器端文件
* $request 封裝的XML請求訊息
* 傳回:連線成功成功回傳由伺服器端傳回的XML訊息,失敗回傳false
*/
function rpc_client_call($host, $port, $rpc_server, $request) {
//開啟指定的伺服器端
$fp = fsockopen($host, $port);
//建構需要進行通訊的XML-RPC伺服器端的查詢POST請求訊息
$query = "POST $rpc_server HTTP/1.0nUser_Agent: XML-RPC ClientnHost: ".$host."nContent-Type: text/xmlnContent-Length: ".strlen($request)."n n".$request."n";
//把建構好的HTTP協定傳送給伺服器,失敗回傳false
if (!fputs($fp, $query, strlen($query))) {
$errstr = "Write error";
return false;
}
//取得從伺服器端傳回的所有訊息,包括HTTP頭和XML訊息
$contents = '''';
while (!feof($fp)){
$contents .= fgets($fp);
}
//關閉連線資源後回傳所取得的內容
fclose($fp);
return $contents;
}
//建構連接RPC伺服器端的信息
$host = ''localhost'';
$port = 80;
$rpc_server = ''/~heiyeluren/rpc_server.php'';
//把需要傳送的XML請求編碼成XML,需要呼叫的方法是rpc_server,參數是get
$request = xmlrpc_encode_request(''rpc_server'', ''get'');
//呼叫rpc_client_call函式把所有請求傳送給XML-RPC伺服器端後取得訊息
$response = rpc_client_call($host, $port, $rpc_server, $request);
//分析從伺服器端回傳的XML,去掉HTTP頭信息,並且把XML轉為PHP能辨識的字串
$split = ''<?xml version="1.0" encoding="iso-8859-1"?>'';
$xml = explode($split, $response);
$xml = $split . array_pop($xml);
$response = xmlrpc_decode($xml);
//輸出從RPC伺服器端取得的資訊
print_r($response);
?>
大致上我們上面的例子就是提交一個叫做rpc_server的方法過去,參數是get,然後獲取伺服器端的返回,伺服器端返回的XML資料是:
<?xml version="1.0" encoding="iso-8859-1 "?>
<methodResponse>
<params>
<param>
<value>
<string>This data by get method</string>
</value>
</param>
</params>
</methodResponse>
那麼我們再透過xmlrpc_decode函數把這個XML編碼為PHP的字串,我們就能夠隨意處理了,整個Web Service互動完成。
結束語
不管是XML-RPC也好,SOAP也罷,只要能夠讓我們穩定、安全的進行遠端過程的調用,完成我們的項目,那麼就算整個Web Service就是成功的。另外,如果可以的話,也可以嘗試使用PEAR中的XML-RPC來實現上面類似的操作,說不定會更簡單,更適合你使用。
簡單的使用XML-RPC進行Web Service互動就完成了,部分程式碼參考PHP手冊,想取得詳細資訊建議參考手冊,如果文章有不正確,請指正。
本篇文章來自PHP資訊原文連結:http: //www.phpchina.com/html/84/n-33884.html