平时很少写webService，一般都是需要给第三方提供接口的时候才去写。偶然的一个机会，打开了项目里现有的webService文件，发现前人所写的webService都是以简单的创建一个类，再将类里面的函数暴露给第三方调用，连WSDL都不支持，这就不是规范的webService接口定义了。

开发人员应该都知道，传统的webService是有wsdl支持的，就是介绍了，传入和返回，以及webService的一些基本结构介绍信息，这能很大限度的增加接口可读性和参考性。希望所有开发者能够自我养成良好的编码习惯，开发者最忌讳的就是怕麻烦，请尊重自己的职业。

服务端demo:
http://help.mudbest.com/php/demo_nusoap/webService/RefundService.php

http://help.mudbest.com/php/demo_nusoap/webService/RefundService.php?wsdl

下面nusoap的服务端(webService)和客户端(client)介绍一下简单实例。

nusoap支持类库下载地址：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/nusoap-0-9-5/

1、首先创建一个服务端：

这里用的是注册类，而不是注册函数，建议创建webService的时候将服务结构整理清晰。

class.refundStatusService.php

<?php
/**
 * 退票状态回显服务类库
 * @author hkshadow
 */
class refundStatusService{
	private $objDb = null;
	
	public function __construct(){
		
	}
	
	public function connect(){
		
	}
	
	public function hello($person, $interface){
		$greeting = 'Hello111, ' . $person &#91;'firstname'&#93; . '. It is nice to meet a ' . $person &#91;'age'&#93; . ' year old ' . $person &#91;'gender'&#93; . '.' . $interface &#91;'type'&#93;;
		$winner = 'Scott';
		//要返回的数据
		return array ('greeting' => $greeting, 'winner' => $winner );
	}
}
?>

建立服务（例如地址http://www.mudbest.com/webService.php）

require_once('comm/nusoap/nusoap.php');
require_once('webservice/RefundStatusService.php');
// 新建一个soap服务
$server = new soap_server ();
// 初始化支持wsdl
$server->configureWSDL ( 'hellowsdl2', 'urn:hellowsdl2' );
//设置返回时的编码
$server->soap_defencoding = 'UTF-8';
//是否utf8_decode()
$server->decode_utf8 = false;
//设置传入的编码
$server->xml_encoding = 'UTF-8';
// 定义接收的数据结构
$server->wsdl->addComplexType ( 'Person', 'complexType', 'struct', 'all', '', 
		//array ('type' => '1==2' );
		array ('type' => array ('name' => 'type', 'type' => 'xsd:string' ) ),	// 后面的type定义数据的类型，这个是string
		array ('firstname' => array ('name' => 'firstname', 'type' => 'xsd:string' ), 	// 后面的type定义数据的类型，这个是string
				'age' => array ('name' => 'age', 'type' => 'xsd:int' ), 	// 后面的type定义数据的类型，这个是int
				'gender' => array ('name' => 'gender', 'type' => 'xsd:string' ) )	// 后面的type定义数据的类型，这个是string
);

//定义返回数据结构
$server->wsdl->addComplexType ( 'SweepstakesGreeting', 'complexType', 'struct', 'all', '', array ('greeting' => array ('name' => 'greeting', 'type' => 'xsd:string' ), 'winner' => array ('name' => 'winner', 'type' => 'xsd:string' ) ) );


