关于SOAP的几篇文章

转载自：http://www.neatstudio.com/show-1598-1.shtml

PHP操作soap我总觉得是一件非常痛苦的事情，但没有办法，现在很多功能都是基于WebService的，比如那个amazon的，但其实很多 公司都也还是提供了restful之类的接口，使得PHP与其他系统的数据交换比较方便。但让人痛苦的，有时候，你PHP不得不充当 soapServer，这时候，怎么做呢？zendstudio可以根据你的函数和类，帮你生成wsdl，但大多数情况下，你没有直接生成的手段，怎么 办？官方的soapServer功能也太少了一点。你是否还准备用nuSoap来充当server呢？

搜集了一些资料，用来方便的协助你生成soap接口。如果只是自己的内部调用，可以尝试用phprpc或者它的升级版hprose进行尝试。

1、利用NuSOAP发布wsdl。这是PHP5之前的做法了，因为在PHP5之后，直接有soap库支持，如何发布wsdl，请看：http://hi.baidu.com/arlon/blog/item/d8267d1e6ca4adf01ad576cc.html ，然而这个网址打开是白屏的，内容可以稍看这里：

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'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 " 程序返回 :",$err; } ?>

2、利用PHP5自带的soapServer，在手册上，关于如何创建，写了很多例子，就象：

<?php $server = new SoapServer("some.wsdl"); $server = new SoapServer("some.wsdl",array('soap_version' => SOAP_1_2)); $server = new SoapServer("some.wsdl",array('actor' => "http://example.org/ts-tests/C")); $server = new SoapServer("some.wsdl",array('encoding'=>'ISO-8859-1')); $server = new SoapServer(null,array('uri' => "http://test-uri/")); class MyBook { public $title; public $author; } $server = new SoapServer("books.wsdl",array('classmap' => array('book' => "MyBook"))); ?>

反正，我是觉得很痛苦，不过所幸现在的IDE都支持了直接发布wsdl文件，netbeans可以，zendstudio也可以。所以，也就方便了开发

3、利用开源组件，比如：webservice helper， http://www.jool.nl/new/1,webservice_helper.html ，虽然它也是其于soapServer，但是集成的一些代码可以让你少走很多弯路。

比如，它默认就自带了一个contactManager的发布，具体的一些配置，可以看config.php，当然你也可以参考它的一些类，也充实你自己的类库（本来官网有教程的，可能是因为时间太久远了，该教程已经跳到ipublisher的教程上去了）

4、利用框架实现webService。在这里，估计又有很多分支了，比如zend framework，比如xxx和xxxx等，我由于最近在用yii，所以就看了yii的一个小小的实现

介绍页在这里：http://www.yiiframework.com/doc/guide/1.0/zh_cn/topics.webservice

看它的实现是非常简单，在Controller里增加一个转换wsdl的Action，然后，在要提供的方法上面用phpdoc来进行注释。定义传入参数的数据类型等

• str/string: 对应 xsd:string ;
• int/integer: 对应 xsd:int ;
• float/double: 对应 xsd:float ;
• bool/boolean: 对应 xsd:boolean ;
• date: 对应 xsd:date ;
• time: 对应 xsd:time ;
• datetime: 对应 xsd:dateTime ;
• array: 对应 xsd:string ;
• object: 对应 xsd:struct ;
• mixed: 对应 xsd:anyType .

不过我也确实没有过多的细看，没仔细看它对于AUTH验证支持怎么样（第三点里介绍的工具是有验证的，而且就设在config.php里，非常方便） 好了，我就针对现在的soap server的建立，介绍了四种方法，事实上，我到现在为止是一种都没有用过，nusoap也就用过客户端，那也是几年前的事情了，soapClient 也是，在构建soapHeader的时候也走过很多弯路。第三步介绍的工具，我也只是下载了看看源码，第四步我是看了看手册。只是先集中一下，以后总会用 到而已。 虽然说，PHPRPC和hprose 在andot他们介绍来说，开发速度和处理上，都有较为明显的提高，但如果想做一个公用的web service，那还是用大家都能接受的方法吧。 如果是自己的项目，那可能就会用phprpc或者hprose来了。hprose测试版用过，感觉还是不错的。phprpc，我也做了一个sae平台的移 植版，目前也能够正常的使用。。在这里也有个简单的测试：http://nsblog.sinaapp.com/。有兴趣的朋友也可以去看看的。