利用php soap实现web service (二)
在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
2
3
4
5
6
7
|
< ? 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）
?
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
|
< ? 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服务
?
|
1
2
3
4
5
6
7
8
9
10
|
< ? 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服务目标地址，片断如下：
?
|
1
2
3
4
5
6
7
|
...
<service name=
"mathService"
>
<port binding=
"typens:mathBinding"
name=
"mathPort"
>
<soap:address location=
"http://localhost/php/soap/soap_server.php"
></soap:address>
</port>
</service>
...
|