共计 3207 个字符,预计需要花费 9 分钟才能阅读完成。
一、基础概念
SOAP(Simple Object Access Protocol)简单对象访问协议是在分散或分布式的环境中交换信息的简单的协议,是一个基于 XML 的协议,它包括四个部分:SOAP 封装(envelop),封装定义 了一个描述消息中的内容是什么,是谁发送的,谁应当接受并处理它以及如何处理它们的框架;SOAP 编码规则(encoding rules),用于表示应用程序需要使用的数据类型的实例; SOAP RPC 表示(RPC representation),表示远程过程调用和应答的协定;SOAP 绑定(binding),使用底层协议交换信息。
WSDL(Web Service Description Language)就是描述 XML Web 服务的标准 XML 格式,WSDL 由 Ariba、Intel、IBM 和微软等开发商提出。它用一种和具体语言无关的抽象方式定义了给定 Web 服务收发 的有关操作和消息。就其定义来说,你还不能把 WSDL 当作一种对象接口定义语言,例如,CORBA 或 COM 等应用程序体系结构就会用到对象接口定义语言。WSDL 保持协议中立,但它确实内建了绑定 SOAP 的支持,从而同 SOAP 建立了不可分割的联系。所以,当我在这篇文章中讨论 WSDL 的时候,我会假定你 把 SOAP 作为了你的通讯协议。
SOAP 和 WSDL 虽然是 web service 的两大标准,但是两者并没有必然的联系,都可以独立使用。它们之间的关系就类似 HTTP 和 Html 之间的关系。前者是一种协议,后者是对一个 Web Server 的描述。
二、PHP5 下的配置
在 php 的的配置文件 php.ini 中,找到
extension=php_soap.dll
然后将前面的; 号去掉,然后重启 web 服务
三、查询 web service 方法与参数、数据类型
某省电信公司的入单接口为 http://***.******.com/services/AcceptedBusiness?wsdl
我们使用 SoapClient 的__geunctions()和__getTypes()方法查看该接口的方法,参数和数据类型
只有__getFunctions 中列出的接口才能被 soap 调用。
在根目录下创建代码 soap.php
<?php
header("content-type:text/html;charset=utf-8");
try {$client = new SoapClient("http://***.******.com/services/AcceptedBusiness?wsdl");
print_r($client->__getFunctions());
print_r($client->__getTypes());
} catch (SOAPFault $e) {print $e;}
?>
在浏览器运行:http://localhost/soap.php 后,返回结果如下
Array
([0] => ArrayOf_xsd_anyType introduceAcceptedBusiness(string $c3, string $c4, string $linkman, string $linknum, string $num, string $idcard, string $remark, string $address)
[1] => ArrayOf_xsd_anyType introduceAcceptedBusinessByAiZhuangWei(string $subname, string $linkphone, string $idcard, string $address, string $businesstype, string $marketcode, string $surveycode, string $commanager, string $commanagerphone, string $bendiwang, string $fenju, string $zhiju, string $remark)
[2] => string introduceAcceptedBusinessByStandardInterface(string $xmlStr)
[3] => string introduceAcceptedBusinessByCallOut(string $xmlStr)
[4] => string introduceAcceptedBusinessByYddj(string $xmlParam)
[5] => ArrayOf_xsd_anyType queryAcceptedBusinessByAiZhuangWei(string $surveycode, string $starttime, string $endtime)
[6] => string queryCallOutOrderByConfig(string $xmlParam)
)
Array
([0] => anyType ArrayOf_xsd_anyType[])
其中有个方法 introduceAcceptedBusinessByStandardInterface(string $xmlStr),将是开发文档中提到的要使用的接口,参数为 xml 字符串
另外有的接口中提到有 SoapHeader 认证,这就需要加入__setSoapHeaders 方法,具体可查看 http://php.net/manual/zh/soapclient.setsoapheaders.php
四、提交入单
这一步就是需要根据开发文档拼接 xml 字符串,然后作为 introduceAcceptedBusinessByStandardInterface 的参数传入
创建 acceptedbusiness.php,内容如下
<?php
header("content-type:text/html;charset=utf-8");
try {$client = new SoapClient('http://***.*******.com/services/AcceptedBusiness?wsdl');
$xml = "<?xml version='1.0'encoding='UTF-8' ?>
<PACKAGE>
<C3>** 电信 </C3>
<C4></C4>
<LINKMAN> 张三 </LINKMAN>
<LINKNUM>13412341234</LINKNUM>
<LINKADDRESS> 广东深圳 </LINKADDRESS>
<REMARK>iPhone 6</REMARK>
<CHANNEL></CHANNEL>
<GRIDCODE>1111111111111111111111111111111</GRIDCODE>
<AGENTCODE>2111</AGENTCODE>
<KEY>1111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111</KEY>
</PACKAGE>
";
$return = $client->introduceAcceptedBusinessByStandardInterface($xml);
print_r($return);
} catch (SOAPFault $e) {print_r('Exception:'.$e);
}
?>
在浏览器中执行后,返回
<?xml version="1.0" encoding="UTF-8"?>
<PACKAGE>
<STATUS>0</STATUS>
<REASON> 入单成功!</REASON>
<ORDERSEQ>2014100905523549742</ORDERSEQ>
</PACKAGE>