>php教程 >php手册 >PHP使用SOAP做webservice

PHP使用SOAP做webservice

WBOY
WBOY원래의
2016-06-06 19:59:19917검색

PHP SOAP扩展 简介 PHP的SOAP扩展可以用来提供和使用Web services。换句话说,PHP开发者可以利用这个PHP扩展来写他们自己的Web services,也可以写一些客户端来使用给定的Web services。 PHP5中的这个SOAP扩展目的是为了实现PHP对Web services的支持。与其它

PHP SOAP扩展


简介

PHP的SOAP扩展可以用来提供和使用Web services。换句话说,PHP开发者可以利用这个PHP扩展来写他们自己的Web services,也可以写一些客户端来使用给定的Web services。

PHP5中的这个SOAP扩展目的是为了实现PHP对Web services的支持。与其它实现PHP对Web services的支持的方法不同,SOAP扩展是用C写的,因此它比其它方法具有速度优势。

SOAP扩展支持以下规范。

* SOAP 1.1
* SOAP 1.2
* WSDL 1.1

SOAP扩展主要用来处理RPC形式的Web services。不过,你也可以使用文本形式的WSDL文件配合WSDL模式的服务端和客户端。

这个扩展使用 GNOME XML库来处理XML。

扩展中的类

这个扩展实现了6个类。其中有三个高级的类,它们的方法很有用,它们是 SoapClient,SoapServer和SoapFault。另外三个类除了构造器外没有其它别的方法,这三个是低级的类,它们是SoapHeader,SoapParam和SoapVar。

PHP使用SOAP做webservice

SoapClient类

这个类用来使用Web services。SoapClient类可以作为给定Web services的客户端。
它有两种操作形式:

* WSDL 模式
* Non-WSDL 模式

在WSDL模式中,构造器可以使用WSDL文件名作为参数,并从WSDL中提取服务所使用的信息。

non-WSDL模式中使用参数来传递要使用的信息。这个类有许多可以用来使用服务的有用的方法。其中SoapClient::__soapCall()是最重要的。这个方法可以用来调用服务中的某个操作。

SoapServer类

这个类可以用来提供Web services。与SoapClient类似,SoapServer也有两种操作模式:WSDL模式和non-WSDL模式。这两种模式的意义跟 SoapClient的两种模式一样。在WSDL模式中,服务实现了WSDL提供的接口;在non-WSDL模式中,参数被用来管理服务的行为。

在SoapServer类的众多方法中,有三个方法比较重要。它们是SoapServer::setClass(),SoapServer::addFunction()和SoapServer::handle()。

SoapServer::setClass()方法设定用来实现Web Service的类。SoapServer::setClass所设定的类中的所有公共方法将成为Web Services的操作(operation)。

SoapServer::addFunction()方法用来添加一个或多个作为Web Services操作(operation)的函数。

SoapServer:: handle()方法指示Web Service脚本开始处理进入的请求。Web Service脚本是用PHP脚本写的一个或多个SoapServer对象的实例。尽管你可以有不止一个的SoapServer对象,但通常的习惯是一个脚本只拥有一个SoapServer实例。在调用SoapServer::handle()方法之前,Web Service脚本会使用设置在SoapServer对象实例上的任何信息来处理进入的请求和输出的相应。

SoapFault类

这个类从Exception类继承而来,可以用来处理错误。SoapFault实例可以抛出或获取Soap错误的相关信息并按程序员的请求处理。

SoapHeader类

这个类可以用来描述SOAP headers。它只是一个只包含构造器方法的数据容器。

SoapParam类

SoapParam也是一个只包含构造器方法的数据容器。这个方法可以用来描述传递给Web services操作的参数。在non-WSDL模式中这是一个很有用的类,可以用来传递所期望格式的参数信息。

SoapVar类

SoapVar也是一个只包含构造器的低级类,与SoapHeader和SoapParam类相似。这个类可以用来给一个Web services操作传递编码参数。这个类对non-WSDL中传递类型信息是非常有用的。

WSDL VS. non-WSDL模式

Web Services有两种实现模式:契约先行(Contract first)模式和代码先行(Code first)模式。

契约先行模式使用了一个用XML定义的服务接口的WSDL文件。WSDL文件定义了服务必须实现或客户端必须使用的接口。SoapServer和SoapClient的WSDL模式就基于这个概念。

