手机浏览 RSS 2.0 订阅 膘叔的简单人生 , 腾讯云RDS购买 | 超便宜的Vultr , 注册 | 登陆
浏览模式: 标准 | 列表Tag:restful

关于SOAP的几篇文章

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,然而这个网址打开是白屏的,内容可以稍看这里:

PHP代码
  1. 2.4.1 创建支持 WSDL 的 WEB 服务  
  2. 为了实现 WEB 服务程序对 WSDL 的支持,需要使用 soap_server 的 configureWSDL 方法,并且在调用 soap_server 的 register 方法注册 WEB 服务程序时,需要提供更详细的参数。看下面的代码,代码的文件名是 “/nusoap/nusoap_server3.php”。  
  3.   
  4. <?php  
  5. require_once("lib/nusoap.php");  
  6.   
  7. function concatenate($str1,$str2) {  
  8.       if (is_string($str1) && is_string($str2))  
  9.           return $str1 . $str2;  
  10.       else  
  11.           return new soap_fault(' 客户端 ','','concatenate 函数的参数应该是两个字符串 ');  
  12. }  
  13.   
  14. $soap = new soap_server;  
  15. $soap->configureWSDL('concatenate'); // 初始化对 WSDL 的支持  
  16.   
  17. // 注册服务  
  18. $soap->register('concatenate',  
  19. array("str1"=>"xsd:string","str2"=>"xsd:string"), // 输入参数的定义  
  20. array("return"=>"xsd:string"// 返回参数的定义  
  21. );  
  22.   
  23. $HTTP_RAW_POST_DATA = isset($HTTP_RAW_POST_DATA) ? $HTTP_RAW_POST_DATA : '';  
  24. $soap->service($HTTP_RAW_POST_DATA);  
  25. ?>  
  26. 现在打开浏览器,访问刚才建立的文件,http://127.0.0.1/nusoap/nusoap_server3.php,结果如下:   
  27.   
  28. concatenate  
  29. View the WSDL for the service. Click on an operation name to view it's details.  
  30.   
  31. concatenate   
  32. 点击函数名称concatenate,可以看到对函数的描述。点击"WSDL",或者访问WEB服务文件,并在后面加上查询字符串"?wsdl"(http://127.0.0.1/nusoap/nusoap_server3.php?wsdl),可以得到WEB服务的WSDL内容。  
  33.   
  34. 2.4.2 通过 WSDL 调用 WEB 服务  
  35. 通过 WSDL 调用 WEB 服务,与不通过 WSDL 调用 WEB 服务,程序的结构大体相同。区别在于,通过 WSDL 调用 WEB 服务,初始化 soapclient 类时,传入两个参数到 soapclient 的构造函数,第一个参数是 WSDL 文件的地址,第二个参数指定是否使用 WSDL ,指定为 true 即可。看下面的代码,代码的文件名是 “ /nusoap/nusoap_client3.php ”  
  36.   
  37. <?php  
  38. require_once("lib/nusoap.php");  
  39.   
  40. $client = new soapclient('http://127.0.0.1/nusoap/nusoap_server3.php?wsdl',true);  
  41. $parameters=array(' 字符串 1',' 字符串 2');  
  42.   
  43. $str=$client->call('concatenate',$parameters);  
  44. if (!$err=$client->getError()) {  
  45.       echo " 程序返回 :",$str;  
  46. else {  
  47.       echo " 错误 :",$err;  
  48. }  
  49. ?>  
  50. 2.4.3 代理的使用  
  51. NuSOAP 提供代理的方法调用远程 WEB 服务。这种方法,在客户端程序里面创建一个远程服务的代理对象,通过代理直接调用远程的 WEB 服务,而不需要通过 soalclient 类的 call 方法。看下面的代码。  
  52.   
  53. <?php  
  54. require_once("lib/nusoap.php");  
  55.   
  56. $client = new soapclient('http://127.0.0.1/nusoap/nusoap_server3.php?wsdl',true);  
  57. $proxy=$client -> getProxy(); // 创建代理对象 (soap_proxy 类 )  
  58.   
  59. $str=$proxy->concatenate(" 参数 1"," 参数 2"); // 直接调用 WEB 服务  
  60. if (!$err=$proxy->getError()) {   
  61.       echo " 程序返回 :",$str;  
  62. else {  
  63.       echo " 错误 :",$err;  
  64. }  
  65. ?>  

 

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

PHP代码
  1. <?php  
  2. $server = new SoapServer("some.wsdl");  
  3. $server = new SoapServer("some.wsdl"array('soap_version' => SOAP_1_2));  
  4. $server = new SoapServer("some.wsdl"array('actor' => "http://example.org/ts-tests/C"));  
  5. $server = new SoapServer("some.wsdl"array('encoding'=>'ISO-8859-1'));  
  6. $server = new SoapServer(null, array('uri' => "http://test-uri/"));  
  7.   
  8. class MyBook {  
  9.     public $title;  
  10.     public $author;  
  11. }  
  12.   
  13. $server = new SoapServer("books.wsdl"array('classmap' => array('book' => "MyBook")));  
  14. ?>   

 

反正,我是觉得很痛苦,不过所幸现在的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/。有兴趣的朋友也可以去看看的。

Tags: soap, webservice, phprpc, hprose, restful