php soap服务器
用php和soap来建立soap服务器非常容易。基本上,你只要写出你想要暴露给你的web service的函数,然后用soap去注册它们就可以了。另外还需要两步才能完成php soap服务器的建立。首先你还要在你的php代码中创建soap对象的一个实例,然后用http post方法将原始数据传给soap进行处理
在php5开始集成soap了,soap的使用比较简单,其中最常用到的类是soapserver和soapclient, 其中soapserver用于创建webservice服务端,类soapclient则用于调用webservice,也就是客户端。由于soap从php5便集成,只需要在php.ini里开启soap组件即可。
以windows下为例:
1
extension=php_soap.dll
soap实例:
1、首先创建服务端,由于集成后的php5不需要引入任何soap支持文件,直接创建即可,例如访问地址设置为http://127.0.0.1/test.php。
01
02
03
04
05
06
07
08
09
10
11
classtest{
functiondemo(){
return'hello word';
}
}
//开始创建webservice
//null可传入ip,第二个参数类似于授权标识,调用时会用到
$webservice= newsoapserver(null,array('uri'=>'test.php'));
//设置需要提供的类,setclass不难理解吧?
$webservice->setclass('test');
$webservice->handle();
至此,soap服务端创建完成。
2、调用刚刚创建的soap服务,同理,由于集成后的php5不需要引入任何soap支持文件,直接调用即可。
1
2
3
4
5
6
7
$client= newsoapclient(null,array(
location=> 'http://127.0.0.1/test.php',
uri => 'test.php', //请求标识,服务器和客户端必须对应
));
//至此,便可调用类里面的方法了
$demo= $client->demo();
var_dump($demo);
然而对于nusoap来说,灵活性强于soap,它们的操作过程基本一致,只是处理过程有少许的偏差,nusoap的使用也比较简单,其中最常用到的类是soap_server和nusoap_client, 其中soap_server用于创建 webservice服务端,类nusoap_client则用于调用webservice,也就是客户端。这两个类的定义都在lib/nusoap.php中,因此我们在创建 或调用webservice接口程序时均需要引用该文件。
nusoap是php环境下的webservice编程工具,用于创建或调用webservice。它是一个开源软件,是完全采用php语言编写的、通过http收发soap消息的一系列php类,由nusphere corporation(http://dietrich.ganx4.com/nusoap/ )开发。nusoap的一个优势是不需要扩展库的支持,这种特性使得nusoap可以用于所有的php环境,不受服务器安全设置的影响。
提供nusoap下载:nusoap-0.9.5
nusoap的实例:
1、首先要做的依然是创建服务端,刚刚说到了有少许的偏差,就在服务端创建这了,首先引入nusoap的支持类库
01
02
03
04
05
06
07
08
09
10
11
//引入nusoap支持类库
require_once('lib/nusoap.php');
$soap= newsoap_server();
$soap->configurewsdl('test');
//这里要说明一下register这个函数,第一个参数是需要调用的方法,第二个参数是传入的数据,第三个参数是传出的数据。
$soap->register('getteststr',
array(name=> xsd:string),// 参数,默认为 xsd:string
array(return=> xsd:string)
);
$http_raw_post_data= isset($http_raw_post_data) ?$http_raw_post_data: '';
$soap->service($http_raw_post_data);
至此,nusoap的服务端已经创建好,假设地址为http://127.0.0.1/test.php。
2、调用nusoap。在这之前我在这里封装了一下,文件为class.nusoapapi.php,代码如下。
01
02
03
04
05
06
07
08
09
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
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
_objsoap === null){
$this->_objsoap =newnusoap_client($_strsoapurl,$_strsoapwsdl);
}
}
/**
* 设置消息数据
* @param array $arrdata
*/
publicfunctionsetarrparam($arrdata){
$this->_arrparam =$arrdata;
}
/**
* 设置xml编码
* @param true / false $bool
*/
publicfunctionsetdecodeutf8($bool= false){
$this->_objsoap->decode_utf8 =$bool;
}
/**
* 设置http内容类型的字符编码
* @param str $strcode
*/
publicfunctionsetsoapdefencoding($strcode){
if(!empty($strcode)){
$this->_objsoap->soap_defencoding =$strcode;
}else{
$this->_objsoap->soap_defencoding =$this->_strsoapdefencoding;
}
}
publicfunctionsetxmlencoding($strcode){
if(!empty($strcode)){
$this->_objsoap->xml_encoding =$strcode;
}else{
$this->_objsoap->xml_encoding =$this->_strxmlencoding;
}
}
/**
* 获取数据
*/
publicfunctiongetrequestdata($fun){
$arrdata= array();
$arrdata= $this->_objsoap->call($fun,$this->_arrparam);
return$arrdata;
}
/**
* 数组转对象
* @param array $arrdata
*/
publicfunctionarrdataobj($arrdata){
//引用地址,而非引用拷贝
$objstdclass= newstdclass();
foreach($arrdataas$key=>$value){
if(is_array($value)){
$objstdclass->$key= $this->arrdataobj($value);
}else{
$objstdclass->$key= $value;
}
}
return$objstdclass;
}
}
?>
从这里开始调用执行过程:
01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
16
17
18
19
//定义webservice的请求url
define('servicedts_webserver_url','http://127.0.0.1/test.php?wsdl');
//引入刚刚封装的类
require_once('lib/class.nusoapapi.php');
//调用nusoap扩展类
$client= newnusoapapi(servicedts_webserver_url,true);
$client->setsoapdefencoding('utf-8');
$client->setdecodeutf8(false);
$client->setxmlencoding('utf-8');
$paras= array('name'=> 'hkshadow');
$client->setarrparam($paras);
$result= $client->getrequestdata('getteststr');
if(! $err= $client->geterror ()) {
echo 返回结果: , $result;
} else{
echo 调用出错: , $err;
}
//输出hello, { hkshadow } !
解说:
wsdl
wsdl是一种用于描述web service的xml语言。它是一种机读格式,把所有的访问服务所必须的信息提供给web service客户端。nusoap专门提供一个类进行wdsl文件的解析,并且从中提取信息。soapclient对象使用wsdl类来减轻开发者调用服务的难度。通过wsdl信息的帮助来创建报文,程序员仅仅需要知道操作的名字和参数就能调用它。
通过nusoap使用wsdl提供以下几点优点:
所有的服务元文件,如命名空间(namespaces),endpoint urls,参数名(parameter names)等等都可以直接从wsdl文件获得,这样就允许客户端动态的适应服务器端的变化。因为从服务器随时可以获得,所以这些数据不再需要在用户脚本中使用硬性编码。
它允许我们使用soap_proxy类。这个类派生自soapclient类,增加了wdsl文件中详细列出的操作所对应的方法。现在用户通过它可以直接调用这些方法。
soapclient 类包含一个getproxy()方 法,它返回一个soap_proxy类的一个对象。soap_proxy类派生自soapclient类,增加了对应于 wsdl文档中定义的操作的方法, 并且允许用户调用一个endpoint的远程方法。这仅仅适用于soapclient对象用wdsl文件初始化的情况。优点是易于用户使用,缺点是性能–php中创建对象是耗时的–且不为功利目的服务 (and this functionality serves no utilitarian purpose)。
01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
16
17
18
19
20
21
//调用nusoap扩展类
$client= newnusoapapi(servicedts_webserver_url,true);
$client->setsoapdefencoding('utf-8');
$client->setdecodeutf8(false);
$client->setxmlencoding('utf-8');
$paras= array('name'=> 'hkshadow');
$client->setarrparam($paras);
// $result = $client->getrequestdata('getteststr');
//生成proxy类
$proxy= $client->getproxy();
//调用远程函数
$sq= $proxy->getteststr('bruce lee');
if(!$err=$proxy->geterror()) {
print_r($sq);
} else{
printerror: $err;
}
print'request:<xmp>'.$p->request.'</xmp>';
print'response:<xmp>'.str_replace('>,>\n, $p->response).'</xmp>';
运行刚刚创建的服务端url,http://127.0.0.1/test.php,执行后的结果如下。
点击方法名称。这样我们通过在service中增加了几行代码我们就通过使用nusoap为service提供了一个可视化的文档。但是,这还不是所有我们能做的。
我们在service中通过使用nusoap增加一些wsdl的调用我们可以为service生成wsdl还有一些其他的文档。与此不同的是,在 client中我们能做的就有些少了,至少在我们的这个简单的例子中是这样。下面所示的这个client跟没有使用wsdl的client没有什么不同 的,唯一的不同就是解析soapclent class是通过提供wsdl的url来完成的,而不是之前的通过service endpoint。
nusoap调用webservice时可以对编码进行设置,出现乱码的解决方法如下:
1
2
3
4
$client= newnusoap_client(http://127.0.0.1/test.php?wsdl,true);
$client->soap_defencoding ='utf-8';
$client->decode_utf8 = false;
$client->xml_encoding ='utf-8';
文件代码不能有任何输出 , 否则调用时会报类似如下错误:
xml error parsing soap payload on line x( 行号 ): reserved xml name
如果在开启php5内置的soap时,nusoap的soapclient类和php5内置的soap类有冲突的话(我这里没有这样的情况,2种同时开放):
解决方案
1. 修改php.ini不加载php5内置的soap扩展(windows下是php_soap.dll)。
2. 也有给nusoap的soapclient类改名的。
至此,不论是php5内置的soap也好,还是nusoap扩展类也好,而对于webservice都是解决方案,从上面的部分例子可见,nusoap显得更灵活一些,而对于简单的webserice通信的话,php5内置的soap更快捷,不论是哪一种选择其一即可。
原文地址:http://www.mudbest.com/webservicephp%e7%9a%84soap%e4%b8%8enusoap%e6%9c%8d%e5%8a%a1%e7%ab%af%e4%b8%8e%e5%ae%a2%e6%88%b7%e7%ab%af%e7%9a%84%e9%80%9a%e4%bf%a1/
以上就介绍了webservicephp的soap与nusoap服务端与客户端的通信,包括了方面的内容,希望对php教程有兴趣的朋友有所帮助。
