终于解决了PHP调用SOAP过程中的种种问题。(转)

最近在做公司和第三方的一个合作项目，需要调用统一验证接口和统一支付接口。由于牵涉公司机密，所以我要单独写一层PHP的接口给第三方用。前面那个验证接口主要卡在了des加密的方式上，这个有时间再说。这篇主要说说在实现统一支付接口上的问题。
    统一支付顾名思义，是公司的扣费系统，其中提供许多支付方式和支付种类(比如支付宝之类的），然后还会让你选择提交的银行方式。这里的逻辑业务我以后再说，主要说说这里涉及的一个概念。由于在网上银行交费页面提交完数据后，页面不会自动进行跳转，所以底层的接口（我们这里是JAVA实现的）要自动监听返回状态。但是返回的必然是一个加密的串，称为TokenString。这个TokenString的解密算法显然只有公司内部的人才能够知道，所以对于给合作方提供的时候，我必然要写一个WEBSERVICE来提供JAVA程序异步调用来解密，然后前台程序也来通过这个程序获取返回状态，比如交费是否成功之类的。好了，前面是我要做这东西的起因。下面具体说我在开发过程中遇到的问题吧。相信如果你用php要开发这个业务的话，都会遇到这个问题的。

-----------------------------------分割线-----------------------------------------------

webservice的一种常用实现方式就是soap了。我们后端的JAVA也是用soap的原理实现的。那么我显然首先要上网上搜搜关于soap的文章。最早进入实现的是PHP写的nusoap类。这个nusoap.php文件是完全用PHP写法来实现的soap方法。优点是不用给php装动态模块，也不用重新编译PHP。我当时像找到了新大陆一样，一头就载进去了。
先构建一个soap_server.php的文件，主要就是负责把给TokenString解密的getMsgSoap函数。具体解密算法我肯定是封装在自己写的类里了。
<?php

define('IFENG_LOG_LEVEL_DEBUG', 8);
require('./include/nusoap.php');
include "./include/class.IFengSystem.php";
include "./include/class.IFengHttp.php";
include "./include/class.IFengPay.php";

//创建soap服务类
$server = new soap_server;
$server->register('getMsgSoap');

//$pay = new IFengPay();    //创建支付类
$pay = IFengPay::getInstance();    //单态创建一个类
//$token = $pay->des->decrypt('C445FFDB6DE7093E58E0D60F9249B54DBEE2719EAD036262BCAABD5C234155B98229C4F8283B643FF2A454B22CED20F1C53C75F6C578EC30F597F656B125997CF0121F184989D32CFA1D40E74ECA4FBE93212FF5FC839625EE459294FF052A9FBC1F1961DBA8FAB6DBFB6E3C1A53FFBEA91B0C95E370588C44C9B1A5786A49D6BC67D79894A65664');    //调用des解密算法

function getMsgSoap($token)
{
    global $pay;
    $token = $pay->des->decrypt($token);    //调用des解密算法
    return $token;
}
$HTTP_RAW_POST_DATA = isset($HTTP_RAW_POST_DATA) ? $HTTP_RAW_POST_DATA : '';
$server->service($HTTP_RAW_POST_DATA);
?>

然后再写一个soap_client.php，实际上就是调用soap_server.php上封装好的方法。
代码如下：
<?php
//引用numsoap包。
require('./include/nusoap.php');

//soap的服务端
$server_url = 'http://app.finance.ifeng.com/Sso/soap_server.php';

//创建一个实例
$client = new soapclient($server_url);
//调用的soap端的函数协议
$soap_method_name = 'getMsgSoap';
//TokenString是返回的加密串的参数名
$data = array('token' => $_GET['TokenString']);
$result = $client->call($soap_method_name, $data);
// Display the result
print_r($result);
?>

测试完了，我一测试，OK了。高兴，兴奋，原来这么简单。结果没过多久，我们技术部的同事yetao就找我来了，你这个WEBSERVICE我那边调用不了。
    其实我当时还没有害怕，看看怎么回事儿呗。结果yetao说我这个nusoap自动生成的wsdl和他JAVA,还有C#生成的wsdl不统一。也就是说我这个不是标准的。晕，不是吧。心里凉了半截。
    这里需要给大家说一下什么是WSDL，基本上这就是XML的一种标准变形，类似于SVG和XSL那种，又自己的命名规则。剩下的知识大家搜索一下吧。

没办法了。换别的方法吧。于是继续在网上寻觅着。突然有篇帖子说nusoap已经过时了，而且通用性不好，最好还是用PHP5中自带的soap函数。切，最后还是躲不过要安装动态模块的老路。结果就看看手册上的安装帮助呗。手册上的安装需求部分会提示This extension makes use of the » GNOME xml library. Download and install this library. You will need at least libxml-2.5.4. 于是我开始在网上找libxml的package，这个还挺好找了，用了和上次mcrypt一样的安装方法,详见http://blog.sina.com.cn/s/blog_582246d20100dej9.html

装完了libxml我说继续找soap的安装包吧，结果满互联网找竟然都没找到一个安装的文件，无论是php.net，还是pecl网站都没找到，也可能是我笨吧。问问合作方用的PHP是什么版本，发现和我的一样，我想同样的版本说不定直接把soap.so文件要过来就成了（这绝对是用多了windows系统人的弊病，别以为这是php_soap.dll那样的，因为只要是在windows环境下，dll文件就通用）但是在linux下可就不同了，果不其然，对方的系统是centos，和我这边的不同。这条路也断了。

问了问技术部同事sunli，他建议我只能重新编译php了，然后在编译是加上--enable-soap。于是我写个phpinfo()把Configure Command 对应的代码都拷贝下来，然后再加上我新要加上的这个模块。
代码如下：
'./configure' '--prefix=/usr/local/php5' '--with-libxml-dir=/usr/lib' '--with-zlib' '--with-gd=/usr/local/gdlibforphp/gd' '--with-zlib-dir=/usr' '--with-mysql=/data/mysql' '--enable-sockets' '--enable-mbstring' '--enable-soap' '--with-apxs2=/data/apache/bin/apxs' '--enable-safe-mode' '--enable-ftp' '--with-png-dir=/usr/local' '--with-freetype-dir=/usr' '--with-jpeg-dir=/usr/local/gdlibforphp/jpeg' '--with-sqlite=shared'

记住，编译之前要把那个生成的文件夹删除，从新用tar命令解压，然后执行这编译命令，再make && make install来安装。完毕后重启apache，再看phpinfo。发现soap包终于有了。看来有的时候想躲一些事情是躲不掉的。但是这样有一个问题，就是现在这个只是在测试机上编译安装。如果在产品机上安装，那肯定得找个浏览人数少的时候，所以未来这一两天，我看那天晚上方便，给产品机重新编译一下。

然后重新构造这两个soap文件，准确的说是三个，因为还要自己构造一个wsdl文件。
soap_server.php程序代码如下：
<?php

define('IFENG_LOG_LEVEL_DEBUG', 8);
include "./include/class.IFengSystem.php";
include "./include/class.IFengHttp.php";
include "./include/class.IFengPay.php";

class msg
{
    public function getMsgSoap($token = '')
    {
        $pay = IFengPay::getInstance();    //单态创建一个类
        $token = $pay->des->decrypt($token);    //调用des解密算法
        return $token;
    }
}
$server = new SoapServer('msg.wsdl', array('soap_version' => SOAP_1_2, 'encoding'=>'UTF-8'));  
$server->setClass("msg");  
$server->handle();  
?>

编码强制转化为了UTF-8，然后声明一个webservice类msg，这里也可以声明function的。

soap_client.php代码如下：
<?php
//$client = new SoapClient('http://app.finance.ifeng.com/Sso/msg.wsdl');   
$client = new SoapClient("http://app.finance.ifeng.com/Sso/soap_server.php?WSDL",array('cache_wsdl' => 0));
$TokenString = $_GET['TokenString'];
try {
    $result = $client->getMsgSoap($TokenString);  
} catch(SoapFault $e) {  
    print "Sorry an error was caught executing your request: {$e->getMessage()}";  
}

print_r($result);
?>
    其中第一行注释的就是wsdl的位置，因为nusoap是自动生成wsdl的，所以我们之前一直没有考虑这个东西。这个wsdl是可以通过zend自动生成的。当你写好一个soap_server.php的时候，在zend中执行“工具”->“WSDL生成器”，然后选定一个wsdl文件，这个文件不同于JAVA和C#中，需要我们事先建立好这个文件，然后选中这个文件后点击下一步，选择绑定的文件（也就是我们这个soap_server.php)，于是就会自动显示这个文件中的方法了。选中你想填入到wsdl中的方法，然后complete就可以了。生成的这个wsdl是标准的可以被JAVA中soap方法识别的。

最后就当我以为已经成功的时候，程序上又输出了一行错误。“Unable to parse URL”也就是$e->getMessage()这行生效了。我在百度上搜索数条误解后，开始求助google了。于是在一篇英文的文章中找到了解决方法，不得否认，还是老外牛啊。
该文链接:http://www.electrictoolbox.com/php-soapclient-unable-parse-url/

根据这篇文章，我把大家需要改动的部分罗列出来吧，方便看英文不方便的同学。
1、首先你要在生成的wsdl文件中找到<soap:address location=""/>，然后改为<soap:address location="http://app.finance.ifeng.com/Sso/soap_server.php"/>也就是换成你那个soap_server.php所在的位置。

2、修改php.ini,加入下面这几行，是控制WSDL的缓存的。

[soap] 
; Enables or disables WSDL caching feature. 
soap.wsdl_cache_enabled=1 
; Sets the directory name where SOAP extension will put cache files. soap.wsdl_cache_dir="/tmp" 
; (time to live) Sets the number of second while cached file will be used 
; instead of original one. 
soap.wsdl_cache_ttl=86400

3、最后就是网上关于Soap类调用的例子都是直接
$client = new SoapClient('http://host/path/file.php?wsdl');
但是后面还要加上一个参数的,改为下面这句。
$client = new SoapClient('http://host/path/file.php?wsdl', array('cache_wsdl' => 0));

这三步都修改完毕后，重启apache，再看你的页面，发现终于成功了！OH，终于成功了！

在最后的最后，yetao说他那边虽然能看见我这个方法了，但是一传参数还是会报错，由于时间紧，我们就改http的传送方式来解决这个问题了。不过这个问题的源头可能是这句话。在网上看到的。“特别注意：我发现调用php webserver的方法和调用.net web服务的方法不一样。 调用.net service方法必须传入命名参数；而调用php web服务方法，一定不能传入命名参数，只能按顺序传入，为什么？这一点尤其要注意 ”。有时间再研究吧，这个已经占用我很多时间了。