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文档,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也支持各种其它的操作,例如鉴权,头设置等,这些功能如有需要,可以参阅官方文档。