網站首頁 語言 會計 網際網路計算機 醫學 學歷 職場 文藝體育 範文
當前位置:學識谷 > 計算機 > php語言

PHP中使用XML-RPC構造Web Service簡單入門

欄目: php語言 / 釋出於: / 人氣:3.04W

PHP中如何使用XML-RPC構造Web Service?下面就來和小編一起看看PHP中使用XML-RPC構造Web Service簡單入門吧。

PHP中使用XML-RPC構造Web Service簡單入門

  [Web Service介紹 ]

Web Service就是為了異構系統的通訊而產生的,它基本的思想就是使用基於XML的HTTP的遠端呼叫提供一種標準的機制,而省去建立一種新協議的需求。目前進行Web Service通訊有兩種協議標準,一種是XML-RPC,另外一種是SOAP。XML-RPC比較簡單,出現時間比較早,SOAP比較複雜,主要是一些需要穩定、健壯、安全並且複雜互動的時候使用。

PHP中集成了XML-RPC和SOAP兩種協議的訪問,都是集中在xmlrpc擴充套件當中。另外,在PHP的PEAR中,不管是PHP 4還是PHP 5,都已經預設集成了XML-RPC擴充套件,而且該擴充套件跟xmlrpc擴充套件無關,能夠獨立實現XML-RPC的協議互動,如果沒有xmlrpc擴充套件,建議使用PEAR::XML-RPC擴充套件。

我們這裡主要是以XML-RPC來簡單描述Web Service的互動過程,部分內容來自PHP手冊,更詳細內容,建議參考手冊。

  [安裝xmlrpc擴充套件 ]

如果你的系統中沒有安裝xmlrpc的php擴充套件,那麼請正確安裝。

在Windows平臺下,首先把PHP安裝目錄下的擴充套件php_放到C:Windows或者C:Winnt目錄下,(PHP4的擴充套件在C:phpextensions目錄中,PHP5的擴充套件在C:phpext目錄中),同時在C:或者C:中把extension=php_前面的分號";"去掉,然後重啟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_

<?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_

<?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.0User_Agent: XML-RPC ClientHost: ".$host."Content-Type: text/xmlContent-Length: "en($request)."".$request."";

//把構造好的協議傳送給伺服器,失敗返回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_'';

//把需要傳送的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 =explode($split, $response);

$xml = $split . array_pop($xml);

$response = xmlrpc_decode($xml);

//輸出從RPC伺服器端獲取的資訊

print_r($response);

?>

大致我們上面的例子就是提交一個叫做rpc_server的方法過去,引數是get,然後獲取伺服器端的返回,伺服器端返回的XML資料是:

This data by get method

那麼我們再通過xmlrpc_decode函式把這個XML編碼為PHP的字串,我們就能夠隨意處理了,整個Web Service互動完成。

  [結束語 ]

不管是XML-RPC也好,SOAP也罷,只要能夠讓我們穩定、安全的進行遠端過程的呼叫,完成我們的專案,那麼就算整個Web Service就是成功的。另外,如果可以的話,也可以嘗試使用PEAR中的XML-RPC來實現上面類似的操作,說不定會更簡單,更適合你使用。

簡單的使用XML-RPC進行Web Service互動就完成了,部分程式碼參考PHP手冊,想獲取詳細資訊建議參考手冊,如果文章有不正確,請指正。

Tags:PHP XML RPC web SERVICE