原创文章,作者:Damon付,如若转载,请注明出处:《PHP调用WEBSERVICE接口常见问题答疑以及总结http://www.tiangr.com/php-diao-yong-webservice-jie-kou-chang-jian-wen-ti-da-yi-yi-ji-zong-jie.html

最近的工作项目中,接触到了很多的政府 [微信开发项目][1]。对方的外包公司都是使用JAVA作为开发语言,然后通过WEBSERVICE进行接口返回数据到我的项目中。一般情况下,能在浏览器打开并显示数据的接口是直接可以使用 CURL或者file_get_contents进行接收的。但是WEBSERVICE是使用Soapservice。而我们知道,从php 5之后,php自身已经提供了通过 [SoapClient][2] 调用webservice的方法。使用方法很简单:

 
  1. $client = SoapClient('$wsdl'); //也可以使用SoapClient('$wsdl', 'UTF-8')设定特定的编码。
  2. $client->__soapCall($functionName, $params);

调用时可能出现的问题:

1:提示”Class ‘SoapClient’ not found”。

说明没有安装php-SOAP服务。在linux下使用
如果是Ubuntu系统,可以使用apt-get命令查找soap并安装。

 
  1. yum search soap | grep php

安装完成后,重启apache服务即可。

**2:无法传递参数,webservice收到的参数均为null。**

原因是webservice限制了提交的参数必须为键值对形式,传递参数时要用

 
  1. $params = array( 'key'=>'value', 'key2'=>'value2', 'key3'=>'value3' )

的方式。或者将参数声明为一个class,之后使用

 
  1. $params = array( new class )

进行传递。
这时候你肯定会困惑,这个'key'值用什么名称,这时候,你可以调用下面的脚本,查看下,所有接口函数的参数需要使用什么key值。

 
  1. // to see formated types
  2. $soap = new SoapClient('http://domain.com/ws.php?WSDL');
  3. echo '';
  4. echo 'Types:';
  5. $types = $soap->__getTypes();
  6. foreach ($types as $type) {
  7.     $type = preg_replace( array('/(\w+) ([a-zA-Z0-9]+)/', '/\n /'), array('${1} ${2}', "\n\t"), $type );
  8.     echo $type; echo "\n\n";
  9. }
  10. echo '';

此部分参考http://www.php.net/manual/zh/soapclient.soapcall.php的说明。

3:总结:php有两个扩展可以实现web service,一个是NuSoap,一个是php 官方的soap扩展,由于soap是官方的,所以我们这里以soap来实现web service.由于默认是没有打开soap扩展的,所以自己先看一下soap扩展有没有打开。在soap编写web service的过程中主要用到了SoapClient,SoapServer,SoapFault三个类。

SoapClient类
这个类用来使用Web services。SoapClient类可以作为给定Web services的客户端。它有两种操作形式:

* WSDL 模式
* Non-WSDL 模式

在WSDL模式中,构造器可以使用WSDL文件名作为参数,并从WSDL中提取服务所使用的信息。
non-WSDL模式中使用参数来传递要使用的信息。

SoapServer类
这个类可以用来提供Web services。与SoapClient类似,SoapServer也有两种操作模式:WSDL模式和non-WSDL模式。这两种模式的意义跟 SoapClient的两种模式一样。在WSDL模式中,服务实现了WSDL提供的接口;在non-WSDL模式中,参数被用来管理服务的行为。

在SoapServer类的众多方法中,有三个方法比较重要。它们是SoapServer::setClass(),SoapServer::addFunction()和SoapServer::handle()。

下面给出实例:
定义一个提供服务的php类,这个类所提供的函数就是web service对外提供的服务

下面给出服务器端的代码:

 
  1. <?php
  2. //下面两种方式均可以工作,只要指定了相应的uri
  3. //$s = new SoapServer(null,array("uri"=>"Server.php"));
  4. $s = new SoapServer(null,array("location"=>"http://localhost/Test/MyService/Server.php","uri"=>"Server.php"));
  5. $s -> setClass("PersonInfo");
  6. $s -> handle();
  7. ?>

下面是客户端代码:

 
  1. <?php
  2. try{
  3. //两种调用方式,直接调用方法,和用__soapCall简接调用
  4. $result1 = $soap->getName();
  5. $result2 = $soap->__soapCall("getName",array());
  6. echo $result1."";
  7. echo $result2;
  8. }catch(SoapFault $e){
  9.     echo $e->getMessage();
  10. }catch(Exception $e){
  11.     echo $e->getMessage();
  12. }
  13. ?>

参考链接: http://php.net/manual/zh/class.soapclient.php