详解php soap实现web service接口服务

web service是什么,不多说,可参见百科说明web service百度百科
soap是一种协议,属于web service实现所使用的一种技术规范。
web service的接口实现有两种方式,一种是需要生成wsdl文档的方式,一种是不需要生成wsdl文档的方式。
在实际操作之前,先检查一下自己的环境,是否支持soap,然后修改一下php.ini配置文件,将“soap.wsdl_cache_enabled”项设置为0。

无需生成wsdl文档的方式

这种方式相较于需要生成wsdl文档的方式,更简单一些,但是有一些方法并不支持,例如获取操作方法的__getFunctions(),是否合用看自己的选择。

server端ts1.php

<?php
class testA{
        public function sayHi($str){
                return 'hi,'.$str;
        }

        public function add($a,$b){
                return $a+$b;
        }
}

$ss = new SoapServer(null, array('uri'=>'sampleA'));
$ss->setClass('testA');
$ss->handle();

在server端ts1.php文件中,创建了一个类,然后创建SoapServer并做设置,uri用来确保一致性。

client端tc1.php

<?php
$client = new SoapClient(null, array(
        'location'=>'http://10.0.0.232:1075/soap/ts1.php',
        'uri'=>'sampleA'
        ));

echo $client->sayHi('Taylor,Swift');
echo "<br/>";
echo $client->add(1,2);

在client端,使用SoapClient对象来进行请求,location指明请求的具体地址,uri的值与server端设置的一致,用来保证一致性。
在浏览器输入http://10.0.0.232:1075/soap/tc1.php来进行访问,可以看到输出如下图所示:
无wsdl文档方式

这种方式无需生成wsdl文档,实现简便,但同样的,因为没有wsdl文档,client也无法获取到相关的操作方法,而生成wsdl文档的方式,client端就可以单独根据一个请求地址来获取到server端公开的所有接口。

生成wsdl文档的方式

wsdl文档是一个xml文档,通常可以使用公开的类库SoapDiscovery来生成,我用百度网盘共享一下需要可以直接下载SoapDiscovery.class.php

server端ts2.php

<?php
define('WSDL_FILE','ts2.wsdl');
if(!file_exists(WSDL_FILE)){
        require_once('SoapDiscovery.class.php');
        $sd = new SoapDiscovery('testD', 'liang');
        $str = $sd->getWSDL();
        file_put_contents(WSDL_FILE, $str);
}

$ss = new SoapServer(WSDL_FILE);
$ss->setClass('testD');
$ss->handle();

class testD{
        public function sayHello($world){
                return 'hello,'.$world;
        }

        public function add($a, $b){
                return $a+$b;
        }
}

server端的ts2.php先检测了一下需要的wsdl文件是否存在,若不存在则创建,然后创建SoapServer对象并进行设置,因为使用的是wsdl文档,所以new SoapServer时直接写入wsdl文档的地址即可。

client端tc2.php

<?php
$client = new SoapClient('http://10.0.0.232:1075/soap/ts2.wsdl');

print_r($client->__getFunctions());

echo "<br/>";

echo $client->sayHello('Avril Lavigne');

echo "<br/>";

echo $client->add(9,8);

在client端的tc2.php文件中,创建SoapClient对象时,直接填入的是请求的wsdl文档的地址,这个文档是由ts2.php生成的。
现在,server端的ts2.php与client端的tc2.php都已经写好了,那么现在就需要请求一下ts2.php了,为什么请求它?因为我们需要先通过ts2.php来创建wsdl文件,当然,只有在第一次的时候需要这样做,当wsdl文档创建好之后,就不需要再这样做了。(如果后期修改了ts2.php,那还是需要删除掉旧的wsdl文档,然后重新请求一下ts2.php用来生成新的wsdl文档。)

1、请求ts2.php用来生成wsdl文档http://10.0.0.232:1075/soap/ts2.php

2、请求tc2.php查看返回结果:
这里写图片描述

3、通过浏览器,直接访问wsdl文档的地址,可以看到wsdl文档的具体内容:
这里写图片描述

php soap也支持各种其它的操作,例如鉴权,头设置等,这些功能如有需要,可以参阅官方文档。

猜你喜欢

转载自blog.csdn.net/ljl890705/article/details/79142383