原文:php中soap应用
SOAP:简单对象访问协议
(SOAP:Simple Object Access Protocol)
简单对象访问协议(SOAP)是一种轻量的、简单的、基于 XML 的协议,它被设计成在 WEB 上交换结构化的和固化的信息。 SOAP 可以和现存的许多因特网协议和格式结合使用,包括超文本传输协议( HTTP),简单邮件传输协议(SMTP),多用途网际邮件扩充协议(MIME)。它还支持从消息系统到远程过程调用(RPC)等大量的应用程序。
下面已一个简单的例子介绍一下soap在php中的应用。
1、使用php提供soap接口给其他人
要使用php提供soap接口,我们唯一需要做的就是使用SoapServer类声明一个接口。
下面是示例代码:
php文件:SoapInterfaceProvider.php
<?php
/**
* 要提供给用户调用的接口
*
*/
function getSoapData() {
$data = '<?xml version="1.0" encoding="utf8" ?><data>hello world<data>';
return $data;
}
//第一个参数代表wsdl,第二个参数uri参数代表命名空间
$soap = new SoapServer(null, array('uri' => 'http://www.qqstore.net/soap/'));
//声明供用户调用的接口
$soap -> addFunction("getSoapData");
$soap -> handle();
?>
2、调用php中已经提供好的soap接口
要测试步骤1中提供的接口,只需要执行下面的测试代码。(只需要执行下面的代码,不需要事先启动或执行
SoapInterfaceProvider.php文件,调用下面的测试代码的时候,php会自动执行SoapInterfaceProvider.php文件。所以
这里的location参数非常重要,不能出错,必须是实际放置SoapInterfaceProvider.php的位置)
php文件:SoapClient.php
<?php
/*
创建Soap客户端,第一个参数代表wsdl,第二个参数中location代表定义SoapServer的php文件的位置,uri参数代表命名空间
测试中发现,这里的uri即使与SoapInterfaceProvide.php中定义的不一样也没有问题,可能与我只有这一个soap接口有关。
*/
$client = new SoapClient(null, array(
'location' => 'http://localhost/webcenter/soap/SoapInterfaceProvider.php',
'uri' => 'http://www.qqstore.net/soap/'));
//调用getSoapData接口
$data = $client -> getSoapData();
echo "获取到数据:" . $data;
?>
在浏览器中输入下面连接进行测试:http://localhost/soap/SoapClient.php (根据实际位置进行调整)
执行结果:
获取到数据:<?xml version="1.0" encoding="utf-8" ?><data>hello world<data>
3、代码优化
上面提供的soap接口的文件SoapInterfaceProvider.php中,只有一个方法,如果有很多方法需要提供的话,每次都调用addFunction方法就显得有点麻烦了。并且将所有实际的方法都写在SoapInterfaceProvider.php文件中也不太合适。
这里我们可以将所有实际要调用的方法提出来放到一个单独的php类中,并且使用setClass方法一次性声明所有的接口。
下面是示例代码:
php文件:SoapMethod.class.php
<?php
class SoapMethod {
/**
* 要提供给用户调用的接口
*
*/
function getSoapData() {
$data = '<?xml version="1.0" encoding="utf-8" ?><data>hello world<data>';
return $data;
}
/**
* 要提供给用户调用的接口1
*
*/
function getSoapData1() {
$data1 = '<?xml version="1.0" encoding="utf-8" ?><data>hello world<data>';
return $data1;
}
}
?>
php文件:SoapInterfaceProvider.php
<?php
//引入包含实际调用的方法的类
require_once './function.class.php';
//第一个参数代表wsdl,第二个参数uri参数代表命名空间
$soap = new SoapServer(null, array('uri' => 'http://www.qqstore.net/soap/'));
//声明供用户调用的接口
$soap -> setClass("SoapMethod");
$soap -> handle();
?>
我在进行测试时,一开始没有使用setClass方法,而是使用了addFunction方法,实际调用的方法也时放到了SoapMethod类中,和
上面的SoapMethod.class.php代码一样。结果调用addFunction方法时,出现如下错误:
Fatal error: Uncaught SoapFault exception: [HTTP] Not Found in C:/AppServ/www/webcenter/soap/SoapClient.php:4 Stack trace: #0 [internal function]: SoapClient->__doRequest('<?xml version="...', 'http://localhos...', 'http://www.qqst...', 1, 0) #1 [internal function]: SoapClient->__call('getSoapData', Array) #2 C:/AppServ/www/webcenter/soap/SoapClient.php(4): SoapClient->getSoapData() #3 {main} thrown in C:/AppServ/www/webcenter/soap/SoapClient.php on line 4
后发现是用于方法定义在了类中,SoapInterfaceProvider.php文件中无法找到。将SoapMethod.class.php中的类定义去掉,只保留定
义的方法就可以了。
如果创建SoapClient时传入的location参数有问题,也会出现上面的错误。