PHP实现WebService以及调用WebService
PHP WebService实现
1、PHP与WebService
主要了解WebService中基于SOAP的实现。
PHP 的较早版本根本没有对 SOAP 的直接支持，只能通过 PEAR(the PHP Extension and Application Repository) 中的 SOAP 库或者第三方产品 NuSOAP 来开发 Web 服务。不过最近的版本已经改变了这一状况。自 PHP 5 开始新增了内置的 SOAP 扩展 (ext/soap)，从此我们不需要下载额外的扩展库或是代码包来开发基于 SOAP 的应用程序了。
PHP 中 Web 服务的两种模式：WSDL 模式和 non-WSDL 模式。简单地可以理解为WSDL 模式对外提供WSDL定义文件，non-WSDL 模式对外不提供WSDL定义文件。
下面学习了解两种常用的SOAP实现方式：使用第三方产品 NuSOAP和使用SOAP扩展。
2、NuSOAP实现
NuSOAP是一组功能强大的PHP类，使得使用和创建SOAP消息变得相当简单。
NuSOAP 完全由PHP语言编写，由一系列 PHP 类组成，不需要扩展库的支持，这种特性使得 NuSOAP 可以用于所有的 PHP 环境，不受服务器安全设置的影响。
NuSOAP遵循LGPL发布。NuSOAP提供的特性，包括：
●简单：NuSOAP的面向对象方法隐藏了SOAP消息组装、解析、提交和接收的有关细节，使用户集中于应用程序本身。
●WSDL生成和导入：NuSOAP可以生成一个对应于所发布Web服务的WSDL文档，并且能导入一个WSDL引用在NuSOAP客户端使用。
●代理类：NuSOAP可以生成的一个代理类，允许调用远程方法，如同调用本地方法一样。
●HTTP代理：出于多种原因（安全性和审计是其中两个原因），有些客户端被强制将请求委托给HTTP代理，由代理代表客户端执行请求。也就是说，需要所有SOAP请求都传递给此代理，而不是直接查询服务器。NuSOAP为指定代理服务器提供了基本支持。
●SSL：如果可以通过PHP使用CURL扩展，NuSOAP还支持通过SSL的安全通信。
NuSOAP 的安装比较简单，把下载的 NuSOAP 的文件拷贝到服务器上，可以放在独立的目录里，也可以与程序代码放在相同的目录里，只要你的 PHP 代码能够访问到这些文件就可以了。NuSOAP 由一组PHP 类组成，其中最常用到的是类soap_server和类soapclient。类soap_server 用于创建 WEB 服务，类soapclient在访问WEB服务时会用到。
下面进行一个简单的应用，它包含两个方法getName()与hello()。
getName()：无参，仅仅返回字符串：lory。
hello()：有两个参数$name和$password，如果$name和$password都是“lory”，返回“Welcome lory, how are you？”，如果不是，返回“Go away!!!”。
2.1.1 non-WSDL模式
服务端：SoapHello.php
<?php
//把 NuSOAP 的源文件包含到当前的代码文件里
require_once('include/nusoap/nusoap.php');
//初始化服务对象 , 这个对象是类 soap_server 的一个实例
$server = new soap_server;
//调用服务对象的 register 方法注册需要被客户端访问的程序。
//只有注册过的程序，才能被远程客户端访问到。
$server->register('hello');
$server->register('getName');
$HTTP_RAW_POST_DATA = isset($HTTP_RAW_POST_DATA) ? $HTTP_RAW_POST_DATA : '';
//最后一步，把客户端通过 post 方式提交的数据，传递给服务对象的 service 方法。
//service 方法处理输入的数据，调用相应的函数或方法，并且生成正确的反馈，传回给客户端。
$server->service($HTTP_RAW_POST_DATA);
//注册方法的实现,有参数
function hello($name, $password){
if ($password == 'lory' && $name == 'lory') {
return 'Welcome lory, how are you?';
} else {
return 'Go away!!!';
}
}
//注册方法的实现,无参数
function getName(){
return 'lory';
}
exit();
?>
该实现中没有支持WSDL，因此也无法将服务器提供的接口暴露。在浏览器中访问服务端文件：
客服端调用程序：soapclient.php
<?php
//把 NuSOAP 的源文件包含到当前的代码文件里
require_once('include/nusoap/nusoap.php');
//初始化客户端对象，这个对象是类 soapclient 的一个实例，
//把服务程序的 URL 地址传递给soapclient类的构造函数。
$client = new soapclient('http://192.168.69.241/Myphp/SoapHello.php');
//参数
$parameters = array('lory','lory');
//利用客户端对象的 call 方法调用 WEB 服务的程序
//客户端对象的 getError() 方法可以用来检查调用过程是否出现错误。
//如果没有错误， getError() 方法返回 false ；如果有错误， getError()方法返回错误信息。
if (!$err=$client->getError()) {
echo $client->call('getName');
echo "<br>";
echo $client->call('hello', $parameters);
} else{
echo " error :",htmlentities($err,ENT_QUOTES);
}
exit();
?>
运行结果：
2.1.2 WSDL模式
NuSOAP 内部通过类 "WSDL" 实现对 WSDL 的支持。对于 NuSOAP 的用户来说，不需要关心内部的WSDL类是如何工作的，正确地使用 soap_server 类和 soapclient 类就可以实现对 WSDL 的支持。为了实现 WEB 服务程序对 WSDL 的支持，需要使用 soap_server 的 configureWSDL 方法，并且在调用 soap_server 的 register 方法注册 WEB 服务程序时，需要提供更详细的参数。
服务端：SoapHello.php
<?php
//把 NuSOAP 的源文件包含到当前的代码文件里
require_once('include/nusoap/nusoap.php');
//命名空间定义
$NAMESPACE = 'http://www.kingdee.com';
//初始化服务对象 , 这个对象是类 soap_server 的一个实例
$server = new soap_server;
//初始化对 WSDL 的支持
$server->configureWSDL('MySoapServer', //WEB服务器名称
$NAMESPACE,
'http://192.168.69.241/Myphp'.'/SoapHello.php');
//调用服务对象的 register 方法注册需要被客户端访问的程序。
//只有注册过的程序，才能被远程客户端访问到。
$server->register(
'getName', //注册的方法
array(),//输入参数的定义
array('return'=>'xsd:string'), // 返回参数的定义
$NAMESPACE); //命名空间，可选参数
$server->register(
'hello', //注册的方法
array('user_name'=>'xsd:string','password'=>'xsd:string'),//输入参数的定义
array('return'=>'xsd:string'), // 返回参数的定义
$NAMESPACE); //命名空间，可选参数
$HTTP_RAW_POST_DATA = isset($HTTP_RAW_POST_DATA) ? $HTTP_RAW_POST_DATA : '';
//最后一步，把客户端通过 post 方式提交的数据，传递给服务对象的 service 方法。
//service 方法处理输入的数据，调用相应的函数或方法，并且生成正确的反馈，传回给客户端。
$server->service($HTTP_RAW_POST_DATA);
//注册方法的实现,有参数
function hello($name, $password){
if ($password == 'lory' && $name == 'lory') {
return 'Welcome lory, how are you?';
}else {
return 'Go away!!!';
}
}
//注册方法的实现,无参数
function getName(){
return 'lory';
}
exit();
?>
在浏览器中访问服务端文件，可以看到其向外发布的WSDL信息：
点击上图的WSDL链接，会显示该服务器提供的WSDL定义内容，
点击”hello”链接，则打开该方法的定义：
其客户端调用与non-WSDL一样。
3、SOAP 扩展实现
使用SOAP扩展，首先配置php.ini：
1、加载 extension=php_soap.dll 及取消前面的分号。
2、修改soap.wsdl_cache_enabled = 1 为soap.wsdl_cache_enabled = 0（该参数提供WSDL文件缓存，在运行环境中设置1，使用缓存；在调试环境中设置为0，不使用缓存）。
修改php.ini后要重启apache服务器。
下面进行一个简单的应用，它只包含一个方法hello()，与前面例子实现的功能相同。
hello()：有两个参数$name和$password，如果$name和$password都是“lory”，返回“Welcome lory, how are you？”，如果不是，返回“Go away!!!”。
3.1.1 non-WSDL模式
服务器端：SoapHello1.php
<?php
//实例化SOAP服务
$server = new SoapServer(null, //non-WSDL模式，不指定WSDL文件
array('uri' => 'www.kingdee.com',
'soap_version' => SOAP_1_2));
//注册提供外部调用的方法
$server->addFunction('hello');
//可以注册方法，也可以注册类：
//$server->setClass("class name");
$server->handle();
//注册方法的实现
function hello($name, $password){
if ($password == 'lory' && $name == 'lory') {
return 'Welcome lory, how are you?';
} else {
return 'Go away!!!';
}
}
exit();
?>
该实现中没有支持WSDL，因此也无法将服务器提供的接口暴露。在浏览器中访问服务端文件：
客户端soapclient1.php:
<?php
try {
//实例化客户端
/*If working in WSDL mode, this parameter is optional. If working in non-WSDL mode, the location and uri options must be set, where location is the URL to request and uri is the target namespace of the SOAP service.
*/
$client = new SoapClient(null, // non-WSDL模式，不指定WSDL文件
array('location' =>"http://192.168.69.241/MyPHP/SoapHello1.php?wsdl",
'uri' => "http://www.kingdee.com/"));
//调用服务端方法，并打印出返回结果
echo $client->hello('lory','lory');
} catch (SoapFault $fault){
echo "Error: ",$fault->faultcode,", string: ",$fault->faultstring;
}
exit();
?>
浏览器访问客户端，结果如下：
服务器端：SoapHello1.php
<?php
//实例化SOAP服务
$server = new SoapServer('wsdl/hello.wsdl', //指定WSDL文件，预先生成
array('soap_version' => SOAP_1_2));
//注册提供外部调用的方法
$server->addFunction('hello');
$server->handle();
//注册方法的实现
function hello($name, $password){
if ($password == 'lory' && $name == 'lory') {
return 'Welcome lory, how are you?';
} else {
return 'Go away!!!';
}
}
exit();
?>