PHP调用WEBSERVICE接口常见问题答疑以及总结

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

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

调用时可能出现的问题：

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

说明没有安装php-SOAP服务。在linux下使用

yum search soap | grep php
如果是Ubuntu系统，可以使用apt-get命令查找soap并安装。

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

2：无法传递参数，webservice收到的参数均为null。

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

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

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

$params = array( new class )

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

<?php
// to see formated types

$soap = new SoapClient('http://domain.com/ws.php?WSDL');

echo '<pre>';
echo '<h2>Types:</h2>';
$types = $soap->__getTypes();
foreach ($types as $type) {
    $type = preg_replace(
        array('/(\w+) ([a-zA-Z0-9]+)/', '/\n /'),
        array('<font color="green">${1}</font> <font color="blue">${2}</font>', "\n\t"),
        $type
    );
    echo $type;
    echo "\n\n";
}
echo '</pre>';

此部分参考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对外提供的服务

<?php
Class PersonInfo
{
    /**
     *    返回姓名
     *    @return string
     *
     */
    public function getName(){
        return "My Name is Chance";
    }
}
?>

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

1 <?php
 2 //包含提供服务的类进来
 3 require_once('PersonInfo.php');
 4
 5 //wsdl方式提供web service,如果生成了wsdl文件则可直接传递到//SoapServer的构造函数中
 6 //$s = new SoapServer('PersonInfo.wsdl');
 7
 8 //doesn't work 只有location不能提供web service
 9 //output:looks like we got no XML document
10 //$s = new SoapServer(null,array("location"=>"http://localhost/Test/MyService/Server.php"));
11
12 //下面两种方式均可以工作，只要指定了相应的uri
13 //$s = new SoapServer(null,array("uri"=>"Server.php"));
14 $s = new SoapServer(null,array("location"=>"http://localhost/Test/MyService/Server.php","uri"=>"Server.php"));
15
16 $s -> setClass("PersonInfo");
17
18 $s -> handle();
19 ?>

下面是客户端代码：

 1 <?php
 2 try{
 3     //wsdl方式调用web service
 4     //wsdl方式中由于wsdl文件写定了，如果发生添加删除函数等操作改动，不会反应到wsdl，相对non-wsdl方式
 5     //来说不够灵活
 6     //$soap = new SoapClient("http://localhost/Test/MyService/PersonInfo.wsdl");
 7
 8     //non-wsdl方式调用web service
 9     //在non-wsdl方式中option location系必须提供的,而服务端的location是选择性的，可以不提供
10     $soap = new SoapClient(null,array('location'=>"http://localhost/Test/MyService/Server.php",'uri'=>'Server.php'));
11
12     //两种调用方式，直接调用方法，和用__soapCall简接调用
13     $result1 = $soap->getName();
14     $result2 = $soap->__soapCall("getName",array());
15     echo $result1."<br/>";
16     echo $result2;
17
18 }catch(SoapFault $e){
19     echo $e->getMessage();
20 }catch(Exception $e){
21     echo $e->getMessage();
22 }
23
24 ?>

http://www.yunxiu.org/blog/article/5534.htm