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: /* 几个供client端调用的函数 */ function reverse($str) { $retval=''; if(strlen($str)<1) { return new SoapFault('Client','','Invalid string'); } for($i=1; $i<=strlen($str); $i++) { $retval .= $str[(strlen($str)-$i)]; } return $retval; } function add2numbers($num1, $num2) { if(trim($num1) != intval($num1)) { return new SoapFault('Client','','The first number is invalid'); } if(trim($num2) != intval($num2)) { return new SoapFault('Client','','The second number is invalid'); } return ($num1+$num2); } function gettime() { $time = date('Y-m-d H:i:s',time()); return $time; } ?> 文件 soapclsoapserverient.php 内容: //先创建一个SoapServer对象实例,然后将我们要暴露的函数注册, //最后的handle()用来处理接受的soap请求 include_once('soapfunc.php'); error_reporting(7); //正式发布时,设为 0 date_default_timezone_set('PRC'); //设置时区 $soap = new SoapServer(null, array('uri'=>"httr://test-rui")); $soap->addFunction('reverse'); $soap->addFunction('add2numbers'); $soap->addFunction('gettime'); $soap->addFunction(SOAP_FUNCTIONS_ALL); $soap->handle(); ?> 文件 soapclient.php 内容: error_reporting(7); try { $client = new SoapClient(null, array('location'=>"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教程有兴趣的朋友有所帮助。