php用soap创建webservice
php提供了一个专门用于soap操作的扩展库,使用该扩展库后
可以直接在php中进行soap操作。下面将介绍soap的基本操作。
一、soap扩展的使用方法
php的soap扩展库通过soap协议实现了客服端与服务器端的
数据交互操作。从php5.0后,php就自带了soap的支持。使用
soap扩展库首先需要修改php安装目录下的配置文件php.ini
来激活soap扩展库。
在php.ini文件中找到如下所示的一行代码,去掉前面的注释(;)。
;extension=php_soap.dll
修改后,重启web服务器即可激活soap扩展。在soap扩展库中,主要
包括三种对象。
1、SoapServer
SoapServer用于创建php服务器端页面时定义可被调用的函数及返回
响应数据。创建一个SoapServer对象的语法格式如下:
$soap = new SoapServer($wsdl,$array);
其中,$wsdl为soap使用得wsdl文件,wsdl是描述Web Service的一种
标准格式,若将$wsdl设置为null,则表示不使用wsdl模式。
生成wsdl文件:
使用SoapDiscovery.class.php来生成wsdl文件。修改其中代码:
//return sprintf('%s%s%s%s%s%s', $headerWSDL, $portTypeWSDL, $bindingWSDL, $serviceWSDL, $messageWSDL, '</definitions>'); $fso = fopen($this->class_name . ".wsdl", "w"); fwrite($fso, sprintf('%s%s%s%s%s%s', $headerWSDL, $portTypeWSDL, $bindingWSDL, $serviceWSDL, $messageWSDL, '</definitions>'));
$array是SoapServer的属性信息,是一个数组。
交互时的数组格式:
array( array( '参数名':参数值 ) )
不是二维数组将会报错,未知原因
SoapServer对象的addFunction方法是用来声明哪个函数可以被客户端调用,
语法格式如下:
$soap->addFunction($function_name);
其中,$soap是一个SoapServer对象,$function_name是需要被调用的函数名。
SoapServer对象的handle方法用来处理用户输入并调用相应的函数,最后返回
给客户端处理的结果。语法格式如下:
$soap->handle([$soap_request]);
其中,$soap是一个SoapServer对象,$soap_request是一个可选参数,用来表示
用户的请求信息。如果不指定$soap_request,则表示服务器将接收用户的全部
请求。
2、SoapCliet
SoapClient用于调用远程服务器上的SoapServer页面,并实现了对相应函数的调用
。创建一个SoapClient对象的语法格式如下:
$soap = new SoapClient($wsdl,$array);
其中,参数$wsdl和$array与SoapServer相同。
$wsdl的地址示例:http://www.zox.com/soap?wsdl
创建SoapClient对象后,调用服务端页面中的函数相当于调用了SoapClient的方法,
创建语法如下:
$soap->user_function($params);
其中,$soap是一个SoapClient对象,user_function是服务器端要调用的函数,$params
是要传入函数的参数。
3、SoapFault
SoapFault用于生成soap访问过程中可能出现的错误。创建一个soapFault对象的语法格式
如下:
$fault = new SoapFault($faultcode,$faultstring);
其中,$faultcode是用户定义的错误代码,$faultstring是用户自定义的错误信息。soapFault
对象会在服务器端页面出现错误时自动生成,或者通过用户自行创建SoapFault对象时生成。对于
Soap访问时出现的错误,客户端可通过捕捉SoapFalut对象来获得相应的错误信息。
在客户端捕获SoapFault对象后,可以通过下面的代码获得错误代码和错误信息。
$fault->faultcode;//错误代码
$fault->faultstring;//错误信息
其中,$fault是在前面创建的SoapFault对象。