SOAP,英文是“肥皂”的意思。但就是这个玩意在很大程度上影响了互联网世界,前几年疯炒“Web服务”概念之后,SOAP就是其成就或者说“遗产”,因为 SOAP 就是迎来实现 Web 服务的。 SOAP = Simple Object Access Protocol,简单对象访问协议。它是一种轻量的、简单的、基于 addFunction($function_name); 其中,$soap是一个SoapServer对象,$function_name是需要被调用的函数名。 SoapServer对象的handle方法用来处理用户输入并调用相应的函数,最后返回给客户端处理的结果。语法格式如下: $soap->handle([$soap_request]); 其中,$soap是一个SoapServer对象,$soap_request是一个可选参数,用来表示用户的请求信息。如果不指定$soap_request,则表示服务器将接收用户的全部请求。 2、SoapCliet 用于调用远程服务器上的SoapServer页面,并实现了对相应函数的调用。创建一个SoapClient对象的语法格式如下: $soap = new SoapClient($wsdl,$array); 其中,参数$wsdl和$array与SoapServer相同。 创建SoapClient对象后,调用服务端页面中的函数相当于调用了SoapClient的方法,创建语法如下: $soap->user_function($params); 其中,$soap是一个SoapClient对象,user_function是服务器端要调用的函数,$params 是要传入函数的参数。 3、SoapFault SoapFault用于生成soap访问过程中可能出现的错误。创建一个soapFault对象的语法格式如下: $fault = new SoapFault($faultcode,$faultstring); 其中,$faultcode是用户定义的错误代码,$faultstring是用户自定义的错误信息。soapFault 对象会在服务器端页面出现错误时自动生成,或者通过用户自行创建SoapFault对象时生成。对于 Soap访问时出现的错误,客户端可通过捕捉SoapFalut对象来获得相应的错误信息。 在客户端捕获SoapFault对象后,可以通过下面的代码获得错误代码和错误信息: $fault->faultcode;//错误代码 $fault->faultstring;//错误信息 其中,$fault是在前面创建的SoapFault对象。 示例: 文件 soapfunc.php: 文件 soapclsoapserverient.php 内容: "httr://test-rui")); $soap->addFunction('reverse'); $soap->addFunction('add2numbers'); $soap->addFunction('gettime'); $soap->addFunction(SOAP_FUNCTIONS_ALL); $soap->handle(); ?> 文件 soapclient.php 内容: "http://localhost:8080/_myPHP5/soap/soapserver.php", 'uri'=>"http://test-uri")); $str="This string will be reversed"; $reversed = $client->reverse($str); echo "if you reverse '$str', you will get '$reversed'"; $n1 = 20; $n2 = 33; $sum = $client->add2numbers($n1,$n2); echo ""; echo "if you try $n1 + $n2, you will get $sum"; echo ""; echo "The remoye system time is: ".$client->gettime(); } catch(SoapFault $fault) { echo "Fault! code:" . $fault->faultcode . " string:" . $fault->faultstring; } ?>

PHP 中还实现了通过 WSDL 对 Web 服务的发布。

WSDL 是一种用于描述Web服务的语法规范,针对每个Web服务来说,它是一个说明文档,对web服务的位置,协议和接口进行详细的说明.由web服务的开发者提供。

WSDL文件包括5部分:types, Message,PortType,Binding和Service五部分.

1 Types定义: 类型定义,独立于语言.对应于SOAP消息中要传输的元素信息的定义2 Message: 每个web方法对应两个message定义in和out.而message的定义包含了头和体3 PortType: 每个web service对应一个PortType,该PortType中又包含了对其发布的方法, operation(操作)4 Bindings: 指定每porttype中每个操作(类以及方法)的绑定信息,包含input和output的消息的格式.5 Service: 每个web service绑定的port信息

Web 服务除过按照前述的示例形式发布外,还可以通过 WSDL 文档来发布。

示例:

要发布的类,文件 myservice.php:

$server=new SoapServer('TestSoap.wsdl',array('soap_version' => SOAP_1_2));$server->setClass("service");$server->handle();?>

WSDL 描述文档,文件 TestSoap.wsdl:

调用代码,文件 Client.php:

$client = new SoapClient("http://localhost:8080/_myPHP5/soap/Wsdl/TestSoap.wsdl");echo $client->HelloWorld();echo("");echo $client->Add(10, 20);?>

然而,WSDL 文档的编写是一件很麻烦的事情,无聊又容易出错。很多人认为那玩意儿不是人写的,但是,如果有好的软件工具,那玩意儿又是不需要人写的。Zend 公司的 ZED 5.0 系列和 Zend Studio for eclipse 6.0 原来是很好支持 WDSL 的可视化编辑和类的发布的(按照一个类文件智能生成),但 Zend studio 7.0 之后,这方面功能有所减弱。但基于 Eclipse 构建的 Zend studio 7.x,还是有一个 WSDL 的可视化编辑器,功能也还够用,生成的 WSDL 文件与以前有细微的变化。需要程序员必须对 WSDL 文档里的标签和元素很熟悉。

附录:关于 PHP 开发 Soap 的一些错误

1、开发的时候一定要关闭 php soap 的缓存,服务器和客户端都需要,不然会报:

Fatal error: Uncaught SoapFault exception: [Client] Function (”test”) is not a valid method for this service in ……\clien.php:5 Stack trace:#0 [internal function]: SoapClient->__call(’test’, Array)#1 D:\xampp\htdocs\clien.php(5): SoapClient->test()#2 {main}

关闭方法:ini_set("soap.wsdl_cache_enabled", "0");

可以通过类似 $client->__getFunctions() 等方法查看 Soap 的一些信息。

2、如果调试时报告不识别

作者:张庆(网眼) 西安 PHP 教育培训中心 2010-7-11来自“网眼视界”:http://blog.why100000.com作者微博:http://t.qq.com/zhangking“十万个为什么”电脑学习网:http://www.why100000.com

以上就介绍了PHP 中使用 SOAP,包括了方面的内容,希望对PHP教程有兴趣的朋友有所帮助。

09-04 19:08