在代码先行模式中,首先要先写出实现服务的代码。然后在大多数情况下,代码会产生一个契约,换种说法,一个WSDL。接着客户端在使用服务的时候就可以使用那个WSDL来获得服务的接口。尽管如此,PHP5的扩展并没有从代码输出一个WSDL的规定,考虑到这种情况,可以在non-WSDL模式下使用 SoapServer和SoapClient。

SOAP扩展与Hello World

这一节介绍如何使用WSDL模式和non-WSDL模式来实现服务和客户端。相对而言,使用WSDL模式来实现服务和客户端会比较容易,假定已经有一个定义了接口的WSDL文件。因此这一节会先介绍如何使用WSDL模式实现一个Web Service。

在这个Hello World例子的服务中有一个被命名为greet的操作。这个操作有一个字符串形式的名字并返回一个字符串形式的greeting。所用到的WSDL如下:

PLAIN TEXT

XML:

  1. :definitions  

  2.     xmlns:impl='http://wso2.org/wsf/php/helloService'

  3.     xmlns:intf='http://wso2.org/wsf/php/helloService'

  4.     xmlns:wsdl='http://schemas.xmlsoap.org/wsdl/'

  5.     xmlns:wsdlsoap='http://schemas.xmlsoap.org/wsdl/soap/'

  6.     xmlns:xsd='http://www.w3.org/2001/XMLSchema'

  7.     targetNamespace='http://wso2.org/wsf/php/helloService'>

  8.   :types>

  9.     elementFormDefault='qualified'

  10.         xmlns:impl='http://wso2.org/wsf/php/helloService'

  11.         xmlns:intf='http://wso2.org/wsf/php/helloService'

  12.         xmlns:wsdl='http://schemas.xmlsoap.org/wsdl/'

  13.         xmlns="http://www.w3.org/2001/XMLSchema"

  14.         targetNamespace='http://wso2.org/wsf/php/helloService'>

  15.       name='greet'>

  16.         >

  17.           >

  18.             name='name' type='xsd:string' />

  19.           >

  20.         >

  21.       >

  22.       name='greetResponse'>

  23.         >

  24.           >

  25.             name='greetReturn' type='xsd:string' />

  26.           >

  27.         >

  28.       >

  29.     >

  30.   :types>

  31.   :message name='greetRequest'>

  32.     :part name='parameters' element='impl:greet' />

  33.   :message>

  34.   :message name='greetResponse'>

  35.     :part name='parameters' element='impl:greetResponse' />

  36.   :message>

  37.   :portType name='helloService'>

  38.     :operation name='greet'>

  39.       :input name='greetRequest' message='impl:greetRequest' />

  40.       :output name='greetResponse' message='impl:greetResponse' />

  41.     :operation>

  42.   :portType>

  43.   :binding name='helloServiceSoapBinding' type='impl:helloService'>

  44.     :binding transport='http://schemas.xmlsoap.org/soap/http' style='document' />

  45.     :operation name='greet'>

  46.       :operation soapAction='helloService#greet' />

  47.       :input name='greetRequest'>

  48.         :body use='literal' />

  49.       :input>

  50.       :output name='greetResponse'>

  51.         :body use='literal' />

  52.       :output>

  53.     :operation>

  54.   :binding>

  55.   :service name='helloService'>

  56.     :port binding='impl:helloServiceSoapBinding' name='helloService'>

  57.       :address location='http://localhost/hello/hello_service_wsdl.php' />

  58.     :port>

  59.   :service>

  60. :definitions>

 

WSDL模式服务

下面是WSDL模式的服务所使用的SOAP扩展API代码:

PLAIN TEXT

PHP:

  1. function greet($param) {

  2.     $retval = 'Hello '.$param->name;

  3.     $result = array('greetReturn' => $retval);

  4.     return $result;

  5. }

  6.  

  7. $server = new SoapServer('hello.wsdl');

  8. $server->addFunction('greet');

  9. $server->handle();

  10. ?>

 

在这个服务的实现过程中,函数实现了WSDL所定义的服务操作greet,greet操作有一个WSDL指定的参数,按照greet操作的语义,这个参数是一个用户的名字。最后handle调用了触发处理请求的服务对象。

WSDL模式客户端

客户端代码如下

PLAIN TEXT

PHP:

  1.  

  2. try {

  3.     $client = new SoapClient('hello.wsdl');

  4.     $result$client->__soapCall('greet', array(array('name' => 'Sam')));

  5.     printf("Result = %s/n", $result->greetReturn);

  6.  

  7. } catch (Exception $e) {

  8.     printf("Message = %s/n",$e->__toString());

  9. }

  10. ?>

 

