NuSOAP的使用说明

最新推荐文章于 2021-03-26 14:29:01 发布
最新推荐文章于 2021-03-26 14:29:01 发布
阅读量3.9k 收藏 1
点赞数
分类专栏： WEB 技术 文章标签： soap parameters server web string 浏览器

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/ 或 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(' 客户端 ','','concatenate 函数的参数应该是两个字符串 ');
}
$soap = new soap_server;
$soap->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 ”的完整内容如下 : 

<?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(' 客户端 ','','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(' 客户端 ','','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

View the WSDL for the service. Click on an operation name to view it&apos;s details.

  • concatenate   

点击函数名称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. 更多的学习资源

 
daoquan
关注
专栏目录
PHP nusoap.php
03-15
NULL 博文链接：https://zongyukai20070419095606.iteye.com/blog/321599
nusoap.php
08-12
利用：nusoap.php 可以用类的方式访问WEB SERVICE；对应BLOG文章可以参考：http://blog.csdn.net/xocom/article/details/52188799
php与Webservices--NuSOAP的使用说明(转)
斗战圣Q
12-06 2963
 关于nusoap的使用 可以在网上搜搜如下:NuSOAP 是 PHP 环境下的 WEB 服务编程工具，用于创建或调用 WEB 服务。它是一个开源软件，当前版本是 0.7.2 ，支持 SOAP1.1 、 WSDL1.1 ，可以与其他支持 SOAP1.1 和 WSDL1.1 的系统互操作。 NuSOAP 完全由PHP语言编写，由一系列 PHP 类组成，不需要扩展库的支持，这种特性使得 NuS
应用NuSoap和PHP来构建Web services(代码测试未成功，以后学习)
weixin_34406796的博客
08-17 127
许多机构已经采用了Apach和PHP作为他们的Web应用环境。在Web services模式中采用PHP可能看上去可能会比较难。但是事实上，搭配NuSoap，你可以轻松的应用PHP构建SOAP的客户端和服务器端。为了说明如何应用NuSoap和PHP来构建Web services，我们将举一个简单的例子。这个例子应用程序由一个PHP Web services的服务器端和客户端组...
nusoap.php下载，下载nusoap.php
12-13
nusoap.php下载
nusoap-0.9.5及说明文档
06-16
总结来说，nusoap-0.9.5及其说明文档是学习和使用SOAP Web服务的宝贵资源。通过这个开源库，开发者不仅可以创建自己的Web服务，还能方便地访问和测试其他服务。深入理解和掌握nusoap，对于提升PHP开发者的技能水平，...
PHP使用NuSOAP调用Web服务的方法
12-18
在本文中，我们将深入探讨如何使用PHP的NuSOAP库来调用Web服务。NuSOAP是一个开源的PHP库，它提供了一种简单的方式来创建和使用Web服务。以下是对标题和描述中提到的知识点的详细说明： 1. **NuSOAP库**： NuSOAP...
NS NuSOAP Libraries-开源
05-13
2. **README.txt**：这个文件通常包含项目的基本信息、安装指南和使用说明，对于初学者来说是非常宝贵的资源。 3. **phoogle.php**：这是一个示例脚本，演示了如何使用NuSOAP库来创建一个简单的Web服务，类似于...
php7 nusoap下载
最新发布
12-19
然后按照官方提供的安装说明，逐步进行安装和配置。一般来说，安装php7 nusoap需要将其文件复制到php的扩展目录，并在php.ini文件中添加相应的配置指令。 安装完成后，还需要在项目中引入nusoap，根据项目需求进行...
nusoap.php及若干实例
11-26
包含nusoap.php所需库文件，以及24个实用例子
nusoap+php
12-20
一个用于soap请求的工具类。包含了php需要的所有东西、可以直接用。里面有例子
PHP的SOAP工具包--nusoap
11-16 873
什么是SOAP SOAP：简单对象访问协议，简单对象访问协议（SOAP）是一种轻量的、简单的、基于 XML 的协议，它被设计成在 WEB 上交换结构化的和固化的信息。 NuSOAP 是一组功能强大的PHP类，使得使用和创建SOAP消息变得相当简单。NuSOAP由Dirtrich Ayala编写，可以无缝地与很多最流行的SOAP服务实现交互，它遵循LGPL发布。NuSOAP提供了很多令人印象深刻
php nusoap 类,php – NuSOAP和内容类型
weixin_39883433的博客
03-13 102
无法弄清楚如何使NuSOAP使用UTF-8作为内容类型.它不断吐出“ISO-8859-1”.这是我尝试的相关代码位：$soapclient=new soapclient($url1,'wsdl');$soapclient->http_encoding='utf-8';$soapclient->defencoding='utf-8';if($soapclient->fault){$...
nusoap mysql_PHP的SOAP工具包--nusoap
weixin_35934979的博客
01-28 260
PHPERPHP技术交流 网络应用开发首页博客留言个人中心登录注册关于PHP的SOAP工具包--nusoap管理员2011-04-28 16:0374600条评论收藏什么是SOAPSOAP：简单对象访问协议，简单对象访问协议(SOAP)是一种轻量的、简单的、基于 XML 的协议，它被设计成在 WEB 上交换结构化的和固化的信息。NuSOAP 是一组功能强大的PHP类，使得使用和创建SOAP消息...
nusoap php版本,php - PHP Web服务NuSOAP复杂类型 - SO中文参考 - www.soinside.com
weixin_35980011的博客
03-26 172
我使用NuSOAP和客户端脚本编写了php web服务。我使用数组复杂类型返回一个复杂类型的数组，但它没有打印！server.php// Pull in the NuSOAP coderequire_once('nusoap-php5-0.9/lib/nusoap.php');ini_set ('soap.wsdl_cache_enabled', 0);// Create the server i...
NuSoap介绍 (php调用webservice)
大鹏
06-27 1177
Normal 0 7.8 磅 0 2 false false false EN-US ZH-CN X-NONE
php nusoap webservice,php使用nusoap创建WebService
weixin_35697297的博客
03-12 128
service:include_once("utils/lib/nusoap.php"); //加载nusoap库文件$server = new soap_server(); //生成对象$server->configureWSDL("screenshot_wsdl", "urn:screenshot_wsdl");$server->register("screenshot", //调...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值