nusoap wsdl 文件说明。。
我的服务器创建如下:
app::import('vendor', 'nusoap/lib/nusoap');
$server = new soap_server;
$server->configurewsdl('sum');
$server->register('sum',array('x'=>'xsd:string','y'=>'xsd:string'),array('return'=>'xsd:string'),'','http://localhost/ws/info/sum');
$http_raw_post_data = isset($http_raw_post_data) ? $http_raw_post_data : '';
$server->service($http_raw_post_data);
//$this->set('data',$server);
$this->autorender = false;
在浏览器里输入
http://localhost/ws/info?wsdl
返回xml信息中 包含这句
请问 soap:address location的值 我们可以在创建$server 的时候 设置吗,因为用的是cakephp 使用默认值 会出现出错。。
------解决方案--------------------
给个参考例子:
php调用webservice实例,看完就明白了
nusoap是php环境下的webservice编程工具,用于创建或调用webservice。它是一个开源软件,是完全采用php语言编写的、通过http收发soap消息的一系列php类,由nusphere corporation(http://dietrich.ganx4.com/nusoap/ )开发。nusoap的一个优势是不需要扩展库的支持,这种特性使得nusoap可以用于所有的php环境,不受服务器安全设置的影响。
方法一:直接调用
/******************************************************************************/
/* 文件名 : soapclient.php
/* 说 明 : webservice接口客户端例程
/******************************************************************************/
include(‘nusoap.php’);
// 创建一个soapclient对象,参数是server的wsdl
$client = new soapclient(‘http://localhost/webservices/service.asmx?wsdl’, ‘wsdl’);
// 参数转为数组形式传递
$arypara = array(‘strusername’=>’username’, ‘strpassword’=>md5(‘password’));
// 调用远程函数
$aryresult = $client->call(‘login’,$arypara);
//echo $client->debug_str;
/*
if (!$err=$client->geterror()) {
print_r($aryresult);
} else {
print “error: $err”;
}
*/
$document=$client->document;
echo
$document
soapdocument;
?>
方法二:代理方式调用
/******************************************************************************/
/* 文件名 : soapclient.php
/* 说 明 : webservice接口客户端例程
/******************************************************************************/
require(‘nusoap.php’);
//创建一个soapclient对象,参数是server的wsdl
$client=new soapclient(‘http://localhost/webservices/service.asmx?wsdl’, ‘wsdl’);
//生成proxy类
$proxy=$client->getproxy();
//调用远程函数
$aryresult=$proxy->login(‘username’,md5(‘password’));
//echo $client->debug_str;
/*
if (!$err=$proxy->geterror()) {
print_r($aryresult);
} else {
print “error: $err”;
}
*/
$document=$proxy->document;
echo
$document
soapdocument;
?>
许多使用nusoap 调用.net webservice或j2ee webservice的朋友可能都遇到过中文乱码问题,下面介绍这一问题的出现的原因和相应的解决方法。
nusoap调用webservice出现乱码的原因:
通常我们进行webservice开发时都是用的utf-8编码,这时我们需要设置:
$client->soap_defencoding = ‘utf-8′;
同时,需要让xml以同样的编码方式传递:
$client->xml_encoding = ‘utf-8′;
至此应该是一切正常了才对,但是我们在输出结果的时候,却发现返回的是乱码。
nusoap调用webservice出现乱码的解决方法:
实际上,开启了调试功能的朋友,相信会发现$client->response返回的是正确的结果,为什么$result = $client->call($action, array(‘parameters’ => $param)); 却是乱码呢?
研究过nusoap代码后我们会发现,当xml_encoding设置为utf-8时,nusoap会检测decode_utf8的设置,如果为true,会执行 php 里面的utf8_decode函数,而nusoap默认为true,因此,我们需要设置:
$client->soap_defencoding = ‘utf-8′;
$client->decode_utf8 = false;
$client->xml_encoding = ‘utf-8′;
补充介绍
nusoap 是 php 环境下的 web 服务编程工具,用于创建或调用 web 服务。它是一个开源软件,当前版本是 0.7.2 ,支持 soap1.1 、 wsdl1.1 ,可以与其他支持 soap1.1 和 wsdl1.1 的系统互操作。 nusoap 完全由php语言编写,由一系列 php 类组成,不需要扩展库的支持,这种特性使得 nusoap 可以用于所有的 php 环境,不受服务器安全设置的影响。
1. nusoap 的获取和安装
nusoap 项目建立在 sourceforge 上,网络地址是: http://sourceforge.net/projects/nusoap/ ,这里,可以下载到 nusoap 的最新的版本。
nusoap 的安装比较简单,把下载的 nusoap 的文件拷贝到服务器上,可以放在独立的目录里,也可以与程序代码放在相同的目录里,只要你的 php 代码能够访问到这些文件就可以了。
本文的测试环境基于 php4.3.2 和 nusoap 0.7.2 版本, nusoap 安装在 web 目录“ /nusoap ”里,有两个子目录, lib 和 samples 。其中, lib 目录下存放 nusoap 的所有源代码文件, samples 目录下是nusoap开发小组提供一些的例子。测试文件存放在 web 目录“ /nusoap ”里。
2. nusoap 的使用
nusoap 由一 php 的类组成,其中最常用到的是类soap_server和类soalclient。类soap_server 用于创建 web 服务,类soapclient在访问web服务时会用到。
2.1 一个简单的例子: hello world
这个例子将利用 nusoap 创建一个简单的 web 服务,并利用 nusoap 创建一个客户端程序,调用这个服务。这个服务唯一的功能就是向客户端返回一个字符串“ hello world ”。首先,创建 web 服务程序代码文件“ /nusoap/nusoap_server1.php ”:
//把 nusoap 的源文件包含到当前的代码文件里
register(‘hello’); //最后一步,把客户端通过 post 方式提交的数据,传递给服务对象的 service 方法。
//service 方法处理输入的数据,调用相应的函数或方法,并且生成正确的反馈,传回给客户端。
$soap->service($http_raw_post_data);
?> 至此, web 服务程序代码文件已经建好,接下来,创建一个客户端程序代码文件“ /nusoap/nusoap_client1.php ”,调用 web 服务:
//把 nusoap 的源文件包含到当前的代码文件里
call(‘hello’); //客户端对象的 geterror() 方法可以用来检查调用过程是否出现错误。
//如果没有错误, geterror() 方法返回 false ;如果有错误, geterror()方法返回错误信息。
if (!$err=$client->geterror()) {
echo ” 程序返回 :”,htmlentities($str,ent_quotes);
} else {
echo ” 错误 :”,htmlentities($err,ent_quotes);
}
?> 至此,客户端程序也建立好了,打开浏览器,访问客户端程序,看一下结果。这个例子,浏览器会显示字符串:“程序返回 :hello world! ”
2.2 传递参数和返回错误信息的方法
再通过例子说明传递参数和返回错误信息的方法。这个例子实现两个字符串的连接,参数是两个字符串,返回值是由两个参数连接而成的字符串。首先,创建服务程序代码文件“ /nusoap/nusoap_server2.php ”,完整的代码如下:
register(‘concatenate’);
$soap->service($http_raw_post_data);
?> 与 2.1 节 web 服务程序的代码比较,这里的代码结构大体是相同的。注意以下两点:
服务程序的定义不同,带有两个参数。 nusoap 注册服务程序的过程还是一样的,都是调用服务对象的 register 方法。
这里使用了 nusoap 的一个新类 soap_fault 。当传入的两个参数有一个不是字符串时,程序通过这个类把错误信息返回给客户端。这个类的构造函数有 4 个参数:
fault
code
必填参数 , 建议值为“ client ”或“ server ”,指明错误是客户端的错误还是服务端的错误。
faultactor
预留项,现在还没有使用
faultstring
错误的描述信息
faultdetail
可选项, xml 格式的数据 , 说明详细的错误信息
客户端程序代码文件“ /nusoap/nusoap_client2.php ”的完整内容如下 :
call(‘concatenate’,$parameters);
if (!$err=$client->geterror()) {
echo ” 程序返回 :”,$str;
} else {
echo ” 错误 :”,$err;
}
?> nusoap 的客户端调用带参数的 web 服务时,使用数组传递参数。 $parameters 是一个数组,其中依次是每个参数的值。客户端在调用远程的服务程序时,使用带有两个参数的 call 方法,第一个参数是服务程序的名称,第二个参数是服务程序的参数数组,这里是 $parameters 。通过浏览器访问上面的客户端程序,浏览器上会显示字符串:“ 程序返回 : 字符串 1 字符串 2 ”
接下来,试着给 web 服务程序传入错误参数,修改上面的客户端程序,把生成参数数组的语句改成: $parameters=array(“ 字符串 ”,12) ,再通过浏览器访问客户端程序,浏览器上会显示字符串:“错误 : 客户端 : concatenate 函数的参数应该是两个字符串”。 web 服务程序判断传入的参数有一个不是字符串,通过 soap_fault 给客户端返回错误信息。