本文实例讲述了PHP中soap用法。分享给大家供大家参考,具体如下:
一、首先要设置服务器环境
修改php.ini
得添加extension=php_soap.dll (加载soap 内置包)
修改soap.wsdl_cache_enabled=1 改为soap.wsdl_cache_enabled=0 这个是soap的缓存,测试的时候最好改为0,上线稳定了改为1
soap有两种模式一种是wsdl,一种是no-wsdl
二、熟悉几个函数
1. SoapServer
SoapServer用于创建php服务器端页面时定义可被调用的函数及返回 响应数据
格式:
$soap = new SoapServer($wsdl,$array);
其中,$wsdl
为soap使用得wsdl文件,wsdl是描述Web Service的一种 标准格式,若将$wsdl设置为null,则表示不使用wsdl模式。
$array
是 SoapServer的属性信息,是一个数组。
SoapServer对象的addFunction方法是用来声明哪个函数可以被客户端调用, 语法格式如下:
$soap->addFunction($function_name);
其中,$soap
是一个SoapServer对象,$function_name
是需要被调用的函数名。
SoapServer对象的handle方法用来处理用户输入并调用相应的函数,最后返回 给客户端处理的结果。语法格式如下:
$soap->handle([$soap_request]);
其中,$soap是一个SoapServer对象,$soap_request是一个可选参数,用来表示 用户的请求信息。如果不指定$soap_request,则表示服务器将接收用户的全部 请求。
2. SoapClient
SoapClient用于调用远程服务器上的SoapServer页面,并实现了对相应函数的调用
格式:
$soap = new SoapClient($wsdl,$array);
参数$wsdl和$array与SoapServer相同
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对象。
4. SoapHeader
soapheader用于描述soap的header信息,一般用于认证
/*
*SoapHeader参数说明如下所示:
*'http://tempuri.org/' namespace(命名空间可省略)
*'MySoapHeader' SoapHeader头的类名
*'array(...)' 存放标识身份的字符串参数
*'true' 是否必须处理该header
*/
格式:
$h = new SoapHeader('http://192.168.0.153/hao/', 'auth', '123456789', false, SOAP_ACTOR_NEXT);
三、实例
不用wsdl模式的代码
服务端:
//认证服务端
class Test{
public function auth($a)
{
if($a != '123456789'){
throw new SoapFault('Server', '您无权访问');
}
}
function say()
{
return 'Hi11111';
}
}
$srv = new SoapServer(null, array('uri' => 'http://192.168.0.153/hao'));
$srv->setClass('Test');
$srv->handle();
Test类中auth是认证判断的,这个方法对应客户端soapheader中的方法
客户端:
//加密的客户端
$cli = new SoapClient(null, array('uri' => 'http://192.168.0.153/hao/', 'location' => 'http://192.168.0.153/hao/test.php', 'trace' => true,'encoding'=>'utf-8'));
$h = new SoapHeader('http://192.168.0.153/hao/', 'auth', '123456789', false, SOAP_ACTOR_NEXT);
$cli->__setSoapHeaders(array($h));
try {
echo $cli->say();
} catch (Exception $e) {
echo $e->getMessage();
}
soapheader中auth对应服务端auth方法
如果不 认证,可以去掉下面这两行:
$h = new SoapHeader('http://192.168.0.153/hao/', 'auth', '123456789', false, SOAP_ACTOR_NEXT);
$cli->__setSoapHeaders(array($h));
wsdl模式
首先先生成wsdl文件,至于怎么生成网站很多
服务端:
//wsdl服务端
Require './server.class.php';
$server = new SoapServer('./server.wsdl');
$server->setClass('Server');
$server->handle();
server.class.php类代码
class Server {
public function auth($a){
if($a != '123456789'){
throw new SoapFault('Server', '您无权访问');
}
}
public function test() {
return 'you are testing';
}
}
客户端:
//wsdl文件客户端
$soap = new SoapClient('http://192.168.0.153/hao/server.wsdl'); //如果是远程,那当然写dizzylion.wsdl的URL了。
$h = new SoapHeader('http://192.168.0.153/hao/', 'auth', '123456789', false, SOAP_ACTOR_NEXT);
$soap->__setSoapHeaders(array($h));
try {
echo $soap->test();
} catch (Exception $e) {
echo $e->getMessage();
}
希望本文所述对大家PHP程序设计有所帮助。