• 技术文章 >后端开发 >php教程

    PHP通过SOAP实现WebService

    *文*文2017-12-29 19:03:52原创1267
    本文主要介绍了PHP使用SOAP扩展实现WebService的方法,结合实例形式较为详细的分析了SOAP扩展的原理及实现WebService的相关技巧。需要的朋友可以参考下,希望对大家有所帮助。

    具体如下:

    最近在一个PHP项目中对接外部接口涉及到WebService,搜索引擎上相关文章不是很多,找到的大都是引用一个号称很强大的开源软件NuSOAP,即一些类。文章写描述的环境是PHP 4.3。先拿来试试,运行出错,原来NuSOAP提供的soapclient类与PHP 5中新增了内置的SOAP扩展的SoapClient类冲突了。

    虽然NuSOAP号称可以用于所有的PHP 环境,不受服务器安全设置的影响。但需要引用一大堆类文件,还是觉得用PHP 5中新增了内置的SOAP扩展好一些,能实现实用就好。先了解一下SOAP:

    一、SOAP和XML-PRC比较

    在Web服务发展的初期,XML格式化消息的第一个主要用途是,应用于XML-RPC协议,其中RPC代表远程过程调用。在XML远程过程调用(XML-RPC)中,客户端发送一条特定消息,该消息中必须包括名称、运行服务的程序以及输入参数。

    XML-RPC只能使用有限的数据类型种类和一些简单的数据结构。人们认为这个协议还不够强大,于是就出现了SOAP——其最初的定义是简单对象访问协议。之后,大家逐渐意识到SOAP其实并不简单,而且也不需要必须使用面向对象语言,所以,现在人们只是沿用SOAP这个名称而已。

    XML-RPC只有简单的数据类型集,取而代之,SOAP是通过利用XML Schema的不断发展来定义数据类型的。同时,SOAP也能够利用XML 命名空间,这是XML-RPC所不需要的。如此一来,SOAP消息的开头部分就可以是任何类型的XML命名空间声明,其代价是在系统之间增加了更多的复杂性和不兼容性。

    随着计算机行业的觉醒,人们发现了基于XML的Web服务的商业潜力,于是,各家公司开始不断地发掘想法、观点、论据以及标准化尝试。W3C曾经设法以“Web服务活动”的名义来组织成果展,其中也包括实际做出SOAP的XML协议工作组(XML Protocol Working Group)。与Web服务有关的标准化成果(从某种程度上说与SOAP相关或者依赖于SOAP)的数量已经倍增了到了令人惊讶的程度。

    最初,SOAP是作为XML-RPC的扩展而发展起来的,它主要强调的是,通过从WSDL文件中所获得的方法和变量名来进行远程过程调用。现在,通过不断进步,人们发现了更多的使用SOAP的方式,而不仅仅是采用“文件”方式——基本上是使用一个SOAP信封来传送XML格式化文件。无论如何,要掌握SOAP,了解WSDL所扮演的角色是最根本的。

    二、SOAP数据包结构解析

    SOAP的消息被称为一个SOAP Envelope,包括SOAP Header和SOAP Body。其中,SOAP Header可以方便的插入各种其它消息来扩充Web Service的功能,比如Security(采用证书访问Web Service),SOAP Body则是具体的消息正文,也就是Marshall后的信息。

    SOAP调用的时候,也就是向一个URL(比如 http://api.google.com/search/beta2 )发送HTTP Post报文(根据SOAP规范,HTTP Get报文也可被支持),调用方法的名字在HTTP Request Header SOAP-Action中给出,接下来就是SOAP Envelope了。服务端接到请求,执行计算,将返回结果Marshall成XML,用HTTP返回给客户端。

    三、SOAP简单示例

    SOAP开发一般有三种方式选择:

    1)、PEAR自带的SOAP扩展;
    2)、PHP自带的SOAP扩展;
    3)、NuSOAP(纯PHP) 。

    PHP 5中新增了内置的SOAP扩展,作为PHP的一部分提供的,因此不需要下载、安装和管理单独的包。这是第一个用C而不是PHP为PHP编写的SOAP实现,因此作者声称它的速度要快得多。相关文档包含在PHP手册的Function Reference部分(php_soap.dll)。

    一个访问.NET WEB服务的客户端例子:

    < ? php
    $objSoapClient = new SoapClient("http://www.webservicemart.com/uszip.asmx?WSDL");
    $param = array("ZipCode"=>'12209'); 
    $out = $objSoapClient->ValidateZip($param);
    $data = $out->ValidateZipResult;
    echo $data;
    ?>

    四、实例

    1)、用PHP建立SOAP服务

    建立soap_server.php(虚拟路径为:http://localhost/php/soap/soap_server.php)

    < ? php
    /**
    * A simple math utility class
    */
    class math{
      /**
      * Add two integers together
      *
      * @param integer $a The first integer of the addition
      * @param integer $b The second integer of the addition
      * @return integer The sum of the provided integers
      */
      public function add($a, $b){
        return $a + $b;
      }
      /**
      * Subtract two integers from each other
      *
      * @param integer $a The first integer of the subtraction
      * @param integer $b The second integer of the subtraction
      * @return integer The difference of the provided integers
      */
      public function sub($a, $b){
        return $a - $b;
      }
      /**
      * p two integers from each other
      *
      * @param integer $a The first integer of the subtraction
      * @param integer $b The second integer of the subtraction
      * @return double The difference of the provided integers
      */
      public function p($a, $b){
        if($b == 0){
          throw new SoapFault(-1, "Cannot pide by zero!");
        }
        return $a / $b;
      }
    }
    $server = new SoapServer('math.wsdl', array('soap_version'=>SOAP_1_2));
    $server->setClass("math");
    $server->handle(); 
    ?>

    注:

    a)、math类是即将公开的webservice;
    b)、$server->setClass,不是$server->addClass。
    2)、用PHP客户端访问刚建立SOAP服务

    < ? php
    // $client = new SoapClient('http://localhost/php/soap/math.wsdl');
    $client = new SoapClient("http://localhost/php/soap/soap_server.php?WSDL");
    try{
      $result = $client->p(8, 2); // will cause a Soap Fault if pide by zero
      print "The answer is: $result";
    }catch(SoapFault $e){
      print "Sorry an error was caught executing your request: {$e->getMessage()}";
    }
    ?>

    本质上,http://localhost/php/soap/soap_server.php?WSDL就是要访问到注释行所指的wsdl描述文件,所以这个WSDL文件必须事先生成。而对于其他语言如Java则可以动态生成。对于PHP自带的SOAP扩展要求这个WSDL文件必须事先生成好。

    可以用ZendStudio生成静态的WSDL文件,此时用到math类的phpdoc作为生成WSDL的元数据。用ZendStudio生成wsdl文件时,必须正确说明Web服务目标地址,片断如下:

    ...
      <service name="mathService">
        <port binding="typens:mathBinding" name="mathPort">
          <soap:address location="http://localhost/php/soap/soap_server.php"></soap:address>
        </port>
      </service>
    ...

    注:调用PHP Webserver的方法必须传入命名参数。

    相关推荐:

    如何使用php websocket创建简单聊天室

    PHP Web实时消息后台服务器推送技术GoEasy

    详谈PHP WEB服务器相关知识_PHP教程

    以上就是PHP通过SOAP实现WebService的详细内容,更多请关注php中文网其它相关文章!

    声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn核实处理。
    专题推荐:WebService SOAP php
    上一篇:php中echo用逗号和用点号的区别详解 下一篇:自己动手写 PHP MVC 框架(40节精讲/巨细/新人进阶必看)

    相关文章推荐

    • 浅析PHP中的类自动加载相关文件• 系统讲解PHP缓存技术• 一文理解和实现现代PHP框架里的IOC容器• 深入了解PHP:用gdb调试源码• 实例介绍:使用Docker快速搭建多版本PHP开发环境
    1/1

    PHP中文网