PHP 中使用 SOAP(2)

PHP 中还实现了通过 WSDL 对 Web 服务的发布。

    WSDL 是一种用于描述Web服务的语法规范，针对每个Web服务来说，它是一个说明文档，对web服务的位置,协议和接口进行详细的说明.由web服务的开发者提供。

    WSDL文件包括5部分:types, Message,PortType,Binding和Service五部分.

    1 Types定义: 类型定义,独立于语言.对应于SOAP消息中要传输的元素信息的定义
    2 Message: 每个web方法对应两个message定义in和out.而message的定义包含了头和体
    3 PortType: 每个web service对应一个PortType,该PortType中又包含了对其发布的方法, operation（操作）
    4 Bindings: 指定每porttype中每个操作(类以及方法)的绑定信息,包含input和output的消息的格式.
    5 Service: 每个web service绑定的port信息

    Web 服务除过按照前述的示例形式发布外，还可以通过 WSDL 文档来发布。

    示例：

    要发布的类，文件 myservice.php：
    <?php
      class service
      {
        public function HelloWorld()
        {
          return "Hello";
        }
        public function Add($a,$b)
        {
          return $a+$b;
        }
      }

      $server=new SoapServer('TestSoap.wsdl',array('soap_version' => SOAP_1_2));
      $server->setClass("service");
      $server->handle();
    ?>

    WSDL 描述文档，文件 TestSoap.wsdl：

    <?xml version='1.0' encoding='UTF-8'?>
    <definitions name="TestSoap"
      targetNamespace="urn:TestSoap"
      xmlns:typens="urn:TestSoap"
      xmlns:xsd="http://www.w3.org/2001/XMLSchema"
      xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
      xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
      xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
      xmlns="http://schemas.xmlsoap.org/wsdl/">

      <message name="Add">
        <part name="a"/>
        <part name="b"/>
      </message>

      <message name="AddResponse">
        <part name="AddReturn"/>
      </message>

      <message name="HelloWorld"/>
      <message name="HelloWorldResponse">

        <part name="HelloWorldReturn"/>
      </message>

      <message name="Sub">
        <part name="a"/>
      </message>

      <message name="SubResponse">
        <part name="SubReturn"/>
      </message>

      <portType name="servicePortType">
        <operation name="Add">
          <input message="typens:Add"/>
          <output message="typens:AddResponse"/>
        </operation>
        <operation name="HelloWorld">
          <input message="typens:HelloWorld"/>
          <output message="typens:HelloWorldResponse"/>
        </operation>
        <operation name="Sub">
          <input message="typens:Sub"/>
          <output message="typens:SubResponse"/>
        </operation>
      </portType>

      <binding name="serviceBinding" type="typens:servicePortType">
        <soap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http"/>
        <operation name="Add">
          <soap:operation soapAction="urn:serviceAction"/>
          <input>
            <soap:body namespace="urn:TestSoap" use="literal"/>
          </input>
          <output>
            <soap:body namespace="urn:TestSoap" use="literal"/>
          </output>
        </operation>
        <operation name="HelloWorld">
          <soap:operation soapAction="urn:serviceAction"/>
          <input>
            <soap:body namespace="urn:TestSoap" use="literal"/>
          </input>
          <output>
            <soap:body namespace="urn:TestSoap" use="literal"/>
          </output>
        </operation>
        <operation name="Sub">
          <soap:operation soapAction="urn:serviceAction"/>
          <input>
            <soap:body namespace="urn:TestSoap" use="literal"/>
          </input>
          <output>
            <soap:body namespace="urn:TestSoap" use="literal"/>
          </output>
        </operation>
      </binding>

      <service name="TestSoapService">
        <port name="servicePort" binding="typens:serviceBinding">
          <soap:address location="http://localhost:8080/_myPHP5/soap/Wsdl/myservice.php"/>
        </port>
      </service>

    </definitions>

    调用代码，文件 Client.php：

    <?php
      error_reporting(7);

      $client = new SoapClient("http://localhost:8080/_myPHP5/soap/Wsdl/TestSoap.wsdl");
      echo $client->HelloWorld();
      echo("<br>");
      echo $client->Add(10, 20);
    ?>

    然而，WSDL 文档的编写是一件很麻烦的事情，无聊又容易出错。很多人认为那玩意儿不是人写的，但是，如果有好的软件工具，那玩意儿又是不需要人写的。Zend 公司的 ZED 5.0 系列和 Zend Studio for eclipse 6.0 原来是很好支持 WDSL 的可视化编辑和类的发布的（按照一个类文件智能生成），但 Zend studio 7.0 之后，这方面功能有所减弱。但基于 Eclipse 构建的 Zend studio 7.x，还是有一个 WSDL 的可视化编辑器，功能也还够用，生成的 WSDL 文件与以前有细微的变化。需要程序员必须对 WSDL 文档里的标签和元素很熟悉。

    附录：关于 PHP 开发 Soap 的一些错误

    1、开发的时候一定要关闭 php soap 的缓存，服务器和客户端都需要，不然会报:

    Fatal error: Uncaught SoapFault exception: [Client] Function (”test”) is not a valid method for this service in ……\clien.php:5 Stack trace:
    #0 [internal function]: SoapClient->__call(’test’, Array)
    #1 D:\xampp\htdocs\clien.php(5): SoapClient->test()
    #2 {main}

    关闭方法：
    ini_set("soap.wsdl_cache_enabled", "0");

    可以通过类似 $client->__getFunctions() 等方法查看 Soap 的一些信息。


    2、如果调试时报告不识别xml错误，请确保代码里没有空格等无关信息，比如 Utf-8 编码文件的 BOM 头。

    作者：张庆(网眼) 西安 PHP 教育培训中心 2010-7-11
    来自“网眼视界”：http://blog.why100000.com
    作者微博：http://t.qq.com/zhangking
    “十万个为什么”电脑学习网：http://www.why100000.com