- 用 composer 安装生成 WSDL 所需的库
1
| composer require piotrooo/wsdl-creator
|
- 实现用于外部访问的入口文件,代码示例请参考(其中方法名和参数中出现的
Notify
对应一个类名,该类的方法将成为可以通过 SOAP 调用的外部接口):1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22
| <?php use WSDL\DocumentLiteralWrapper; use WSDL\WSDLCreator; use WSDL\XML\Styles\DocumentLiteralWrapped; class Api { public static function soapNotify() { $host = $_SERVER['HTTP_HOST']; $soapuri = "http://{$host}/Api/soapNotify"; if (isset($_GET['wsdl'])) { $wsdl = new WSDLCreator('Notify', $soapuri); $wsdl->renderWSDL(); exit; } $server = new SoapServer(null, [ 'uri' => $soapuri ]); $server->setClass('Notify'); $server->handle(); } }
|
- 实现包含接口功能逻辑的类文件,代码示例请参考(其中方法的注释相当重要,是 wsdl-creator 正确生成 WSDL 的依据,必须严格按照格式进行注释):
<?php
class Notify
{
/**
* @desc sendText 向患者的微信发送文本信息
* @param string $toUser 发给哪个用户
* @param string $content 发送的内容
* @return string $result
*/
public function sendText($toUser, $content)
{
if (!$toUser || !$content) {
return E::INVALID;
}
$user = G::xpdo()->row("SELECT * FROM `users` WHERE `patientid` = ?", [$toUser]);
if (!$user) {
return E::NODATA;
}
$api = G::xpdo()->row("SELECT * FROM `api` WHERE `token` = ?", [$user['token']]);
$weixin = new Weixin($api['appid'], $api['appsecret']);
$weixin->sendText($user['openid'], $content);
return 0;
}
}
4. 使用 SoapUI 软件对接口进行调试
5. 编制相应的接口调用说明文档
###### 参考资料:
* 了解 SOAP 的基本文档结构请参考 [http://www.sitepoint.com/series/creating-web-services-with-php-and-soap/]](http://www.sitepoint.com/series/creating-web-services-with-php-and-soap/])
* 关于生成 WSDL 的库 wsdl-creator 详见: [https://github.com/piotrooo/wsdl-creator](https://github.com/piotrooo/wsdl-creator)