PHP SOAP

一． 必备知识
1.wsdl(web服务标记语言)

      WSDL（网络服务描述语言，Web Services Description Language）是一门基于 XML 的语言，用于描述 Web Services 以及如何对它们进行访问。
      具体参考请访问下面网址
      http://www.w3school.com.cn/wsdl/index.asp
2.soap
      SOAP 是一种简单的基于 XML 的协议，它使应用程序通过 HTTP 来交换信息。
      具体参考请访问下面网址
      http://www.w3school.com.cn/soap/index.asp
3.php扩展
具体参考请访问下面网址
http://php.net/manual/en/book.soap.php
 
二． php soap开发模式
1. working in swdl mode(契约先行(Contract first)模式)
契约先行模式使用了一个用XML定义的服务接口的WSDL文件。WSDL文件定义了服务必须实现或客户端必须使用的接口。SoapServer和 SoapClient的WSDL模式就基于这个概念。也就是用soap通讯的时候必须先有一个定义过的服务接口，才能进行通讯。

2. working in non-swdl mode(代码先行(Code first)模式)
   在代码先行模式中，首先要先写出实现服务的代码。然后在大多数情况下，代码会产生一个契约，换种说法，一个WSDL。接着客户端在使用服务的时候就可以使 用那个WSDL来获得服务的接口。尽管如此，PHP5的扩展并没有从代码输出一个WSDL的规定，考虑到这种情况，可以在non-WSDL模式下使用 SoapServer和SoapClient。也就是说在soap通讯的时候并不需要一个预先定义过的服务接口，代码会自动的产生。
 
三．参考例子：
下面介绍如何使用WSDL模式和non-WSDL模式来实现服务和客户端。相对而言，使用WSDL模式来实现服务和客户端会比较容易。
 
1. noWSDL模式实现
 
服务端 server.php
<?php
class test
{
     
      function show()
      {
           return 'hello world!';
      }
}
#####################################################
$server = new SoapServer(null, array('uri' => "http://test-uri/"));
$server->setClass('test');
$server->handle();
?>
 
客户端 client.php
<?
$soap=new SoapClient(null, array(
'location' =>'http://soapserver_url/server.php',
                                                  'uri' => "http://test-uri/"));  
                                                                   
print_r($soap->__getFunctions());
echo $soap->show();
?>
 
2. WSDL模式实现
第一步：编写服务端类文件
class..php
<?php
class test
{
     
      function show()
      {
           return 'hello world!';
      }
}
?>
 
第二步：将类文件生成 wsdl文件server.wsdl。
     由于wsdl文件编写比较复杂，所以我们用第三方工具生成。我们以zend studio为例子演示：
 Tools ==> WSDL Generator ==> Configration name : test; WSDL file name: server
 ==>ＮＥＸＴ　==> 点击 + ==> 选择上面的创建的class.php ==> 这时候会看到一个 classes?? : URL Location的映射,保留 test类前面的勾，并将其url 设置为 SOAP Server的url：http://soapserver_url/server.php ==>点击Finish，ZDE就会创建一个非常漂亮的WSDL了?? 工作基本上完成了.
 
第三步：服务端编写:
<?php
require ' class..php ';  //引入类文件
 
$server = new SoapServer('server.wsdl');
$server->setClass('test');
$server->handle();
?>
 
第四步：客户端编写
$soap = new SoapClient('http:// soapserver_url/server.wsdl');
 
print_r($soap->__getFunctions());
echo $soap->show();
 
 
      以上两个例子只是一个简单的soap服务编写，已经可以满足大部分需要。如果需要更加高级的功能请参考其他方面的资料。
三． 出现的问题。
1.在方法中对属性的赋值在其他方法中不起作用。
      比如在客户端调用服务端某个方法对某个属性赋值。
在其他方法里就不能用。但在 __construct 方法中对属性的赋值是可以个在其他方法中使用的。
2. 提示 Client] looks like we got no XML document错误。
      服务器端文件在<?php ?> 标签前后都不要有任何数据包括空格，空行。
 
3. Warning: SoapClient::SoapClient(): I/O warning : failed to load external entity
原因如下：PHP程序作为 SOAP客户端 采用 WSDL 模式访问远端服务器的时候，PHP是通过调用 libcurl 实现的。至少在 PHP5.2.X 是这样的。如果采用 non-WSDL 模式，就不需要 libcurl。在solaris 没有缺省安装 libcurl，也许是我没有安装。除了 了ibcurl以外，至少还关联的库包括：
libidn,ibgcc,libiconv,libintl,openssl
最近参与的项目,希望大家互相讨论，共同进步