1. NuSOAP 的获取和安装

NuSOAP 项目建立在 SourceForge 上，网络地址是： http://sourceforge.net/projects/nusoap/ 或 http://dietrich.ganx4.com/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 的源文件包含到当前的代码文件里
  <?php  require_once("lib/nusoap.php");
  //定义服务程序
  function hello() {
    return 'Hello World!';
  }
  //初始化服务对象 , 这个对象是类 soap_server 的一个实例  
  $soap = new soap_server; 

  //调用服务对象的 register 方法注册需要被客户端访问的程序。  
  //只有注册过的程序，才能被远程客户端访问到。
  $soap->register('hello'); 

  //最后一步，把客户端通过 post 方式提交的数据，传递给服务对象的 service 方法。
  //service 方法处理输入的数据，调用相应的函数或方法，并且生成正确的反馈，传回给客户端。 
  $soap->service($HTTP_RAW_POST_DATA);
?> 

至此， WEB 服务程序代码文件已经建好，接下来，创建一个客户端程序代码文件“ /nusoap/nusoap_client1.php ”，调用 WEB 服务：

//把 NuSOAP 的源文件包含到当前的代码文件里
<?php
  require_once("lib/nusoap.php");  
  //初始化客户端对象，这个对象是类 soapclient 的一个实例，  
  //把服务程序的 URL 地址传递给soapclient类的构造函数。
   $client = new soapclient('http://127.0.0.1/nusoap/nusoap_server1.php'); 

  //利用客户端对象的 call 方法调用 WEB 服务的程序$str=$client->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 ”，完整的代码如下：

<?php
   require_once("lib/nusoap.php");
   function concatenate($str1,$str2) {
     if (is_string($str1) && is_string($str2))
       return $str1 . $str2;
     else
       return new soap_fault('client','','concatenate 函数的参数应该是两个字符串 ');  
  }
  $soap = new soap_server;
  $soap->register('concatenate');
  $soap->service($HTTP_RAW_POST_DATA);
?> 

与 2.1 节 WEB 服务程序的代码比较，这里的代码结构大体是相同的。注意以下两点：

    
• 服务程序的定义不同，带有两个参数。 NuSOAP 注册服务程序的过程还是一样的，都是调用服务对象的 register 方法。
    
    
• 这里使用了 NuSOAP 的一个新类 soap_fault 。当传入的两个参数有一个不是字符串时，程序通过这个类把错误信息返回给客户端。这个类的构造函数有 4 个参数：
    

客户端程序代码文件“ /nusoap/nusoap_client2.php ”的完整内容如下 :

<?php
  require_once("lib/nusoap.php");
  $client = new soapclient('http://127.0.0.1/nusoap/nusoap_server2.php');
  $parameters=array(' 字符串 1',' 字符串 2'); 
  $str=$client->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 给客户端返回错误信息。

2.3 调试的方法

NuSOAP中常用的调试方法有三种:

2.3.1 soapclient 类的 request 和 response 成员变量

最直接的调试方法就是检查访问 WEB 服务的过程中，客户端发出的 request 信息和服务端返回的 response 信 息。 soapclient 类的 request 和 response 成员变量包含这些信息，在程序中显示出这两个变量的内容，可以帮助分析程序运 行的情况。看下面的代码:

<?php
  require_once("lib/nusoap.php");
  $client = new soapclient('http://127.0.0.1/nusoap/nusoap_server2.php');
  $parameters=array(' 字符串 1',' 字符串 2');
  $str=$client->call('concatenate',$parameters);
  if (!$err=$client->getError()) {
    echo " 程序返回 :",$str;}
  else {
    echo " 错误 :",$err;}
  //下面显示request和response 变量的内容
  echo '<p/>';
  echo 'Request:';
  echo '<pre>',htmlspecialchars($client->request,ENT_QUOTES),'</pre>';
  echo 'Response:';
  echo '<pre>',htmlspecialchars($client->response,ENT_QUOTES ),'</pre>';
 ?> 

2.3.2 soapclient 类的 debug_str 成员变量

soapclient 类的 debug_str 成员变量提供了更为详细的调试信息，查看这个变量的内容，可以更好地帮助程序调试。