客户端代码中,首先创建一个使用WSDL文件作参数的SoapClient实例。接着__soapCall()调用作为参数传入它的操作,也就是greet和传入操作的参数。

请求和响应

当你将上述的PHP脚本放在你web服务器目录下的文档中,并利用WEB浏览器或在PHP解析器的命令行调用脚本,客户端发送一个SOAP请求到服务端脚本,服务端将向客户端发送一个SOAP响应来响应客户端的请求。

下面是客户端所发送的SOAP请求:

PLAIN TEXT

XML:

  1. ?xml version="1.0" encoding="UTF-8"?> 

  2. -ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"                   

  3.                                   xmlns:ns1="http://wso2.org/wsf/php/helloService">

  4.  

  5.     -ENV:Body>

  6.         :greet>

  7.             :name>Sam:name>

  8.         :greet>

  9.     -ENV:Body>

  10. -ENV:Envelope>

下面是服务端响应上诉请求而发送的SOAP响应:

PLAIN TEXT

XML:

  1. ?xml version="1.0" encoding="UTF-8"?>

  2.    -ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"

  3.                       xmlns:ns1="http://wso2.org/wsf/php/helloService">

  4.       -ENV:Body>

  5.          :greetResponse>

  6.             :greetReturn>Hello Sam:greetReturn>

  7.          :greetResponse>

  8.       -ENV:Body>

  9.    -ENV:Envelope>

上面的SOAP消息都是利用WSDL模式的服务端和客户端来获取的。也可以利用non-WSDL模式的服务端和客户端来产生与上面相同的SOAP消息。但是,PHP代码必须有一点改变。下一节会说明如何使用non-WSDL模式。

non-WSDL模式服务端

PLAIN TEXT

PHP:

  1. function greet($param) {

  2.     $retval = 'Hello '.$param;

  3.     return new SoapParam($retval, 'greetReturn');

  4. }

  5. $server = new SoapServer(null, array('uri' => 'http://wso2.org/wsf/php/helloService'));

  6. $server->addFunction('greet');

  7. $server->handle();

  8. ?>

 

在non -WSDL模式中,想WSDL模式一样首先实现greet函数的功能,但是函数实现的方式跟WSDL模式稍稍有所不同。在non-WSDL模式中,我们必须返回一个SoapParam对象作为响应,而不是一个数组。创建服务时,第一个参数设为null,说明没有提供WSDL;接着传递一个选项作为参数,这个选项参数是服务的URI。最后像WSDL模式一样调用剩下的方法。

non-WSDL模式客户端

PLAIN TEXT

PHP:

  1. try {   

  2.     $client = new SoapClient(null,

  3.     array('location' => 'http://localhost/hello/hello_service_nonwsdl.php',

  4.     'uri' => 'http://wso2.org/wsf/php/helloService'));

  5.     $result = $client->__soapCall('greet', array(new SoapParam('Sam', 'name'))); printf("Result = %s/n", $result);

  6. } catch (Exception $e) {

  7.     printf("Message = %s/n",$e->__toString());

  8. }

  9. ?>

 

在non-WShDL模式中,因为p没有使用WSDL,传递了一个包含服务所在位置和服务URI的参数数组作为参数。然后象WSDL模式中一样调用__soapCall()方法,但是使用了SoapParam类用指定格式打包参数。返回的结果将获取greet中的响应。

结论

这篇文章介绍了SOAP扩展,可以在PHP中通过它来提供和使用Web Services。PHP扩展的强项是它的简单和快速。使用C写的SOAP扩展来运行服务端和客户端是非常简单的。虽然SOAP扩展在处理一些简单的 Web Services时很有用,但是当用它来处理所有的Web Services时就表现出它的局限性。 WSO WSF/PHP就是为了弥补PHP扩展的缺陷而开发的,它是开源的,可以实现SOAP类似的功能并且支持MTOM,WS-Addressing,WS- Security和WS-RelaiableMessaging。WSO2 WSF/PHP 支持与SOAP扩展类似的API。我们正计划将API打包起来提供跟SOAP扩展一样的API,会用C来写。

성명:
본 글의 내용은 네티즌들의 자발적인 기여로 작성되었으며, 저작권은 원저작자에게 있습니다. 본 사이트는 이에 상응하는 법적 책임을 지지 않습니다. 표절이나 침해가 의심되는 콘텐츠를 발견한 경우 admin@php.cn으로 문의하세요.