php調用web services兩種方法soap and xml-rpc

Web Service介紹

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

一：如何使用PHP的XML-RPC調用Web services：

首先，要安裝xmlrpc擴展：

若是你的系統中沒有安裝xmlrpc的php擴展，那麼請正確安裝。

在Windows平臺下，首先把PHP安裝目錄下的擴展php_xmlrpc.dll放到C:\Windows或者C:\Winnt目錄下，(PHP4的 擴展在C:\php\extensions目錄中，PHP5的擴展在C:\php\ext目錄中)，同時在C:\Windows\php.ini或者C: \Winnt\php.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的服務器端必須有現成的函數提供給客戶端調用，而且客戶端提交的請求中的函數和方法必須和服務器端的一致，不然將沒法獲取所須要的結果。服務器端使用xmlrpc_server_create函數產生一個服務器端，而後把須要須要暴露的RPC調用接口進行註冊，接受RPC客戶端POST過來的XML數據，而後進行處理，處理結果經過XML的形式顯示給客戶端。

Ok,講了這麼多，接着咱們用實例來看看如何用XML-RPC協議調用Web serivces：

服務端：server.php:

<?php
/**
* 函數：提供給RPC客戶端調用的函數
* 參數：
* $method 客戶端須要調用的函數
* $params 客戶端須要調用的函數的參數數組
* 返回：返回指定調用結果
*/
/*
function rpc_server_func($method, $params) {
$parameter = $params[0];//傳入的函數名稱

$parameter1 = $params[1];//傳入的參數
   if ($parameter == "get")
   { 
       $return = "This data by get method".$parameter1 ; 
   }
   else
   {
       $return = "Not specify method or params";
   } 
   return $return; 
} 
*/
function test($method, $params)
{
	if($params[0]=="get")
	{
		$return = "Using POST method by client,post data is:<br>".$params[1]."<br>".$params[2];
	}
   else
   {
       $return = "Not specify method or params";
   } 
   return $return; 
}

//產生一個XML-RPC的服務器端
$xmlrpc_server = xmlrpc_server_create(); 

//註冊一個服務器端調用的方法rpc_server，實際指向的是test函數
xmlrpc_server_register_method($xmlrpc_server, "rpc_server", "test"); 

//接受客戶端POST過來的XML數據
$request = $HTTP_RAW_POST_DATA;

//執行調用客戶端的XML請求後獲取執行結果
$xmlrpc_response = xmlrpc_server_call_method($xmlrpc_server, $request, null); 

//把函數處理後的結果XML進行輸出
header("Content-Type: text/xml,charset=utf-8"); 
echo $xmlrpc_response; 

//銷燬XML-RPC服務器端資源
xmlrpc_server_destroy($xmlrpc_server); 
?>

客戶端：client.php:

<?php
/**
* 函數：提供給客戶端進行鏈接XML-RPC服務器端的函數
* 參數：
* $host  須要鏈接的主機
* $port  鏈接主機的端口
* $rpc_server XML-RPC服務器端文件
* $request  封裝的XML請求信息
* 返回：鏈接成功成功返回由服務器端返回的XML信息，失敗返回false
*/
header("content-type:text/html;charset=utf-8");
function write_file( $string )
{
 $fp = fopen( "xml.log","w" );
 fprintf( $fp, "%s\n", $string );
 fclose( $fp ); 
}
function rpc_client_call($host, $port, $rpc_server, $request) { 

   //打開指定的服務器端
   $fp = fsockopen($host, $port); 
   //echo $fp."<br>";
   //構造須要進行通訊的XML-RPC服務器端的查詢POST請求信息
   $query = "POST $rpc_server HTTP/1.1\r\nUser_Agent: XML-RPC Client\r\nHost: ".$host."\r\nContent-Type: text/xml\r\nContent-Length: ".strlen($request)."\r\n\r\n".$request."\r\n"; 
   //echo $query."<br>";
   
   //把構造好的HTTP協議發送給服務器，失敗返回false
   if (!fputs($fp, $query, strlen($query))) 
   { 
       $errstr = "Write error"; 
       echo $errstr."<br>";
       return false;
   } 
   
   //獲取從服務器端返回的全部信息，包括HTTP頭和XML信息
   $contents = "";
   while (!feof($fp))
   { 
       $contents .= fgets($fp); 
   } 

   //關閉鏈接資源後返回獲取的內容
   fclose($fp); 
   return $contents; 
} 

