本文实例讲述了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.phpfensi.com 
77. } 
78.  
79. $server = new SoapServer('math.wsdl', array('soap_version'=>SOAP_1_2)); 
80.  
81. $server->setClass("math"); 
82.  
83. $server->handle();  
84.  
85. ?> 

注：

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.  
19. ?> 

本质上，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

分享到：