/**
备注：
array ('person' => 'tns:Person' )  这里声明是根据addComplexType ('Person')方法定义属性，如果只需要传入字符串，则直接xsd:string即可
// 定义接收的数据结构
$server->wsdl->addComplexType ( 'Person', 'complexType', 'struct', 'all', '', 
		//array ('type' => '1==2' );
		array ('type' => array ('name' => 'type', 'type' => 'xsd:string' ) ),	// 后面的type定义数据的类型，这个是string
		array ('firstname' => array ('name' => 'firstname', 'type' => 'xsd:string' ), 	// 后面的type定义数据的类型，这个是string
				'age' => array ('name' => 'age', 'type' => 'xsd:int' ), 	// 后面的type定义数据的类型，这个是int
				'gender' => array ('name' => 'gender', 'type' => 'xsd:string' ) )	// 后面的type定义数据的类型，这个是string
);
-----------------------------------------------------
array ('return' => 'tns:SweepstakesGreeting' )  这里声明是根据addComplexType ('SweepstakesGreeting')方法定义属性，如果只需要返回字符串，则直接xsd:string即可
//定义返回数据结构
$server->wsdl->addComplexType ( 'SweepstakesGreeting', 'complexType', 'struct', 'all', '', array ('greeting' => array ('name' => 'greeting', 'type' => 'xsd:string' ), 'winner' => array ('name' => 'winner', 'type' => 'xsd:string' ) ) );

*/
// 服务器定义的soap调用方法
$server->register ( 'refundStatusService.hello', 	// 这里注册的是类，类文件class.refundStatusService.php
		array ('person' => 'tns:Person' ), 	// 客户端传来的变量
		array ('return' => 'tns:SweepstakesGreeting' ), 	// 返回参数
		'urn:hellowsdl2', 	// soap名
		'urn:hellowsdl2#hello', 	// soap的方法名
		'rpc', 	// 使用的方式
		'encoded', 	// 编码
		'test'// 存档
		);	
		
		//请求时(试图)调用服务
		//$HTTP_RAW_POST_DATA = isset ( $HTTP_RAW_POST_DATA ) ? $HTTP_RAW_POST_DATA : '';
		$HTTP_RAW_POST_DATA = isset($GLOBALS['HTTP_RAW_POST_DATA']) ? $GLOBALS['HTTP_RAW_POST_DATA'] : '';
		//处理请求并且返回响应结果(processes request and returns response)
		$server->service ( $HTTP_RAW_POST_DATA );

至此服务端已经创建完成，接下来要做的便是客户端(client)了。

demo.php

// 包函nusoap.php
require_once(comm/nusoap/nusoap.php');
// 新建一个soap客户端，调用服务端提供的wsdl
// $client = new soapclient('http://www.mudbest.com/webService.php?wsdl', true);
$client = new nusoap_client ( 'http://www.mudbest.com/webService.php' );

// 查看一下是不是报错
$err = $client->getError ();
if ($err) {
	// 显示错误
	echo '<h2>Constructor error</h2><pre>' . $err . '</pre>';
}
// 要向服务端要传的参数
$interface = array ('type' => '1==2' );
$person = array ('firstname' => 'Willi', 'age' => 22, 'gender' => 'male' );

// 调用服务端的方法(这里注意call的名字与regisert名一样)
$result = $client->call ( 'refundStatusService.hello', array ('userInfo' => $person, 'interfaceType' => $interface ) );

//WSDL调用服务端的方法(这里注意call的名字与regisert名一样)
//$result = $client->call ( 'refundStatusService.hello');
// 错误审核
if ($client->fault) {
	echo '<h2>Fault</h2><pre>';
	print_r ( $result );
	echo '</pre>';
} else {
	$err = $client->getError ();
	if ($err) {
		echo '<h2>Error</h2><pre>' . $err . '</pre>';
	} else {
		echo '<h2>Result</h2><pre>';
		print_r ( $result );
		echo '</pre>';
	}
}
// 显示请求信息
echo '<h2>Request</h2>';
echo '<pre>' . htmlspecialchars ( $client->request, ENT_QUOTES ) . '</pre>';
// 显示返回信息
echo '<h2>Response</h2>';
echo '<pre>' . htmlspecialchars ( $client->response, ENT_QUOTES ) . '</pre>';
// 显示调试信息
echo '<h2>Debug</h2>';
echo '<pre>' . htmlspecialchars ( $client->debug_str, ENT_QUOTES ) . '</pre>';

到这里，服务端以及客户端已经创建完成。

当在浏览器上浏览http://www.mudbest.com/webService.php时会出现结构图。

当在浏览器上浏览http://www.mudbest.com/webService.php?wsdl时会出现xml格式。