PHP SOAP扩展

Sun, 21 Dec 2008 01:19:00 GMT

PHP的SOAP扩展可以用来提供和��?em>Web services。换句话��_��PHP开发者可以利用这个PHP扩展来写他们自己的Web services�Q�也可以写一些客��L��来��用给定的Web services�?br />
PHP5中的�q�个SOAP扩展目的是�ؓ了实现PHP�?em>Web services的支持。与其它实现PHP对Web services的支持的�Ҏ��不同�Q�SOAP扩展是用C写的�Q�因此它比其它方法具有速度优势�?br />
SOAP扩展支持以下规范�?br />
* SOAP 1.1
* SOAP 1.2
* WSDL 1.1

SOAP扩展主要用来处理RPC形式�?em>Web services。不�q�，你也可以使用文本形式的WSDL文�g配合WSDL模式的服务端和客��L��?br />
�q�个扩展使用 GNOME XML库来处理XML�?br />
扩展中的�c?br /> �q�个扩展实现�?个类。其中有三个高��的类�Q�它们的�Ҏ��很有用，它们�?SoapClient�Q�SoapServer和SoapFault。另外三个类除了构造器外没有其它别的方法，�q�三个是低��的类�Q�它们是SoapHeader�Q�SoapParam和SoapVar�?br />

SoapClient�c?/strong>

�q�个�cȝ��来��?em>Web services。SoapClient�c�d��以作为给定Web services的客��L��?br /> 它有两种操作形式�Q?br />
* WSDL 模式
* Non-WSDL 模式

在WSDL模式中，构造器可以使用WSDL文�g名作为参敎ͼ��q�从WSDL中提取服务所使用的信息�?br />
non-WSDL模式中��用参数来传递要使用的信息。这个类有许多可以用来��用服务的有用的方法。其中SoapClient::__soapCall()是最重要的。这个方法可以用来调用服务中的某个操作�?br />
SoapServer�c?/strong>

�q�个�c�d��以用来提�?em>Web services�? 与SoapClient�c�M��Q�SoapServer也有两种操作模式�Q�WSDL模式和non-WSDL模式。这两种模式的意义跟 SoapClient的两�U�模式一栗��在WSDL模式中，服务实现了WSDL提供的接口；在non-WSDL模式中，参数被用来管理服务的行�ؓ�?br />
在SoapServer�cȝ��众多�Ҏ��中，有三个方法比较重要。它们是SoapServer::setClass()�Q�SoapServer::addFunction()和SoapServer::handle()�?br />
SoapServer::setClass()�Ҏ��讑֮�用来实现Web Service的类。SoapServer::setClass所讑֮�的类中的所有公共方法将成�ؓWeb Services的操�?operation)�?br />
SoapServer::addFunction()�Ҏ��用来��d��一个或多个作�ؓWeb Services操作(operation)的函数�?br />
SoapServer:: handle()�Ҏ��指示Web Service脚本开始处理进入的��h��。Web Service脚本是用PHP脚本写的一个或多个SoapServer对象的实例。尽��你可以有不止一个的SoapServer对象�Q�但通常的习惯是一�? 脚本只拥有一个SoapServer实例。在调用SoapServer::handle()�Ҏ��之前�Q�Web Service脚本会��用设�|�在SoapServer对象实例上的��M��信息来处理进入的��h��和输出的相应�?/p>

SoapFault�c?/strong>

�q�个�c�M��Exception�cȝ��承而来�Q�可以用来处理错误。SoapFault实例可以抛出或获取Soap错误的相关信息�ƈ按程序员的请求处理�?br />
SoapHeader�c?/strong>

�q�个�c�d��以用来描�q�SOAP headers。它只是一个只包含构造器�Ҏ��的数据容器�?br />
SoapParam�c?/strong>

SoapParam也是一个只包含构造器�Ҏ��的数据容器。这个方法可以用来描�q�C��递给Web services操作的参数。在non-WSDL模式中这是一个很有用的类�Q�可以用来传递所期望格式的参��C��息�?br />
SoapVar�c?/strong>

SoapVar也是一个只包含构造器的低�U�类�Q�与SoapHeader和SoapParam�cȝ��伹{��这个类可以用来�l�一�?em>Web services操作传递编码参数。这个类对non-WSDL中传递类型信息是非常有用的�?/p>

WSDL VS. non-WSDL模式

Web Services有两�U�实现模式：契约先行(Contract first)模式和代码先�?Code first)模式�?br />
契约先行模式使用了一个用XML定义的服务接口的WSDL文�g。WSDL文�g定义了服务必��d��现或客户端必��M��用的接口。SoapServer和SoapClient的WSDL模式��基于这个概��c�?br />
�? 代码先行模式中，首先要先写出实现服务的代码。然后在大多数情况下�Q�代码会产生一个契�U�，换种说法�Q�一个WSDL。接着客户端在使用服务的时候就可以使用那个WSDL来获得服务的接口。尽��如此，PHP5的扩展�ƈ没有从代码输��Z��个WSDL的规定，考虑到这�U�情况，可以在non-WSDL模式下��? SoapServer和SoapClient�?br /> SOAP扩展与Hello World

