Nusoap 学习笔记（一）

 

NuSOAP 是 PHP 环境下的 WEB 服务编程工具，用于创建或调用 WEB 服务，是php实现webservices的一个重要组成部分，我希望跟大家一起学习。

 

1.Hello World 的实现

hello world是应用最广泛的入门程序之一，先建服务端，代码如下：

 

<?
require_once("lib/nusoap.php");

function HelloWorld()
{
	return 'Hello,world';
}

$server = new soap_server;
$server->register('HelloWorld');
$server->service($HTTP_RAW_POST_DATA);

?>

 

 

HelloWorld()函数是一个服务程序，实际上就是返回一个"Hello,World!"的字符串；

$server 是一个服务对象，它是soap_server的一个实例；

register方法是注册被客户端访问的程序，参数是函数名称不带括号，函数的参数是作为register方法身的参数调用，下面有演示；

service是处理输入的数据，调用相对应的程序，返回给客户端。

 

综上，一个服务端的程序好了，下来就是客户端，代码如下：

 

<?
require_once("lib/nusoap.php");

$client = new soapclient('http://localhost/nusoap/server.php');

$string = $client->call('HelloWorld');
if(!$err = $client->getError()){
	echo "The program return:".htmlentities($string,ENT_QUOTES);
}
else
	echo "ERR:".htmlentities($err,ENT_QUOTES);

?>

 

 

$client 是一个soapclient的实例，地址用的是url不是相对地址；

call是调用web服务的程序，调用方式跟服务端的register方法基本一样；

getError检查掉用过程是否出错，没有错，返回的false，出错，返回出错信息。

 

在浏览器访问http://localhost/nusoap/client.php

得到输出的结果：Hello,World!

 

2.带参数和返回错误信息

服务端的程序代码如下：

 

<?
require_once("lib/nusoap.php");

function strings($string1,$string2)
{
	if(is_string($string1)&&is_string($string2))
		return "two strings:".$string1." and ".$string2;
		
	else
		return new soap_fault('Client','','two string required!');
}

$server = new soap_server;
$server->register('strings');
$server->service($HTTP_RAW_POST_DATA);

?>

 

 

 

 

code ,必填参数 , 建议值为“ Client ”或“ Server ”，指明错误是客户端的错误还是服务端的错误。 

 

faultactor ,预留项，现在还没有使用 

 

faultstring ,错误的描述信息 

 

faultdetail ,可选项， XML 格式的数据 , 说明详细的错误信息

 

 

 

客户端代码如下：

 

 

<?
require_once("lib/nusoap.php");

$client = new soapclient('http://localhost/nusoap/server1.php?',);
$parameters = array('Hello','world');

$string = $client->call('strings',$parameters);

if(!$err = $client->getError())
{
		echo "The server return:".$string;
}
else
	echo "ERROR:".$err;

?>

 

 

注意的是call的参数调用

 

 

 

3.创建支持wsdl的服务

 

服务端代码如下：

 

 

<?
require_once("lib/nusoap.php");

function strings($string1,$string2)
{
	if(is_string($string1)&&is_string($string2))
		return "two strings:".$string1." and ".$string2;
		
	else
		return new soap_fault('Client','','two string required!');
}

$server = new soap_server;
$server->configureWSDL('strings');
$server->register('strings',array("string1"=>"xsd:string",
"string2"=>"xsd:string"),array("return"=>"xsd:string"));

$HTTP_RAW_POST_DATA = isset($HTTP_RAW_POST_DATA)? $HTTP_RAW_POST_DATA:'';

$server->service($HTTP_RAW_POST_DATA);

?>

 

 

注意的是register的参数

通过http://localhost/nusoap/server1.php?wsdl  查看wsdl的内容如下图

 

 

客户端代码如下：

 

<?
require_once("lib/nusoap.php");

$client = new soapclient('http://localhost/nusoap/server1.php?wsdl',true);
$parameters = array('Hello','world');

$string = $client->call('strings',$parameters);

if(!$err = $client->getError())
{
		echo "The server return:".$string;
}
else
	echo "ERROR:".$err;
	
echo '<p/>';
echo 'Request:';
echo '<pre>',htmlspecialchars($client->request,ENT_QUOTES),'</pre>';
echo 'Response:';
echo '<pre>',htmlspecialchars($client->response,ENT_QUOTES ),'</pre>';

	

?>

 

为了方便调试我加入了request和response来显示运行信息。在服务端加入$debug=1再在客户端加上

echo '<h2>Debug</h2><pre>' . htmlspecialchars($client->getDebug(), ENT_QUOTES) . '</pre>';即显示调试内容。