php nusoap类的使用、用法、出错 及说明

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/，这里，可以下载到 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 的源文件包含到当前的代码文件里

 1 <?php
 2 require_once("lib/nusoap.php");
 3 //定义服务程序
 4 function hello() {
 5 return ‘Hello World!‘;
 6 }
 7 //初始化服务对象 , 这个对象是类 soap_server 的一个实例
 8 $soap = new soap_server; //调用服务对象的 register 方法注册需要被客户端访问的程序
 9 //只有注册过的程序，才能被远程客户端访问到
10 $soap->register(‘hello‘); //最后一步，把客户端通过 post 方式提交的数据，传递给服务对象的 service 方法
11 //service 方法处理输入的数据，调用相应的函数或方法，并且生成正确的反馈，传回给客户端
12 $soap->service($HTTP_RAW_POST_DATA);
13 ?>

至此， 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); 

    ‍//nusoap_client的参数： endpoint 端点(url) $wsdl = false判断url（$endpoint）是否为wsdl文件 proxyhost代理主机 proxyport代理端口 proxyusername 代理用户名 proxypassword代理用户密码
$proxy=$client -> getProxy(); // 创建代理对象 (soap_proxy 类 )
$str=$proxy->concatenate(" 参数 1"," 参数 2"); // 直接调用 WEB 服务
if (!$err=$proxy->getError()) {
echo " 程序返回 :",$str;
} else {
echo " 错误 :",$err;
}
?>对于nusoap出错解决方法：一般的问题都出在与PHP内置的soap类相冲突，解决方法有两个，一是不加载PHP的soap扩展；二是修改nusoap类中的SoapClient类名。

php nusoap类的使用、用法、出错 及说明,布布扣,bubuko.com

时间： 2024-10-25 04:23:40

php nusoap类的使用、用法、出错 及说明的相关文章

&lt;04&gt;【掌握】14-NSString 类介绍及用法+【掌握】15-NSString 字符串长度计算方法

[掌握]14-NSString 类介绍及用法 下面介绍了四种字符串书写格式 第二种是本质,第一种是特殊的写法,一定要熟练:第三种(这个格式化输出也很常见)和第四种先放一放 #import <Foundation/Foundation.h> int main(int argc, const char * argv[]) { @autoreleasepool { //NSString 是OC中字符串处理的类 //1.创建一个字符串(1) NSString *s = @"banzhang

实例讲解ThinkPHP的UploadFile文件上传类的详细用法

ThinkPHP文件上传自带了上传类,使用起来非常方便,我们将以一个文件上传实例来讲解ThinkPHP上传类的实际用法,上传类使用时有详细的中文注释,可以非常方便的告诉你类的一些方法或变量的使用方法.FileAction.class.php PHP Code复制内容到剪贴板 <?php class FileAction extends Action{ function index(){ $file=M('file'); $list=$file->select(); $this->assi

Java中File类的基本用法

File类的基本用法 java.io.File类:代表文件和目录.在开发中,读取文件.生成文件.删除文件.修改文件的属性时经常会用到此类. File类的常用构造方法:public File(String pathname) 以pathname为路径创建File对象,如果pathname是相对路径,则默认的当前路径在系统属性user.dir中存储. 文件的创建 import java.io.File; import java.io.IOException; public class Test {

java File类的常见用法

File类简单用法! [java] view plain copy print? [java] view plain copy print? import java.io.File; import java.io.IOException; public class TestFile { public void createFile(String path){ File file=new File(path); if(!file.exists()){//判断文件是否存在 try { file.cr

Java Enum类语法和用法解析

一.语法 1. Enum的全称为enumeration,中文俗称枚举类,学过C/C++等语言的人,应该都对它略知一二. 但在Java语言规范中,是在JDK 5版本中才引入的,存放在 java.lang 包中.在Java版的Enum实质是语法糖,其声明方式如下: 1 package felix.fu 2 public enum Color{ 3 RED, 4 BLUE, 5 BLACK, 6 YELLOW, 7 GREEN 8 } enum是用来声明枚举的关键字,声明定义的类都隐含继承了一个父类(

ThreadLocal类的实现用法

ThreadLocal是什么呢?其实ThreadLocal并非是一个线程的本地实现版本,它并不是一个Thread,而是threadlocalvariable(线程局部变量).也许把它命名为ThreadLocalVar更加合适.线程局部变量(ThreadLocal)其实的功用非常简单,就是为每一个使用该变量的线程都提供一个变量值的副本,是Java中一种较为特殊的线程绑定机制,是每一个线程都可以独立地改变自己的副本,而不会和其它线程的副本冲突. 从线程的角度看,每个线程都保持一个对其线程局部变量副本

String类的基本用法与注意点，StringBuffer类的用法

package cn.hncu.day8; public class RegExpDemo { public static void main(String[] args) { String str ="011-12345678"; boolean boo = str.matches("0\\d{2}-\\d{8}"); System.out.println(boo);//true str ="110-12345678"; boo = str.m

类python中高级用法

1. __call__用法 class Foo: def __init__(self): print('init') def __call__(self, *args, **kwargs): print('call') # obj = Foo() # obj() Foo()() 类对象后面加()是执行类中的__call__方法.用处稍后说 2. __int__和__str__方法 class Foo: def __init__(self): pass def __int__(self): ret

NSString类的相关用法

一.NSString字符串连接NSString* string; // 结果字符串 NSString* string1, string2; //已存在的字符串 1. string = [NSString initWithFormat:@"%@,%@", string1, string2 ];2. string = [string1 stringByAppendingString:string2];</p>3 . string = [string stringByAppend