关于在PHP中如何调用Soap/WebService的描述,网络上有不少帖子。但是主要讲述了如何用PHP开发服务器端、客户端并加以关联,而很少触及在PHP中调用现成的WebService的情况。在本文中我们做一个简单的示范。
一、寻找WebService来源
WebService可以自己编写,但是也可以从网络上去寻找现成的。我用的是www.xmethods.net里的US Zip Validator。它的WSDL文件位置在:http://www.webservicemart.com/uszip.asmx?WSDL。 它的作用是根据输入的ZIP代码,返回该代码对应的美国地名,州名,经纬度等。
二、创建SoapClient
第二步就是创建SoapClient,并调用WebService中的方法,并获得返回值。PHP代码如下:
$objSoapClient = new SoapClient("http://www.webservicemart.com/uszip.asmx?WSDL");
$param=array("ZipCode"=>$zip);
$out=$objSoapClient->ValidateZip($param);
$data=$out->ValidateZipResult;
SoapClient的创建有好多方法,我们用的是最标准的(也是最简单的)WSDL方法。由于查询ZIP的方法肯定需要一个参数,所以我们必须创建一个数组,用“参数名=>取值”的方式进行赋值。
也许读者会对这个数组的创建有一定的兴趣。比如,我们怎么知道“参数名”应该是“ZipCode”而不是别的什么呢?为什么没有更多的参数了,而只有一个?OK,这个问题我们稍后解释。因为这牵涉到WSDL的解读。
创建好参数后,同样的,我们调用SoapClient的方法ValidateZip,并传递参数进去;对于返回的结果,我们用$data变量取出我们真正感兴趣的东西。同样的,这里也存在方法名称是如何确定的问题。我们也在稍后介绍。
如果你也使用PhpEd进行PHP的开发和调试,那么从下面的调试窗口截图中,你可以很清除的看到$data和$out之间的关系:
三、解析数据
上面得到的$data中的数据是标准的XML结构的数据。所以在PHP中,我们需要创建一个XML解析器来对这个数据进行分析。代码如下:
$ParsedData=array();
function startElement($parser, $name, $attribs) {
global $ParsedData;
echo "<<font color="#0000cc">$name</font>";
if (count($attribs)) {
foreach ($attribs as $k => $v){
$ParsedData[$k]=$v;
echo " <font color="#009900">$k</font>="<font color="#990000">$v</font>"";
}
}
echo ">";
}
function endElement($parser, $name) {
echo "</<font color="#0000cc">$name</font>>";
}
$xml_parser= xml_parser_create();
xml_parser_set_option($xml_parser, XML_OPTION_CASE_FOLDING, 1);
xml_set_element_handler($xml_parser, "startElement", "endElement");
echo "<pre>";
if (!xml_parse($xml_parser, $data)) {
die(sprintf("XML error: %s at line %d", xml_error_string(xml_get_error_code($xml_parser)),xml_get_current_line_number($xml_parser)));
}
echo "</pre>";
xml_parser_free($xml_parser);
这里的详细操作需要参考PHP函数手册中关于XML函数的那一章。这里不再赘述。一旦数据被解析成功,我们就可以进行进一步的处理。例如下面的代码就遍历该数组,然后输出:
foreach ($ParsedData as $k=>$v) { echo $k."=>".$v."<br />"; }
四、解读WSDL
上 面我们留下了两个疑问:如何知道一个WebService提供的方法,以及它的参数?所有的答案都在WSDL描述中。对于本文使用的WSDL来说,我们 从中截取一段来分析。由于我们是通过Soap进行调用,所以我对完整的WSDL进行了节选,只列出关于Soap调用的部分(反相显示的部分):
首先我们注意到<wsdl:message name=”ValidateZipSoapIn”>这一节,它指出了在Soap调用中,入口参数要参照ValidateZip,于是我们接着转到文件上面一点的地方,看ValidateZip方法的定义:
<s:element name="ValidateZip"> <s:complexType>
<s:sequence> <s:element minOccurs="0" maxOccurs="1" name="ZipCode" type="s:string"/> </s:sequence> </s:complexType> </s:element>
很明显,ValidateZip要求一个参数,名称为ZipCode,类型为string。
同 样,我们再看<wsdl:message name=”ValidateZipSoapOut”>这一节,它指出Soap调用的出口参数是ValidateZipResponse。而后者的 传出参数名称是ValidateZipResult。于是,我们就解释了前两节提出的问题: