|
一、概述:
目前進行Web Service通信有兩種協(xié)議標(biāo)準(zhǔn),一種是XML-RPC,另外一種是SOAP。XML-RPC比較簡單,出現(xiàn)時間比較早,SOAP比較復(fù)雜,主要是一些需要穩(wěn)定、健壯、安全并且復(fù)雜交互的時候使用。
php自身就集成了XML-RPC和SOAP兩種協(xié)議的訪問,都是集中在xmlrpc擴展當(dāng)中。另外,在php的PEAR中,不管是php 4還是php 5,都已經(jīng)默認集成了XML-RPC擴展,而且該擴展跟xmlrpc擴展無關(guān),能夠獨立實現(xiàn)XML-RPC的協(xié)議交互,如果沒有xmlrpc擴展,建議使用PEAR::XML-RPC擴展。
我們這里主要是以XML-RPC來簡單描述Web Service的交互過程,部分內(nèi)容來自php手冊,更詳細的內(nèi)容,讀者可以參考手冊。
二、安裝xmlrpc擴展:
如果你的系統(tǒng)中沒有安裝xmlrpc的php擴展,那么請正確安裝。
在Windows平臺下,首先把php安裝目錄下的擴展php_xmlrpc.dll放到C:/Windows或者C:/Winnt目錄下,(php4的擴展在C:/php/extensions目錄中,php5的擴展在C:/php/ext目錄中。dll擴展文件的具體安裝目錄視你的php安裝目錄而定,此處僅為示例說明),同時在C:/Windows/php.ini或者C:/Winnt/php.ini中把extension=php_xmlrpc.dll前面的分號";"去掉,然后重啟Web服務(wù)器后查看phpinfo()有沒有XML-RPC項目就能夠確定是否已經(jīng)正確安裝xmlrpc擴展。
在Unix/Linux平臺下,如果沒有安裝xmlrpc擴展,請在重新編譯php,在configure的時候請加入 --with-xmlrpc 選項,然后查看phpinfo()看是否正常安裝xmlrpc。
(注意:以下操作都是建立在xmlrpc擴張正常安裝前提下,請務(wù)必正確安裝。)
三、XML-RPC工作原理:
XML-RPC大致就是整個過程就是使用XML來進行通信。首先構(gòu)造一個RPC 服務(wù)器端用來出來從RPC客戶端傳遞過來的使用XML封裝的請求,并且把處理結(jié)果通過XML的形式返回給RPC客戶端,客戶端就去分析XML獲取自己需要的數(shù)據(jù)。
XML-RPC的服務(wù)器端必須有現(xiàn)成的函數(shù)提供給客戶端調(diào)用,并且客戶端提交的請求中的函數(shù)和方法必須和服務(wù)器端的一致,否則將無法獲取所需要的結(jié)果。
下面我進行簡單的代碼來描述整個過程。
四、XML-RPC實踐:
服務(wù)器端使用xmlrpc_server_create函數(shù)產(chǎn)生一個服務(wù)器端,然后把需要需要暴露的RPC調(diào)用接口進行注冊,接受RPC客戶端POST過來的XML數(shù)據(jù),然后進行處理,處理結(jié)果通過XML的形式顯示給客戶端。
rpc_server.php文件代碼如下:
/*** 函數(shù):提供給RPC客戶端調(diào)用的函數(shù)* 參數(shù):* $method 客戶端需要調(diào)用的函數(shù)* $params 客戶端需要調(diào)用的函數(shù)的參數(shù)數(shù)組* 返回:返回指定調(diào)用結(jié)果*/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; } //產(chǎn)生一個XML-RPC的服務(wù)器端$xmlrpc_server = xmlrpc_server_create(); //注冊一個服務(wù)器端調(diào)用的方法rpc_server,實際指向的是rpc_server_func函數(shù)xmlrpc_server_register_method($xmlrpc_server, "rpc_server", "rpc_server_func"); //接受客戶端POST過來的XML數(shù)據(jù)$request = $HTTP_RAW_POST_DATA;//執(zhí)行調(diào)用客戶端的XML請求后獲取執(zhí)行結(jié)果$xmlrpc_response = xmlrpc_server_call_method($xmlrpc_server, $request, null); //把函數(shù)處理后的結(jié)果XML進行輸出header(''Content-Type: text/xml''); echo $xmlrpc_response; //銷毀XML-RPC服務(wù)器端資源xmlrpc_server_destroy($xmlrpc_server);
至此服務(wù)器端就構(gòu)造好了,那么再構(gòu)造我們的RPC客戶端。客戶端大致通過Socket訪問XML-RPC服務(wù)器端的80端口,然后把需要調(diào)用的RPC接口封裝到XML里,通過POST請求提交給RPC服務(wù)器端,最后獲取服務(wù)器端返回結(jié)果。
rpc_client.php文件代碼如下:
/*** 函數(shù):提供給客戶端進行連接XML-RPC服務(wù)器端的函數(shù)* 參數(shù):* $host 需要連接的主機* $port 連接主機的端口* $rpc_server XML-RPC服務(wù)器端文件* $request 封裝的XML請求信息* 返回:連接成功成功返回由服務(wù)器端返回的XML信息,失敗返回false*/function rpc_client_call($host, $port, $rpc_server, $request) { //打開指定的服務(wù)器端$fp = fsockopen($host, $port); //構(gòu)造需要進行通信的XML-RPC服務(wù)器端的查詢POST請求信息$query = "POST $rpc_server HTTP/1.0/nUser_Agent: XML-RPC Client/nHost: ".$host."/nContent-Type: text/xml/nContent-Length: ".strlen($request)."/n/n".$request."/n"; //把構(gòu)造好的HTTP協(xié)議發(fā)送給服務(wù)器,失敗返回falseif (!fputs($fp, $query, strlen($query))) { $errstr = "Write error"; return false; } //獲取從服務(wù)器端返回的所有信息,包括HTTP頭和XML信息$contents = ''''; while (!feof($fp)){ $contents .= fgets($fp); } //關(guān)閉連接資源后返回獲取的內(nèi)容fclose($fp); return $contents; } //構(gòu)造連接RPC服務(wù)器端的信息$host = ''localhost''; $port = 80; $rpc_server = ''/~heiyeluren/rpc_server.php'';//把需要發(fā)送的XML請求進行編碼成XML,需要調(diào)用的方法是rpc_server,參數(shù)是get$request = xmlrpc_encode_request(''rpc_server'', ''get''); //調(diào)用rpc_client_call函數(shù)把所有請求發(fā)送給XML-RPC服務(wù)器端后獲取信息$response = rpc_client_call($host, $port, $rpc_server, $request); //分析從服務(wù)器端返回的XML,去掉HTTP頭信息,并且把XML轉(zhuǎn)為php能識別的字符串$split = '''';$xml = explode($split, $response);$xml = $split . array_pop($xml);$response = xmlrpc_decode($xml);//輸出從RPC服務(wù)器端獲取的信息print_r($response);
大致我們上面的例子就是提交一個叫做rpc_server的方法過去,參數(shù)是get,然后獲取服務(wù)器端的返回,服務(wù)器端返回的XML數(shù)據(jù)是:
<?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函數(shù)把這個XML編碼為php的字符串,就能夠隨意處理了,至此整個Web Service交互完成。
五、總結(jié):
不管是XML-RPC也好,SOAP也罷,只要能夠讓我們穩(wěn)定、安全的進行遠程過程的調(diào)用,完成我們的項目,那么就算整個Web Service就是成功的。另外,如果可以的話,也可以嘗試使用PEAR中的XML-RPC來實現(xiàn)上面類似的操作,說不定會更簡單,更適合你使用。有興趣的讀者可以嘗試去完成。
php技術(shù):PHP采用XML-RPC構(gòu)造Web Service實例教程,轉(zhuǎn)載需保留來源!
鄭重聲明:本文版權(quán)歸原作者所有,轉(zhuǎn)載文章僅為傳播更多信息之目的,如作者信息標(biāo)記有誤,請第一時間聯(lián)系我們修改或刪除,多謝。