PHP的SOAP原理及实现

浅浅的花香味﹌ 2023-10-18 07:04 17阅读 0赞

**1. 简介：**

SOAP ： (全称Simple Object Access Protocol) 为交换数据的一种协议规范，该通信协议位于HTTP之上，以XML格式语言进行数据互换，使用场景：如果各项目之间使用不用的开发语言要进行数据互换，就需要一个互相都能通信的工具，WSDL，SOAP为此诞生

WSDL： WSDL 指网络服务描述语言 (Web Services Description Language)，WSDL 是一种使用 XML 编写的文档。这种文档可描述某个 Web service。它可规定服务的位置，以及此服务提供的操作（或方法）。

**2. 配置：**

PHP的SOAP扩展开启及配置

WIn环境

打开PHP.ini extension=php\_soap.dll去掉前面的分号

Linux环境

编译时加上 --enable-soap

####  ####

WSDL缓存类型 1为磁盘 2为内存

soap.wsdl\_cache = 1

缓存文件保存位置

soap.wsdl\_cache\_dir = /tmp

开启或关闭WSDL缓存功能，由于每次进行SOAP都会有下载对方XML文档的过程，也是其效率低下的原因

soap.wsdl\_cache\_enabled =1

缓存文件的最大数量

soap.wsdl\_cache\_limit

缓存文件生存时间

soap.wsdl\_cache\_ttl = 3600

**3. 应用实例：**

**a. 不使用wsdl的情况**

服务端：

1. `<?php`
2. `class testclass{`
3. 
4. `public function getName($name)`
5. `{`
6. `return "hello ".$name;`
7. `}`
8. `}`
9. 
10. 
11. `function getName($name)`
12. `{`
13. `return "hello ".$name;`
14. `}`
15. 
16. `$a = new SoapServer(null,array("uri"=>"index.php"));`
17. `$a->setClass("testclass"); //指定一个类中的所有方法`
18. `//$a->addFunction("test"); //指定单个方法`
19. `$a->handle(); //处理访问`

uri为必填项，客户端的uri必须和服务端的保持一致

客户端

1. `try{`
2. `$client = new SoapClient(null, array("location"=>"http://localhost/instance/index.php","uri"=>"index.php"));`
3. `//echo $client->getName("getName"); //调用方法`
4. `echo $client->__soapCall ("getName",array("name")); //调用方法`
5. 
6. `}catch(Exception $e){`
7. `print_r($e->getMessage(),true);`
8. `}`

location为SOAP服务端访问地址，uri与服务端保持一致

**b. 使用WSDL方法**

因使用wsdl之前需要手动生成xml文件，手写的话太过繁琐，可使用SoapDiscovery.class.php 开源类生成

[下载地址][Link 1]

1. `<?php`
2. `class testclass{`
3. 
4. `public function getName($name)`
5. `{`
6. `return "hello ".$name;`
7. `}`
8. `}`
9. 
10. `include_once "SoapDiscovery.class.php";`
11. 
12. `$discovery = new SoapDiscovery("testclass","testclass");`
13. `$filename = $discovery->getWSDL(); //生成XML文件`
14. `echo $filename;`

**服务端**

1. `$a = new SoapServer("testclass.wsdl");`
2. `$a->setClass("testclass"); //指定一个类中的所有方法`
3. `$a->handle(); //处理访问 `

**客户端**

1. `try{`
2. `$client = new SoapClient("http://localhost/instance/index.php?wsdl");`
3. `//echo $client->getName("getName");`
4. `//echo $client->__soapCall ("getName",array("name"));`
5. `print_r($client->__getFunctions()); //打印服务端所有提供的方法`

1. `}catch(Exception $e){`
2. `print_r($e->getMessage(),true);`
3. `}`

扩展类所提供的方法可参考PHP Manual

来源:[https://blog.csdn.net/marvinblog/article/details/14163557][https_blog.csdn.net_marvinblog_article_details_14163557]

[Link 1]: https://github.com/ZetaChow/NewSMSPlatForm/blob/cedfdd5f52757bab1a04a9c223e90a4160a4a5da/SoapDiscovery.class.php
[https_blog.csdn.net_marvinblog_article_details_14163557]: https://blog.csdn.net/marvinblog/article/details/14163557