//構造鏈接RPC服務器端的信息
$host  = "localhost"; 
$port  = 80; 
$rpc_server = "/xml/server.php";//注意 這裏必定要有/，切忌。

//把須要發送的XML請求進行編碼成XML，須要調用的方法是rpc_server，參數是get
$request = xmlrpc_encode_request("rpc_server", array( "get", "My name is Adam","我是李漢團.")); 
//echo $request;
//調用rpc_client_call函數把全部請求發送給XML-RPC服務器端後獲取信息
$response = rpc_client_call($host, $port, $rpc_server, $request); 
write_file ( $response );

//echo "aaa".$response."xxx"."<br>";
//分析從服務器端返回的XML，去掉HTTP頭信息，而且把XML轉爲PHP能識別的字符串
$split = "<?xml version=\"1.0\" encoding=\"iso-8859-1\"?>";
//echo "split=".$split."<br>";
$xml =  explode($split, $response);
$xml = $split . array_pop($xml);
//echo $xml直接打印將顯示出xml內容；
echo "返回的xml內容:<br />".$xml;
echo "<br />把返回的xml內容轉換爲PHP能識別的字符串:<br />";
$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>Using POST method by client,post data is:&#60;br&#62;My name is Adam&#60;br&#62;&#230;&#136;&#145;&#230;&#152;&#175;&#230;&#157;&#142;&#230;&#177;&#137;&#229;&#155;&#162;.</string>
  </value>

 </param>
</params>
</methodResponse>

那麼咱們再經過xmlrpc_decode函數把這個XML編碼爲PHP的字符串，咱們就可以隨意處理了，整個Web Service交互完成。

固然，可能有時咱們也須要把返回的xml解析成數組，這樣能不能作到呢？也能夠，方法以下，將client.php更改以下：

<?php
/**
* 函數：提供給客戶端進行鏈接XML-RPC服務器端的函數
* 參數：
* $host  須要鏈接的主機
* $port  鏈接主機的端口
* $rpc_server XML-RPC服務器端文件
* $request  封裝的XML請求信息
* 返回：鏈接成功成功返回由服務器端返回的XML信息，失敗返回false
*/
header("content-type:text/html;charset=utf-8");
function write_file( $string )
{
 $fp = fopen( "xml.xml","w" );
 fprintf( $fp, "%s\n", $string );
 fclose( $fp ); 
}
function rpc_client_call($host, $port, $rpc_server, $request) { 

   //打開指定的服務器端
   $fp = fsockopen($host, $port); 
   //echo $fp."<br>";
   //構造須要進行通訊的XML-RPC服務器端的查詢POST請求信息
   $query = "POST $rpc_server HTTP/1.1\r\nUser_Agent: XML-RPC Client\r\nHost: ".$host."\r\nContent-Type: text/xml\r\nContent-Length: ".strlen($request)."\r\n\r\n".$request."\r\n"; 
   //echo $query."<br>";
   
   //把構造好的HTTP協議發送給服務器，失敗返回false
   if (!fputs($fp, $query, strlen($query))) 
   { 
       $errstr = "Write error"; 
       echo $errstr."<br>";
       return false;
   } 
   
   //獲取從服務器端返回的全部信息，包括HTTP頭和XML信息
   $contents = "";
   while (!feof($fp))
   { 
       $contents .= fgets($fp); 
   } 

   //關閉鏈接資源後返回獲取的內容
   fclose($fp); 
   return $contents; 
} 

//構造鏈接RPC服務器端的信息
$host  = "localhost"; 
$port  = 80; 
$rpc_server = "/xml/rpc_server.php";//注意 這裏必定要有/，切忌。