�q�一节介�l�如何��用WSDL模式和non-WSDL模式来实现服务和客户端。相对而言�Q��用WSDL模式来实现服务和客户端会比较�Ҏ��Q�假定已�l�有一个定义了接口的WSDL文�g。因此这一节会先介�l�如何��用WSDL模式实现一�?em>Web Service�?br />
在这个Hello World例子的服务中有一个被命名为greet的操作。这个操作有一个字�W�串形式的名字�ƈ�q�回一个字�W�串形式的greeting。所用到的WSDL如下�Q?/p>

    xmlns:impl='http://wso2.org/wsf/php/helloService'
    xmlns:intf='http://wso2.org/wsf/php/helloService'
    xmlns:wsdl='http://schemas.xmlsoap.org/wsdl/'
    xmlns:wsdlsoap='http://schemas.xmlsoap.org/wsdl/soap/'
    xmlns:xsd='http://www.w3.org/2001/XMLSchema'
    targetNamespace='http://wso2.org/wsf/php/helloService'>

            xmlns:impl='http://wso2.org/wsf/php/helloService'
        xmlns:intf='http://wso2.org/wsf/php/helloService'
        xmlns:wsdl='http://schemas.xmlsoap.org/wsdl/'
        xmlns="http://www.w3.org/2001/XMLSchema"
        targetNamespace='http://wso2.org/wsf/php/helloService' >

























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

      soap:operation soapAction='helloService#greet' />

        soap:body use='literal' />


        soap:body use='literal' />



service name='helloService'>

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

service>

WSDL模式服务

下面是WSDL模式的服务所使用的SOAP扩展API代码�Q?/p>
php
function greet($param) {
    $retval = 'Hello '.$param->name;
    $result = array('greetReturn' => $retval);
    return $result;
}

$server = new SoapServer('hello.wsdl');
$server->addFunction('greet');
$server->handle();
?>

在这个服务的实现�q�程中，函数实现了WSDL所定义的服务操作greet�Q�greet操作有一个WSDL指定的参敎ͼ�按照greet操作的语义，�q�个参数是一个用��L��名字。最后handle调用了触发处理请求的服务对象�?/p>

WSDL模式客户�?/strong>

客户端代码如�?/p>
php
try {
    $client = new SoapClient('hello.wsdl');
    $result = $client->__soapCall('greet', array(array('name' => 'Sam')));
    printf("Result = %s", $result->greetReturn);
} catch (Exception $e) {
    printf("Message = %s",$e->__toString());
}
?>

客户端代码中�Q�首先创��Z��个��用WSDL文�g作参数的SoapClient实例。接着__soapCall()调用作�ؓ参数传入它的操作�Q�也��是greet和传入操作的参数�?br /> ��h��和响�?br />
当你��上�q�的PHP脚本攑֜�你web服务器目录下的文档中�Q��ƈ利用WEB��览器或在PHP解析器的命��o行调用脚本，客户端发送一个SOAP��h��到服务端脚本�Q�服务端��向客户端发送一个SOAP响应来响应客��L��的请求�?br />
下面是客��L��所发送的SOAP��h��Q?/p>

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


    Sam



下面是服务端响应上诉��h��而发送的SOAP响应�Q?/p>

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


            Hello Sam




上面的SOAP消息都是利用WSDL模式的服务端和客��L��来获取的。也可以利用non-WSDL模式的服务端和客��L��来��生与上面相同的SOAP消息。但是，PHP代码必须有一�Ҏ��变。下一节会说明如何使用non-WSDL模式�?br />
non-WSDL模式服务�?/strong>

php
function greet($param) {
    $retval = 'Hello '.$param;
    return new SoapParam($retval, 'greetReturn');
}

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

$server->addFunction('greet');
$server->handle();
?>

在non -WSDL模式中，想WSDL模式一样首先实现greet函数的功能，但是函数实现的方式跟WSDL模式�E�稍有所不同。在non-WSDL模式中，我们�? ��返回一个SoapParam对象作�ؓ响应�Q�而不是一个数�l�。创建服务时�Q�第一个参数设为null�Q�说明没有提供WSDL�Q�接着传递一个选项作�ؓ参数�Q�这个选项参数是服务的URI。最后像WSDL模式一栯��用剩下的�Ҏ��?br />
non-WSDL模式客户�?/strong>

php
try {
    $client = new SoapClient(null,
    array('location' => 'http://localhost/hello/hello_service_nonwsdl.php',
    'uri' => 'http://wso2.org/wsf/php/helloService'));
    $result = $client->__soapCall('greet', array(new SoapParam('Sam', 'name')));    printf("Result = %s", $result);
} catch (Exception $e) {
    printf("Message = %s",$e->__toString());
}
?>

在non-WSDL模式中，因�ؓ没有使用WSDL�Q�传递了一个包含服务所在位�|�和服务URI的参数数�l�作为参数。然后象WSDL模式中一栯��用__soapCall()�Ҏ��Q�但是��用了SoapParam�cȝ��指定格式打包参数。返回的�l�果��获取greet中的响应�?/p>
相关文章:

PHP代码的优与劣

如何用PHP和mysql创徏一个ShoutBox

PHP的文件包�?/a>

PHP的正则表辑ּ�处理函数�ȝ��分析

PHP文�g上传实例详解

�l�论
�q�篇文章介绍了SOAP扩展�Q�可以在PHP中通过它来提供和��?em>Web Services。PHP扩展的强��Ҏ��它的��单和快速。��用C写的SOAP扩展来运行服务端和客��L��是非常简单的。虽然SOAP扩展在处理一些简单的 Web Services时很有用�Q�但是当用它来处理所有的Web Services时就表现出它的局限性�?WSO WSF/PHP��是��Z��弥补PHP扩展的缺陯��开发的�Q�它是开源的�Q�可以实现SOAP�c�M��的功能�ƈ且支持MTOM�Q�WS-Addressing�Q�WS- Security和WS-RelaiableMessaging。WSO2 WSF/PHP 支持与SOAP扩展�c�M��的API。我们正计划��API打包��h��提供跟SOAP扩展一��L��API�Q�会用C来写�?/p>

墙头�?/a> 2008-12-21 09:19 发表评论

偷自拍亚洲视频在线观看,国产精品亚洲精品观看不卡,亚洲变态另类一区二区三区

PHP SOAP扩展