2.3.3 WEB 服务程序提供的调试方法

WEB 服务程序代码中，在创建 soap_server 类的实例前，定义变量 $debug=1 。调试信息作为备注，放在 SOAP 消息的尾部返回客户端，客户端通过查看 WEB 服务的 response 信息来查看调试信息。

<?php
  require_once("lib/nusoap.php");
  function concatenate($str1,$str2) {
    if (is_string($str1) && is_string($str2))
       return $str1 . $str2;
    else
       return new soap_fault('client','','concatenate 函数的参数应该是两个字符串 ');
  }
  $debug=1; //定义调试
  $soap = new soap_server;
  $soap->register('concatenate');
  $soap->service($HTTP_RAW_POST_DATA);
?> 

2.4 对 WSDL 的支持

NuSOAP 内部通过类 "WSDL" 实现对 WSDL 的支持。对于 NuSOAP 的用户来说，不需要关心内部的WSDL类是如何工作的，正确地使用 soap_server 类和 soapclient 类就可以实现对 WSDL 的支持。

2.4.1 创建支持 WSDL 的 WEB 服务

为了实现 WEB 服务程序对 WSDL 的支持，需要使用 soap_server 的 configureWSDL 方法，并且在调 用 soap_server 的 register 方法注册 WEB 服务程序时，需要提供更详细的参数。看下面的代码，代码的文件名 是 “/nusoap/nusoap_server3.php”。