//把須要發送的XML請求進行編碼成XML，須要調用的方法是rpc_server，參數是get
$request = xmlrpc_encode_request("rpc_server", array( "get", "My name is Adam","I'm a php programmer")); 
//echo $request;
//調用rpc_client_call函數把全部請求發送給XML-RPC服務器端後獲取信息
$response = rpc_client_call($host, $port, $rpc_server, $request); 
write_file ( $response );

//echo "aaa".$response."xxx"."<br>";
//分析從服務器端返回的XML，去掉HTTP頭信息
$split = "<?xml version=\"1.0\" encoding=\"iso-8859-1\"?>";
$xml =  explode($split, $response);
$xml = array_pop($xml);
/*
echo "返回的xml內容:<br />".$xml;
echo "<br />把返回的xml內容轉換爲PHP能識別的字符串:<br />";
$response = xmlrpc_decode($xml);
print_r($response);
*/
//把XML轉爲PHP能識別的數組：
$p = xml_parser_create();
xml_parse_into_struct($p, $xml, $vals, $index);
xml_parser_free($p);
echo "\nVals array\n";
print_r($vals);
?>

此時$value就是返回的xml轉換得來的數組，至此，xml-rpc調用web services ,解析返回的xml數據成功完成。

二：如何用php soap調用web services:

<?php
 //服務器支持soap擴展:
  /*Example 1:
  $client = new SoapClient("http://fy.webxml.com.cn/webservices/EnglishChinese.asmx?wsdl");
  $parameters = array("wordKey"=>"test");
  //中英文雙向翻譯返回數據：數組
  $result = $client->TranslatorString($parameters);
   echo "<pre>";
  print_r($result->TranslatorStringResult)."<br />";
   echo "</pre>";
//中英文雙向翻譯返回數組含句子例子：
  $result1 = $client->Translator($parameters);
  echo "<pre>";
  print_r($result1->TranslatorResult)."<br />";
  echo "</pre>";
//得到候選詞：
  $result2 = $client->SuggestWord($parameters);
  echo "<pre>";
  print_r($result2->SuggestWordResult)."<br />";
  echo "</pre>";
//得到朗讀MP3字節流,返回數據：字節數組 Byte[]
  $result3 = $client->GetMp3($parameters);
  echo "<pre>";
  print_r($result3)."<br />";
  echo "</pre>";
  */
	/*Example2:
  $client = new SoapClient("http://webservice.webxml.com.cn/WebServices/IpAddressSearchWebService.asmx?wsdl");
  $param = array('theIpAddress'=>'202.96.134.33');
  $result = $client->getCountryCityByIp($param);
  echo "<pre>";
  print_r($result->getCountryCityByIpResult);
  echo "</pre>";

  $result1 = $client->getGeoIPContext($param);
  echo "<pre>";
  print_r($result1);
  echo "</pre>";

  $result2 = $client->getVersionTime(
  );
  echo "<pre>";
  print_r($result2);
  echo "</pre>";
  */
  //Example3:
  $client = new SoapClient("http://webservice.webxml.com.cn/WebServices/MobileCodeWS.asmx?wsdl");
  //得到國內手機號碼歸屬地省份、地區和手機卡類型信息
  $parm=array('mobileCode'=>'1367007','userID'=>'');
  $result=$client->getMobileCodeInfo($parm);
  echo ($result->getMobileCodeInfoResult)."<br>";
  //得到國內手機號碼歸屬地數據庫信息
  $result1 = $client->getDatabaseInfo($parm);
  print_r($result1)."<br>";

// 獲取SOAP類型列表(Returns list of SOAP types )
	echo '<pre>';
	print_r($client->__getTypes ()) ;
	echo '</pre>';

// 獲取webservice提供的函數
	echo '<pre>';
	print_r($client->__getFunctions ()) ;
	echo '</pre>';	
//服務器不支持soap擴展的狀況下，可引入網上開源的類庫	
?>