當前位置:首頁 > PHP教程 > php高級應用 > 列表

PHP使用SOAP擴展實現WebService的方法

發布:smiling 來源: PHP粉絲網  添加日期:2019-10-20 19:53:00 瀏覽: 評論:0 

本文實例講述了PHP使用SOAP擴展實現WebService的方法。分享給大家供大家參考,具體如下:

最近在一個PHP項目中對接外部接口涉及到WebService,搜索引擎上相關文章不是很多,找到的大都是引用一個號稱很強大的開源軟件NuSOAP(下載地址:http://sourceforge.net/projects/nusoap/),即一些類。文章寫描述的環境是PHP 4.3,現在都流行PHP 5.2或PHP 5.3了。先拿來試試,運行出錯,原來NuSOAP提供的soapclient類與PHP 5中新增了內置的SOAP擴展的SoapClient類沖突了。

雖然NuSOAP號稱可以用于所有的PHP 環境,不受服務器安全設置的影響。但需要引用一大堆類文件,還是覺得用PHP 5中新增了內置的SOAP擴展好一些,能實現實用就好。先了解一下SOAP:

一、SOAP和XML-PRC比較

在Web服務發展的初期,XML格式化消息的第一個主要用途是,應用于XML-RPC協議,其中RPC代表遠程過程調用。在XML遠程過程調用(XML-RPC)中,客戶端發送一條特定消息,該消息中必須包括名稱、運行服務的程序以及輸入參數。

XML-RPC只能使用有限的數據類型種類和一些簡單的數據結構。人們認為這個協議還不夠強大,于是就出現了SOAP——其最初的定義是簡單對象訪問協議。之后,大家逐漸意識到SOAP其實并不簡單,而且也不需要必須使用面向對象語言,所以,現在人們只是沿用SOAP這個名稱而已。

XML-RPC只有簡單的數據類型集,取而代之,SOAP是通過利用XML Schema的不斷發展來定義數據類型的。同時,SOAP也能夠利用XML 命名空間,這是XML-RPC所不需要的。如此一來,SOAP消息的開頭部分就可以是任何類型的XML命名空間聲明,其代價是在系統之間增加了更多的復雜性和不兼容性。

隨著計算機行業的覺醒,人們發現了基于XML的Web服務的商業潛力,于是,各家公司開始不斷地發掘想法、觀點、論據以及標準化嘗試。W3C曾經設法以“Web服務活動”的名義來組織成果展,其中也包括實際做出SOAP的XML協議工作組(XML Protocol Working Group)。與Web服務有關的標準化成果(從某種程度上說與SOAP相關或者依賴于SOAP)的數量已經倍增了到了令人驚訝的程度。

最初,SOAP是作為XML-RPC的擴展而發展起來的,它主要強調的是,通過從WSDL文件中所獲得的方法和變量名來進行遠程過程調用。現在,通過不斷進步,人們發現了更多的使用SOAP的方式,而不僅僅是采用“文件”方式——基本上是使用一個SOAP信封來傳送XML格式化文件。無論如何,要掌握SOAP,了解WSDL所扮演的角色是最根本的。

二、SOAP數據包結構解析

SOAP的消息被稱為一個SOAP Envelope,包括SOAP Header和SOAP Body。其中,SOAP Header可以方便的插入各種其它消息來擴充Web Service的功能,比如Security(采用證書訪問Web Service),SOAP Body則是具體的消息正文,也就是Marshall后的信息。

SOAP調用的時候,也就是向一個URL(比如 http://api.google.com/search/beta2 )發送HTTP Post報文(根據SOAP規范,HTTP Get報文也可被支持),調用方法的名字在HTTP Request Header SOAP-Action中給出,接下來就是SOAP Envelope了。服務端接到請求,執行計算,將返回結果Marshall成XML,用HTTP返回給客戶端。

三、SOAP簡單示例

SOAP開發一般有三種方式選擇:

1)、PEAR自帶的SOAP擴展;

2)、PHP自帶的SOAP擴展;

3)、NuSOAP(純PHP) 。

PHP 5中新增了內置的SOAP擴展,作為PHP的一部分提供的,因此不需要下載、安裝和管理單獨的包。這是第一個用C而不是PHP為PHP編寫的SOAP實現,因此作者聲稱它的速度要快得多。相關文檔包含在PHP手冊的Function Reference部分(php_soap.dll)。

