soapclient

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

       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('C445FFDB6DE7093E58E0D60F 9249B54DBEE2719EAD036262 BCAABD5C234155B98229C4F8 283B643FF2A454B22CED20F1 C53C75F6C578EC30F597F656 B125997CF0121F184989D32C FA1D40E74ECA4FBE93212FF5 FC839625EE459294FF052A9F BC1F1961DBA8FAB6DBFB6E3C 1A53FFBEA91B0C95E370588C 44C9B1A5786A49D6BC67D798 94A65664');       //调用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，终于成功了！