<?php
  require_once("lib/nusoap.php");
  function concatenate($str1,$str2) {
     if (is_string($str1) && is_string($str2))
       return $str1 . $str2;
     else
       return new soap_fault('client','','concatenate 函数的参数应该是两个字符串 ');
  }
  $soap = new soap_server;
  $soap->configureWSDL('concatenate'); 
  // 初始化对 WSDL 的支持
  // 注册服务
  $soap->register('concatenate',
                             array("str1"=>"xsd:string","str2"=>"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);
?> 

现在打开浏览器，访问刚才建立的文件，http://127.0.0.1/nusoap/nusoap_server3.php，结果如下：

点击函数名称concatenate，可以看到对函数的描述。点击"WSDL"，或者访问WEB服务文件，并在后面加上查询字符串"?wsdl" (http://127.0.0.1/nusoap/nusoap_server3.php?wsdl)，可以得到WEB服务的WSDL内容。

2.4.2 通过 WSDL 调用 WEB 服务

通过 WSDL 调用 WEB 服务，与不通过 WSDL 调用 WEB 服务，程序的结构大体相同。区别在于，通过 WSDL 调用 WEB 服 务，初始化 soapclient 类时，传入两个参数到 soapclient 的构造函数，第一个参数是 WSDL 文件的地址，第二个参数指定是否 使用 WSDL ，指定为 true 即可。看下面的代码，代码的文件名是 “ /nusoap/nusoap_client3.php ”

<?php
  require_once("lib/nusoap.php");
  $client = new soapclient('http://127.0.0.1/nusoap/nusoap_server3.php?wsdl',true);
  $parameters=array(' 字符串 1',' 字符串 2');
  $str=$client->call('concatenate',$parameters);
  if (!$err=$client->getError()) {
     echo " 程序返回 :",$str;}
  else {
     echo " 错误 :",$err;}
?> 

2.4.3 代理的使用

NuSOAP 提供代理的方法调用远程 WEB 服务。这种方法，在客户端程序里面创建一个远程服务的代理对象，通过代理直接调用远程的 WEB 服务，而不需要通过 soalclient 类的 call 方法。看下面的代码。

<?php
  require_once("lib/nusoap.php");
  $client = new soapclient('http://127.0.0.1/nusoap/nusoap_server3.php?wsdl',true);
  $proxy=$client -> getProxy(); // 创建代理对象 (soap_proxy 类 )
  $str=$proxy->concatenate(" 参数 1"," 参数 2"); // 直接调用 WEB 服务
  if (!$err=$proxy->getError()) { 
     echo " 程序返回 :",$str;} 
  else { 
     echo " 错误 :",$err;}
?> 

3. 更多的学习资源

    
• http://dietrich.ganx4.com/nusoap/
    
    
• Scott Nichol. Programming with NuSOAP. 24 Apr 2003
    
    
• Scott Nichol. Programming with NuSOAP Part 2. 29 May 2003
    
    
• Scott Nichol. Introduction to NuSOAP. 03 Nov 2004
    
    
• Scott Nichol. Programming with NuSOAP Using WSDL. 11 Nov 2003
    

              ----转自 http://www.cnblogs.com/lwlzyjl/archive/2007/11/08/953258.html

　　现在把 “设置” 一节中在 php.ini 中注释掉的行取消注释，并重新启动 Apache。现在装入了调试器，Eclipse 能够和它挂上了。

　　现在在 Eclipse 中设计调试环境。请创建新的 test4.php 文件，先保持为空。现在单击 Run > Debug。在左侧面板中选择 PHP DBG Script，并单击 New。现在转到 File 选项卡，输入当前项目 debugArticle 以及想要调试的文件 test4.php。现在转到 Environment 选项卡，然后再到 Interpreter 子选项卡。在 PHP 的安装目录中找到 php.exe 文件（我的是 c:\apps\php5.0.3\php.exe）。现在单击 Remote Debug 子选项卡，选择 Remote Debug，如果没有使用 Windows，请取消 “Open with DBGSession URL in internal browser box” 复选框。把 Remote Source 路径设置成与要测试的 PHP 脚本的绝对路径（不是 Web 路径）相同（我的设置是 c:\www\debugArticle\test4.php）。现在单击 Debug。

　　现在应当装入 Debug 透视图，如图 8 所示。否则，请单击 Window > Open Perspective > Other，并选择 Debug。

图 8. Eclipse 中的 Debug 透视图

　　现在可以设置断点了。

　　对于本文中使用的插件和扩展的版本，断点功能是必需的，因为 PHP 在把输出发送到浏览器之前会缓冲它。除此之外，需要做的不仅仅是设置一个断点把当前显示数据刷新到 Web 浏览器，所以要像下面和图 8 所示那样定义 test4.php。

清单 4. 设置和创建断点

　　breakpoint() 函数会把缓冲的输出和其他缓冲的数据刷新到 Web 浏览器。对 sleep(.1) 的调用是必需的，这样代码中止于 debugBreak() 之前，服务器才有足够的时间把数据刷新到 Web 浏览器，这个函数是前面下载的 PHP 调试器扩展的内部函数。这样，调用 breakpoint() 会把 HTML 块、print() 和 echo() 语句的数据刷新到浏览器，然后中止代码执行。

　　在像清单 4 那样编写完代码之后，可以打开浏览器并指向 test4.php，或者可以查看 PHP 浏览器窗口（我的是 http://localhost/debugArticle/test4.php）。每次输入和保存文件时，在 PHP 浏览器窗口中就已经启动了调试序列。如果不使用 Windows，请通过浏览器查看 test4.php。在保存了文件之后，用 F8 或单击 Run > Resume 继续代码执行。持续这么做，直到最后一行输出是 END! 为止（参见图 9、10 和 11）。

图 9. 初始的到第一个断点的 PHP 浏览器输出

　　请注意图 9 中的 Debug 窗口如何把执行显示为挂起的。

图 10. 第一个断点之后到第二个断点之前的 PHP 浏览器输出

　　图 10 的 Debug 窗口仍然把执行显示为挂起，而第二组数据显示在 PHP 浏览器中。

图 11. 完整的 PHP 浏览器输出

　　注意，图 11 的 Debug 窗口中的代码不再挂起，整个脚本已经执行，如图 11 中的 PHP 浏览器所示。

　　既然已经看到了用 PHPEclipse 和调试器扩展进行开发的优势，那么很难想像没有它会怎么样。

　　结束语

　　现在已经向 PHP 的调试技术集中添加了错误报告的运用、print 语句、PHPEclipse 和调试器扩展，您可以通过减少每行代码的错误数量，成为更有效的 PHP 编码人员。请参阅 参考资料 获得一些 PHP 教程，可以在上面测试这些新技能。