一個訪問.NET WEB服務的客戶端例子:

  1. <?php 
  2.  
  3. $objSoapClient = new SoapClient("http://www.webservicemart.com/uszip.asmx?WSDL"); 
  4.  
  5. $param = array("ZipCode"=>'12209');  
  6.  
  7. $out = $objSoapClient->ValidateZip($param); 
  8.  
  9. $data = $out->ValidateZipResult; 
  10.  
  11. echo $data
  12.  
  13. ?> 

四、實例

1)、用PHP建立SOAP服務

建立soap_server.php(虛擬路徑為:http://localhost/php/soap/soap_server.php)

  1. <? php 
  2.  
  3. /** 
  4.  
  5. * A simple math utility class 
  6.  
  7. */ 
  8.  
  9. class math{ 
  10.  
  11.   /** 
  12.  
  13.   * Add two integers together 
  14.  
  15.   * 
  16.  
  17.   * @param integer $a The first integer of the addition 
  18.  
  19.   * @param integer $b The second integer of the addition 
  20.  
  21.   * @return integer The sum of the provided integers 
  22.  
  23.   */ 
  24.  
  25.   public function add($a$b){ 
  26.  
  27.     return $a + $b
  28.  
  29.   } 
  30.  
  31.   /** 
  32.  
  33.   * Subtract two integers from each other 
  34.  
  35.   * 
  36.  
  37.   * @param integer $a The first integer of the subtraction 
  38.  
  39.   * @param integer $b The second integer of the subtraction 
  40.  
  41.   * @return integer The difference of the provided integers 
  42.  
  43.   */ 
  44.  
  45.   public function sub($a$b){ 
  46.  
  47.     return $a - $b
  48.  
  49.   } 
  50.  
  51.   /** 
  52.  
  53.   * Div two integers from each other 
  54.  
  55.   * 
  56.  
  57.   * @param integer $a The first integer of the subtraction 
  58.  
  59.   * @param integer $b The second integer of the subtraction 
  60.  
  61.   * @return double The difference of the provided integers 
  62.  
  63.   */ 
  64.  
  65.   public function div($a$b){ 
  66.  
  67.     if($b == 0){ 
  68.  
  69.       throw new SoapFault(-1, "Cannot divide by zero!"); 
  70.  
  71.     } 
  72.  
  73.     return $a / $b
  74.  
  75.   } 
  76. //www.rserpo.live 
  77.  
  78. $server = new SoapServer('math.wsdl'array('soap_version'=>SOAP_1_2)); 
  79.  
  80. $server->setClass("math"); 
  81.  
  82. $server->handle();  
  83.  
  84. ?> 

注:

a)、math類是即將公開的webservice;

b)、$server->setClass,不是$server->addClass。

2)、用PHP客戶端訪問剛建立SOAP服務

  1. <? php 
  2.  
  3. // $client = new SoapClient('http://localhost/php/soap/math.wsdl'); 
  4.  
  5. $client = new SoapClient("http://localhost/php/soap/soap_server.php?WSDL"); 
  6.  
  7. try{ 
  8.  
  9.   $result = $client->div(8, 2); // will cause a Soap Fault if divide by zero 
  10.  
  11.   print "The answer is: $result"
  12.  
  13. }catch(SoapFault $e){ 
  14.  
  15.   print "Sorry an error was caught executing your request: {$e->getMessage()}"
  16.  
  17.  
  18. ?> 

本質上,http://localhost/php/soap/soap_server.php?WSDL就是要訪問到注釋行所指的wsdl描述文件,所以這個WSDL文件必須事先生成。而對于其他語言如Java則可以動態生成。對于PHP自帶的SOAP擴展要求這個WSDL文件必須事先生成好。

可以用ZendStudio生成靜態的WSDL文件,此時用到math類的phpdoc作為生成WSDL的元數據。用ZendStudio生成wsdl文件時,必須正確說明Web服務目標地址,片斷如下:

  1. <service name="mathService"
  2.  
  3.     <port binding="typens:mathBinding" name="mathPort"
  4.  
  5.       <soap:address location="http://localhost/php/soap/soap_server.php"></soap:address> 
  6.  
  7.     </port> 
  8.  
  9.   </service> 

注:調用PHP Webserver的方法必須傳入命名參數。

Tags: SOAP WebService

分享到:

广西快3最大遗漏值统计表