PHP使用SOAP擴展實現(xiàn)WebService的方法
本文實例講述了PHP使用SOAP擴展實現(xiàn)WebService的方法。分享給大家供大家參考,具體如下:
最近在一個PHP項目中對接外部接口涉及到WebService,搜索引擎上相關(guān)文章不是很多,找到的大都是引用一個號稱很強大的開源軟件NuSOAP(下載地址:http://sourceforge.net/projects/nusoap/),即一些類。文章寫描述的環(huán)境是PHP 4.3,現(xiàn)在都流行PHP 5.2或PHP 5.3了。先拿來試試,運行出錯,原來NuSOAP提供的soapclient類與PHP 5中新增了內(nèi)置的SOAP擴展的SoapClient類沖突了。
雖然NuSOAP號稱可以用于所有的PHP 環(huán)境,不受服務(wù)器安全設(shè)置的影響。但需要引用一大堆類文件,還是覺得用PHP 5中新增了內(nèi)置的SOAP擴展好一些,能實現(xiàn)實用就好。先了解一下SOAP:
一、SOAP和XML-PRC比較
在Web服務(wù)發(fā)展的初期,XML格式化消息的第一個主要用途是,應(yīng)用于XML-RPC協(xié)議,其中RPC代表遠程過程調(diào)用。在XML遠程過程調(diào)用(XML-RPC)中,客戶端發(fā)送一條特定消息,該消息中必須包括名稱、運行服務(wù)的程序以及輸入?yún)?shù)。
XML-RPC只能使用有限的數(shù)據(jù)類型種類和一些簡單的數(shù)據(jù)結(jié)構(gòu)。人們認為這個協(xié)議還不夠強大,于是就出現(xiàn)了SOAP——其最初的定義是簡單對象訪問協(xié)議。之后,大家逐漸意識到SOAP其實并不簡單,而且也不需要必須使用面向?qū)ο笳Z言,所以,現(xiàn)在人們只是沿用SOAP這個名稱而已。
XML-RPC只有簡單的數(shù)據(jù)類型集,取而代之,SOAP是通過利用XML Schema的不斷發(fā)展來定義數(shù)據(jù)類型的。同時,SOAP也能夠利用XML 命名空間,這是XML-RPC所不需要的。如此一來,SOAP消息的開頭部分就可以是任何類型的XML命名空間聲明,其代價是在系統(tǒng)之間增加了更多的復(fù)雜性和不兼容性。
隨著計算機行業(yè)的覺醒,人們發(fā)現(xiàn)了基于XML的Web服務(wù)的商業(yè)潛力,于是,各家公司開始不斷地發(fā)掘想法、觀點、論據(jù)以及標(biāo)準(zhǔn)化嘗試。W3C曾經(jīng)設(shè)法以“Web服務(wù)活動”的名義來組織成果展,其中也包括實際做出SOAP的XML協(xié)議工作組(XML Protocol Working Group)。與Web服務(wù)有關(guān)的標(biāo)準(zhǔn)化成果(從某種程度上說與SOAP相關(guān)或者依賴于SOAP)的數(shù)量已經(jīng)倍增了到了令人驚訝的程度。
最初,SOAP是作為XML-RPC的擴展而發(fā)展起來的,它主要強調(diào)的是,通過從WSDL文件中所獲得的方法和變量名來進行遠程過程調(diào)用?,F(xiàn)在,通過不斷進步,人們發(fā)現(xiàn)了更多的使用SOAP的方式,而不僅僅是采用“文件”方式——基本上是使用一個SOAP信封來傳送XML格式化文件。無論如何,要掌握SOAP,了解WSDL所扮演的角色是最根本的。
二、SOAP數(shù)據(jù)包結(jié)構(gòu)解析
SOAP的消息被稱為一個SOAP Envelope,包括SOAP Header和SOAP Body。其中,SOAP Header可以方便的插入各種其它消息來擴充Web Service的功能,比如Security(采用證書訪問Web Service),SOAP Body則是具體的消息正文,也就是Marshall后的信息。
SOAP調(diào)用的時候,也就是向一個URL(比如 http://api.google.com/search/beta2 )發(fā)送HTTP Post報文(根據(jù)SOAP規(guī)范,HTTP Get報文也可被支持),調(diào)用方法的名字在HTTP Request Header SOAP-Action中給出,接下來就是SOAP Envelope了。服務(wù)端接到請求,執(zhí)行計算,將返回結(jié)果Marshall成XML,用HTTP返回給客戶端。
三、SOAP簡單示例
SOAP開發(fā)一般有三種方式選擇:
1)、PEAR自帶的SOAP擴展;
2)、PHP自帶的SOAP擴展;
3)、NuSOAP(純PHP) 。
PHP 5中新增了內(nèi)置的SOAP擴展,作為PHP的一部分提供的,因此不需要下載、安裝和管理單獨的包。這是第一個用C而不是PHP為PHP編寫的SOAP實現(xiàn),因此作者聲稱它的速度要快得多。相關(guān)文檔包含在PHP手冊的Function Reference部分(php_soap.dll)。
一個訪問.NET WEB服務(wù)的客戶端例子:
< ? php $objSoapClient = new SoapClient("http://www.webservicemart.com/uszip.asmx?WSDL"); $param = array("ZipCode"=>'12209'); $out = $objSoapClient->ValidateZip($param); $data = $out->ValidateZipResult; echo $data; ?>
四、實例
1)、用PHP建立SOAP服務(wù)
建立soap_server.php(虛擬路徑為:http://localhost/php/soap/soap_server.php)
< ? php /** * A simple math utility class */ class math{ /** * Add two integers together * * @param integer $a The first integer of the addition * @param integer $b The second integer of the addition * @return integer The sum of the provided integers */ public function add($a, $b){ return $a + $b; } /** * Subtract two integers from each other * * @param integer $a The first integer of the subtraction * @param integer $b The second integer of the subtraction * @return integer The difference of the provided integers */ public function sub($a, $b){ return $a - $b; } /** * Div two integers from each other * * @param integer $a The first integer of the subtraction * @param integer $b The second integer of the subtraction * @return double The difference of the provided integers */ public function div($a, $b){ if($b == 0){ throw new SoapFault(-1, "Cannot divide by zero!"); } return $a / $b; } } $server = new SoapServer('math.wsdl', array('soap_version'=>SOAP_1_2)); $server->setClass("math"); $server->handle(); ?>
注:
a)、math類是即將公開的webservice;
b)、$server->setClass,不是$server->addClass。
2)、用PHP客戶端訪問剛建立SOAP服務(wù)
< ? php // $client = new SoapClient('http://localhost/php/soap/math.wsdl'); $client = new SoapClient("http://localhost/php/soap/soap_server.php?WSDL"); try{ $result = $client->div(8, 2); // will cause a Soap Fault if divide by zero print "The answer is: $result"; }catch(SoapFault $e){ print "Sorry an error was caught executing your request: {$e->getMessage()}"; } ?>
本質(zhì)上,http://localhost/php/soap/soap_server.php?WSDL就是要訪問到注釋行所指的wsdl描述文件,所以這個WSDL文件必須事先生成。而對于其他語言如Java則可以動態(tài)生成。對于PHP自帶的SOAP擴展要求這個WSDL文件必須事先生成好。
可以用ZendStudio生成靜態(tài)的WSDL文件,此時用到math類的phpdoc作為生成WSDL的元數(shù)據(jù)。用ZendStudio生成wsdl文件時,必須正確說明Web服務(wù)目標(biāo)地址,片斷如下:
... <service name="mathService"> <port binding="typens:mathBinding" name="mathPort"> <soap:address location="http://localhost/php/soap/soap_server.php"></soap:address> </port> </service> ...
注:調(diào)用PHP Webserver的方法必須傳入命名參數(shù)。
更多關(guān)于PHP相關(guān)內(nèi)容感興趣的讀者可查看本站專題:《PHP運算與運算符用法總結(jié)》、《PHP網(wǎng)絡(luò)編程技巧總結(jié)》、《PHP基本語法入門教程》、《php操作office文檔技巧總結(jié)(包括word,excel,access,ppt)》、《php日期與時間用法總結(jié)》、《php面向?qū)ο蟪绦蛟O(shè)計入門教程》、《php字符串(string)用法總結(jié)》、《php+mysql數(shù)據(jù)庫操作入門教程》及《php常見數(shù)據(jù)庫操作技巧匯總》
希望本文所述對大家PHP程序設(shè)計有所幫助。
- PHP程序員簡單的開展服務(wù)治理架構(gòu)操作詳解(二)
- PHP程序員簡單的開展服務(wù)治理架構(gòu)操作詳解(一)
- PHP中soap用法示例【SoapServer服務(wù)端與SoapClient客戶端編寫】
- php中curl和soap方式請求服務(wù)超時問題的解決
- PHP使用NuSOAP調(diào)用Web服務(wù)的方法
- PHP中soap的用法實例
- PHP使用SOAP調(diào)用.net的WebService數(shù)據(jù)
- PHP Class SoapClient not found解決方法
- PHP實現(xiàn)Soap通訊的方法
- PHP使用SOAP調(diào)用API操作示例
- PHP程序員簡單的開展服務(wù)治理架構(gòu)操作詳解(三)
相關(guān)文章
怎樣使用php與jquery設(shè)置和讀取cookies
有兩種處理cookies的方式—服務(wù)端(php,asp等)和客戶端(javascript).在這個教程中,我們將學(xué)習(xí)到以php和javascript這兩種方式如何去創(chuàng)建cookies2013-08-08采用memcache在web集群中實現(xiàn)session的同步會話
這篇文章主要介紹了采用memcache在web集群中實現(xiàn)session的同步會話,需要的朋友可以參考下2014-07-07