SOAP：简单对象访问协议

SOAP：简单对象访问协议

　　（SOAP：Simple Object Access Protocol）

　　简单对象访问协议（SOAP）是一种轻量的、简单的、基于 XML 的协议，它被设计成在 WEB 上交换结构化的和固化的信息。 SOAP 可以和现存的许多因特网协议和格式结合使用，包括超文本传输协议（ HTTP），简单邮件传输协议（SMTP），多用途网际邮件扩充协议（MIME）。它还支持从消息系统到远程过程调用（RPC）等大量的应用程序。

　　SOAP 包括三个部分：

　　SOAP 封装：它定义了一个框架 , 该框架描述了消息中的内容是什么，谁应当处理它以及它是可选的还是必须的。

　　SOAP 编码规则：它定义了一种序列化的机制，用于交换应用程序所定义的数据类型的实例。

　　SOAP RPC 表示：它定义了用于表示远程过程调用和应答的协定。

　　SOAP 消息基本上是从发送端到接收端的单向传输，但它们常常结合起来执行类似于请求 / 应答的模式。所有的 SOAP 消息都使用 XML 编码。一条 SOAP 消息就是一个包含有一个必需的 SOAP 的封装包，一个可选的 SOAP 标头和一个必需的 SOAP 体块的 XML 文档。

　　把 SOAP 绑定到 HTTP 提供了同时利用 SOAP 的样式和分散的灵活性的特点以及 HTTP 的丰富的特征库的优点。在 HTTP 上传送 SOAP 并不是说 SOAP 会覆盖现有的 HTTP 语义，而是 HTTP 上的 SOAP 语义会自然的映射到 HTTP 语义。在使用 HTTP 作为协议绑定的场合中， RPC 请求映射到 HTTP 请求上，而 RPC 应答映射到 HTTP 应答。然而，在 RPC 上使用 SOAP 并不仅限于 HTTP 协议绑定。

　　SOAP也可以绑定到TCP和UDP协议上。

　　协议结构

　　SOAP 消息格式：

　　SOAP 标头

　　<SOAP-ENV: Envelope

　　Attributes>

　　<SOAP-ENV:Body

　　Attributes>

　　</SOAP-ENV:Body>

　　</SOAP-ENV:Envelope>目前主要在web服务中运用。

　　SOAPAction WEB编码中常见，协议开始起始意思，常见于编码启始句。

[ 编辑本段]

语法规则

　　这里是一些重要的语法规则：

　　SOAP 消息必须用 XML 来编码

　　SOAP 消息必须使用 SOAP Envelope 命名空间

　　SOAP 消息不能包含 DTD 引用

　　SOAP 消息不能包含 XML 处理指令

[ 编辑本段]

SOAP 消息的基本结构

　　<?xml version="1.0"?>

　　<soap:Envelope

　　xmlns:soap="http://www.w3.org/2001/12/soap-envelope"

　　soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding">

　　<soap:Header>

　　...

　　...

　　</soap:Header>

　　<soap:Body>

　　...

　　...

　　<soap:Fault>

　　...

　　...

　　</soap:Fault>

　　</soap:Body>

　　</soap:Envelope>

[ 编辑本段]

PHP SOAP实例

　　php提供了一个专门用于soap操作的扩展库，使用该扩展库后

　　可以直接在php中进行soap操作。下面将介绍soap的基本操作。

　　一、soap扩展的使用方法

　　php的soap扩展库通过soap协议实现了客服端与服务器端的

　　数据交互操作。从php5.0后，php就自带了soap的支持。使用

　　soap扩展库首先需要修改php安装目录下的配置文件php.ini

　　来激活soap扩展库。

　　在php.ini文件中找到如下所示的一行代码，去掉前面的注释(;)。

　　;extension=php_soap.dll

　　修改后，重启web服务器即可激活soap扩展。在soap扩展库中，主要

　　包括三种对象。

　　1、SoapServer

　　SoapServer用于创建php服务器端页面时定义可被调用的函数及返回

　　响应数据。创建一个SoapServer对象的语法格式如下:

　　$soap = new SoapServer($wsdl,$array);

　　其中，$wsdl为shoap使用得wsdl文件，wsdl是描述Web Service的一种

　　标准格式，若将$wsdl设置为null，则表示不使用wsdl模式。$array是

　　SoapServer的属性信息，是一个数组。

　　SoapServer对象的addFunction方法是用来声明哪个函数可以被客户端调用，

　　语法格式如下：

　　$soap->addFunction($function_name);

　　其中，$soap是一个SoapServer对象，$function_name是需要被调用的函数名。

　　SoapServer对象的handle方法用来处理用户输入并调用相应的函数，最后返回

　　给客户端处理的结果。语法格式如下:

　　$soap->handle([$soap_request]);

　　其中，$soap是一个SoapServer对象,$soap_request是一个可选参数，用来表示

　　用户的请求信息。如果不指定$soap_request，则表示服务器将接收用户的全部

　　请求。

　　2、SoapCliet

　　SoapClient用于调用远程服务器上的SoapServer页面，并实现了对相应函数的调用

　　。创建一个SoapClient对象的语法格式如下:

　　$soap = new SoapClient($wsdl,$array);

　　其中，参数$wsdl和$array与SoapServer相同。

　　创建SoapClient对象后，调用服务端页面中的函数相当于调用了SoapClient的方法，

　　创建语法如下:

　　$soap->user_function($params);

　　其中，$soap是一个SoapClient对象，user_function是服务器端要调用的函数，$params

　　是要传入函数的参数。

　　3、SoapFault

　　SoapFault用于生成soap访问过程中可能出现的错误。创建一个soapFault对象的语法格式

　　如下：

　　$fault = new SoapFault($faultcode,$faultstring);

　　其中，$faultcode是用户定义的错误代码，$faultstring是用户自定义的错误信息。soapFault

　　对象会在服务器端页面出现错误时自动生成，或者通过用户自行创建SoapFault对象时生成。对于

　　Soap访问时出现的错误，客户端可通过捕捉SoapFalut对象来获得相应的错误信息。

　　在客户端捕获SoapFault对象后，可以通过下面的代码获得错误代码和错误信息。

　　$fault->faultcode;//错误代码

　　$fault->faultstring;//错误信息

　　其中，$fault是在前面创建的SoapFault对象。