前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
圈层
工具
发布
首页
学习
活动
专区
圈层
工具
MCP广场
社区首页 >专栏 >php 的webservice类库NuSoap介绍

php 的webservice类库NuSoap介绍

作者头像
Java架构师必看
发布于 2021-03-22 07:17:55
发布于 2021-03-22 07:17:55
4K00
代码可运行
举报
文章被收录于专栏:Java架构师必看Java架构师必看
运行总次数:0
代码可运行

 NuSOAP 是 PHP 环境下的 WEB 服务编程工具,用于创建或调用 WEB 服务。它是一个开源软件,当前版本是 0.9.5 ,支持 SOAP1.1 、 WSDL1.1 ,可以与其他支持 SOAP1.1 和 WSDL1.1 的系统互操作。 NuSOAP 完全由PHP语言编写,由一系列 PHP 类组成,不需要扩展库的支持,这种特性使得 NuSOAP 可以用于所有的 PHP 环境,不受服务器安全设置的影响。 

1. NuSOAP 的获取和安装 

NuSOAP 项目建立在 SourceForge 上,网络地址是: 

http://sourceforge.net/projects/nusoap/ 

http://sourceforge.net/projects/nusoap/files/nusoap/

或 http://dietrich.ganx4.com/nusoap,这里,

可以下载到 NuSOAP 的最新的版本。 

NuSOAP 的安装比较简单,把下载的 NuSOAP 的文件拷贝到服务器上,可以放在独立的目录里,也可以与程序代码放在相同的目录里,只要你的 PHP 代码能够访问到这些文件就可以了。 

本文的测试环境基于 PHP5.2.6 和 NuSOAP 0.9.5 版本, 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 ”: 

代码语言:javascript
代码运行次数:0
运行
复制
代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
//把 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);
?> 
代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
至此, WEB 服务程序代码文件已经建好,接下来,创建一个客户端程序代码文件“ /nusoap/nusoap_client1.php ”,调用 WEB 服务: 
代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
//把 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 ”,完整的代码如下: 

代码语言:javascript
代码运行次数:0
运行
复制
代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
<?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 ”的完整内容如下 : 

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
<?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 成员变量包含这些信息,在程序中显示出这两个变量的内容,可以帮助分析程序运行的情况。看下面的代码:

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
<?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 信息来查看调试信息。

代码语言:javascript
代码运行次数:0
运行
复制
代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
<?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”。 

代码语言:javascript
代码运行次数:0
运行
复制
代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
<?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 ” 

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
<?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 方法。看下面的代码。 

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
<?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;
}
?> 

本文由来源 21aspnet,由 javajgs_com 整理编辑,其版权均为 21aspnet 所有,文章内容系作者个人观点,不代表 Java架构师必看 对观点赞同或支持。如需转载,请注明文章来源。

