PHP使用SOAP扩展实现WebService的方法
本文实例讲述了php使用soap扩展实现webservice的方法。分享给大家供大家参考,具体如下:
最近在一个php项目中对接外部接口涉及到webservice,搜索引擎上相关文章不是很多,找到的大都是引用一个号称很强大的开源软件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 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服务的客户端例子:
< ? 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服务
建立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服务
< ? 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()}"; } ?>
本质上,http://localhost/php/soap/soap_server.php?wsdl就是要访问到注释行所指的wsdl描述文件,所以这个wsdl文件必须事先生成。而对于其他语言如java则可以动态生成。对于php自带的soap扩展要求这个wsdl文件必须事先生成好。
可以用zendstudio生成静态的wsdl文件,此时用到math类的phpdoc作为生成wsdl的元数据。用zendstudio生成wsdl文件时,必须正确说明web服务目标地址,片断如下:
... <service name="mathservice"> <port binding="typens:mathbinding" name="mathport"> <soap:address location="http://localhost/php/soap/soap_server.php"></soap:address> </port> </service> ...
注:调用php webserver的方法必须传入命名参数。
更多关于php相关内容感兴趣的读者可查看本站专题:《php运算与运算符用法总结》、《php网络编程技巧总结》、《php基本语法入门教程》、《php操作office文档技巧总结(包括word,excel,access,ppt)》、《php日期与时间用法总结》、《php面向对象程序设计入门教程》、《php字符串(string)用法总结》、《php+mysql数据库操作入门教程》及《php常见数据库操作技巧汇总》
希望本文所述对大家php程序设计有所帮助。
上一篇: php中使用GD库做验证码
推荐阅读
-
PHP使用SOAP扩展实现WebService的方法
-
php安装php_rar扩展实现rar文件读取和解压的方法
-
php异步:在php中使用fsockopen curl实现类似异步处理的功能方法
-
php使用curl代理实现抓取数据的方法
-
php使用parse_str实现查询字符串解析到变量中的方法
-
php实现通过soap调用.Net的WebService asmx文件
-
php实现不通过扩展名准确判断文件类型的方法【finfo_file方法与二进制流】
-
PHP使用imagick扩展实现合并图像的方法
-
PHP使用finfo_file()函数检测上传图片类型的实现方法
-
php 使用curl模拟ip和来源进行访问的实现方法