本文参与 腾讯云自媒体同步曝光计划,分享自作者个人站点/博客。
如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
暂无评论
推荐阅读
编辑精选文章
换一批
php使用NuSoap产生webservice结合WSDL让asp.net调用
类别:PHP 评论:0 浏览:513 发表时间:2009-09-10 16:59:38
Java架构师必看
2021/03/22
3.4K0
php使用NuSoap产生webservice结合WSDL让asp.net调用
PHP调用Webservice实例[通俗易懂]
NuSoap是PHP环境下的WebService编程工具,用于创建或调用WebService。它是一个开源软件,是完全采用PHP语言编写的、通过HTTP收发SOAP消息的一系列PHP类,由NuSphere Corporation(http://dietrich.ganx4.com/nusoap/ )开发。NuSOAP的一个优势是不需要扩展库的支持,这种特性使得NuSoap可以用于所有的PHP环境,不受服务器安全设置的影响。  
全栈程序员站长
2022/09/13
2.8K0
在Codeigniter框架中使用NuSOAP
NuSOAP 是一组功能强大的PHP类,这个工具的发布让使用和创建SOAP消息变得相当简单。 NuSOAP有Dirtrich Ayala编写,可以无缝的与许多最流行的SOAP服务实现交互,它以LGPL协议进行发布。NuSOAP的主要特性包括:
大江小浪
2018/07/25
1.2K0
在Codeigniter框架中使用NuSOAP
PHP与API讲解(一)
  API代表应用程序编程接口,而接口指的是一个特定的服务、一个应用程序或者其他程序的公共模块。
那一叶随风
2018/08/22
1.4K0
PHP与API讲解(一)
Java写 soapclient,PHP通过SoapClient调用Java发布的WebService
http 是指:接口端提供http链接,将数据以json或XML格式输出到网页中。php调用端通过file_get_contents或curl方法来调用,GET/POST方式来传参。
全栈程序员站长
2022/11/17
2.4K0
PHP5下WSDL,SOAP调用实现过程
SOAP(Simple Object Access Protocol )简单对象访问协议是在分散或分布式的环境中交换信息的简单的协议,是一个基于XML的协议,它包括四个部分:SOAP封装(envelop),封装定义 了一个描述消息中的内容是什么,是谁发送的,谁应当接受并处理它以及如何处理它们的框架;SOAP编码规则(encoding rules),用于表示应用程序需要使用的数据类型的实例; SOAP RPC表示(RPC representation),表示远程过程调用和应答的协定;SOAP绑定(binding),使用底层协议交换信息。
星哥玩云
2022/07/05
9410
建立自己的Web service(SOAP篇)
  Web service是一个平台独立的,低耦合的,自包含的、基于可编程的web的应用程序,可使用开放的XML(标准通用标记语言下的一个子集)标准来描述、发布、发现、协调和配置这些应用程序,用于开发分布式的互操作的应用程序。
那一叶随风
2018/08/22
2.4K0
建立自己的Web service(SOAP篇)
php .asmx,php实现通过soap调用.Net的WebService asmx文件
本文实例讲述了php实现通过soap调用.Net的WebService asmx文件。分享给大家供大家参考,具体如下:
全栈程序员站长
2022/06/27
1.2K0
PHP Webservice的发布与调用
发布出来的*.wsdl文件,其实是一个xml格式的文件,生成这个文件可以通过第3方软件,如ZendStudio 就可以生成。
Java架构师必看
2021/03/22
1.4K0
PHP Webservice的发布与调用
java调用php的webService
1.首先先下载php的webservice包:NuSOAP,自己到官网去下载,链接就不给出来了,自己去google吧
黄啊码
2020/05/29
1.9K0
PHP使用SOAP调用.net的WebService问题
项目的需求,需要和一个.net系统进行数据交换,合作方提供了一个WebService接口。这个与一般的PHP POST或GET传值再查库拿数据的思路有点不一样,需要用到SOAP模块,处理方法也很简单,
wangxl
2018/03/07
1.8K0
php webservice实例
 首先大家要简单了解了何谓webservice,接下来就做两个非常简单的例子,webservice还是逃不开server端与client端。
Java架构师必看
2021/03/22
8410
WebService使用介绍(一)
1.编写SEI(Service Endpoint Interface),SEI在webservice中称为portType,在java中称为接口。
HUC思梦
2020/09/03
1.2K0
WebService使用介绍(一)
当 PHP 反序列化遇上 SSRF
SOAP(Simple Object Access Protocol)是一种在 web service 通信时所用的基于 xml 的协议。
wywwzjj
2023/05/09
9900
当 PHP 反序列化遇上 SSRF
gsoap开发webservice
gSOAP编译工具提供了一个SOAP/XML 关于C/C++ 语言的实现,从而让C/C++语言开发web服务或客户端程序的工作变得轻松了很多。绝大多数的C++web服务工具包提供一组API函数类库来处理特定的SOAP数据结构,这样就使得用户必须改变程序结构来适应相关的类库。与之相反,gSOAP利用编译器技术提供了一组透明化的SOAP API,并将与开发无关的SOAP实现细节相关的内容对用户隐藏起来。 gSOAP的编译器能够自动的将用户定义的本地化的C或C++数据类型转变为符合XML语法的数据结构,反之亦然。
cloudskyme
2018/03/20
1.9K0
gsoap开发webservice
使用WCF进行跨平台开发之二(IIS托管WCF服务并使用php平台调用)1.系统必备2.在IIS中托管WCF服务3.使用PHP调用托管在IIS中的WCF服务
上一篇中,使用控制台托管了WCF服务,但是如果想从PHP和java平台调用,必须将其托管到IIS中(并不是必须的,还是有其他的方式的 比如windows azure) 1.系统必备      首先,必须打开IIS和WAS,如果没有,可以在控制面板--程序--打开或关闭Windows功能打开。      而后必须的当然是php环境,这就根据您自己的需求配置啦,但是必须注意的是,必须打开php.ini中soap的扩展,步骤是,打开php.ini,搜索php_soap.dll,去掉前面的注释“;”,然后重起php
小白哥哥
2018/03/07
2.3K0
使用WCF进行跨平台开发之二(IIS托管WCF服务并使用php平台调用)1.系统必备2.在IIS中托管WCF服务3.使用PHP调用托管在IIS中的WCF服务
一个简单的AXIS远程调用Web Service示例
我们通常都将编写好的Web Service发布在Tomcat或者其他应用服务器上,然后通过浏览器调用该Web Service,返回规范的XML文件。但是如果我们不通过浏览器调用,而是通过客户端程序调用,该如何实现?      接下来,我们利用Eclipse作为开发工具,演示一个Axis调用WebService的简单示例。步骤如下: 第一步:新建Web Project 。 第二步:导入AXIS类库。(官方下载:http://apache.etoak.com//axis/axis2/java/core
Java学习123
2018/05/16
2.5K0
mysql介绍+php效率常识
mysql的FIND_IN_SET函数使用方法 有个文章表里面有个type字段,他存储的是文章类型,有 1头条,2推荐,3热点,4图文 …..11,12,13等等 现在有篇文章他既是 头条,又是热点,还是图文, type中以 1,3,4的格式存储. 那们我们如何用sql查找所有type中有4图文标准的文章呢, 这就要我们的find_in_set出马的时候到了. 先看mysql手册中find_in_set函数的语法: FIND_IN_SET(str,strlist) 假如字符串str 在由N 子链组成的字符串
wangxl
2018/03/07
2.9K0
SOA 面向服务框架设计与实现
文章节选自 《Netkiller Architect 手札》 由于Java 语言的编译与重启不可抗拒缺陷,所选择使用PHP弥补这个缺陷。 在合适的场景中使用PHP 为 Java 提供 SOA 服务有很
netkiller old
2018/03/05
1.5K0
SOA 面向服务框架设计与实现
WebService入门学习一
参考:https://blog.csdn.net/c99463904/article/details/76018436
别先生
2020/12/01
1.8K0
WebService入门学习一
推荐阅读
相关推荐
php使用NuSoap产生webservice结合WSDL让asp.net调用
更多 >
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档
本文部分代码块支持一键运行,欢迎体验
本文部分代码块支持一键运行,欢迎体验