基于图灵api实现微信聊天机器人

尝试了一下最近很火的聊天机器人，记录下实现过程。
微信公众平台提供的接口很简单，先看看消息交互流程:

说的通俗一些，用户使用微信发送消息 -> 微信将数据发送给开发者 -> 开发者处理消息并返回数据至微信 -> 微信把返回数据发送给用户，期间数据交互通过XML完成，就这么简单。
下面写个实例，开发微信智能聊天机器人:

1. 注册微信公众平台账号

微信公众平台:
https://mp.weixin.qq.com/
注: 目前一张身份证只能注册两个账号，账号名称关乎加微信认证，请慎重注册。

2. 申请服务器/虚拟主机

没有服务器/虚拟主机的童鞋可以使用BAE和SAE，不多介绍。我自己是在搬瓦工上面购买的一个VPS，之前主要用来翻墙使用。

3. 开启开发者模式

微信公众平台有两个模式，一个是编辑模式（傻瓜模式），简单但功能单一。另一个是开发者模式，可以通过开发实现复杂功能。两个模式互斥，显而易见，登录微信公众平台并通过“开发”菜单开启开发者模式。

4. 填写接口配置信息

同样是在“开发”-“基本配置”- “服务器配置”菜单中配置，需要配置两项参数:
URL: 服务器地址，目前仅支持80端口
TOKEN: 令牌，随意填写，以”hello2017”为例，用于生成签名

填写完把下面代码保存为index.php并上传至http://your.server.ip/chat/目录，最后点击“提交”完成验证。其中your.server.ip是你的服务器IP地址或者域名。

<?php
/*** wechat php test*///define your token
define("TOKEN", "hello2017");
$wechatObj = new wechatCallbackapiTest();
$wechatObj->valid();class wechatCallbackapiTest
{public function valid(){$echoStr = $_GET["echostr"];//valid signature , optionif($this->checkSignature()){echo $echoStr;exit;}}private function checkSignature(){// you must define TOKEN by yourselfif (!defined("TOKEN")) {throw new Exception('TOKEN is not defined!');}$signature = $_GET["signature"];$timestamp = $_GET["timestamp"];$nonce = $_GET["nonce"];$token = TOKEN;$tmpArr = array($token, $timestamp, $nonce);// use SORT_STRING rulesort($tmpArr, SORT_STRING);$tmpStr = implode( $tmpArr );$tmpStr = sha1( $tmpStr );if( $tmpStr == $signature ){return true;}else{return false;}}
}?>

这玩意儿就是微信公众平台校验URL是否正确接入，研究代码没有实质性意义，验证完即可删除文件，就不详细说明了，有兴趣的童鞋可以查看官方文档。
微信公众平台API文档

5. 开发微信公众平台功能

OK，上面提到了，微信公众平台与开发者之间的数据交互是通过XML完成的，既然用到XML，当然得遵循规范，所以在着手开发之前先看看官方接口文档提供的XML规范，以文本消息为例:

<xml>
<!--开发者微信号-->
<ToUserName><![CDATA[toUser]]></ToUserName>
<!--发送方帐号（OpenID）-->
<FromUserName><![CDATA[fromUser]]></FromUserName>
<!--消息创建时间 （整型）-->
<CreateTime>12345678</CreateTime>
<!--消息类别 （text文本消息）-->
<MsgType><![CDATA1]></MsgType>
<!--消息内容-->
<Content><![CDATA[content]]></Content>
<!--消息ID （64位整型）-->
<MsgId>1234567890123456</MsgId>
</xml>

开发者在处理完消息后需要返回数据给微信服务器:

<xml>
<!--接收方帐号（OpenID）-->
<ToUserName><![CDATA[toUser]]></ToUserName>
<!--开发者微信号-->
<FromUserName><![CDATA[fromUser]]></FromUserName>
<!--消息创建时间 （整型）-->
<CreateTime>12345678</CreateTime>
<!--消息类别 （text文本消息）-->
<MsgType><![CDATA1]></MsgType>
<!--回复消息内容-->
<Content><![CDATA[content]]></Content>
<!--星标操作（位0x0001被标志时 星标刚收到的消息）-->
<FuncFlag>0</FuncFlag>
</xml>

除文本消息外，微信公众平台还支持用户发送图片消息、地理位置消息、链接消息、事件推送，而开发者还可以向微信公众平台回复音乐消息和图文消息，各类消息XML规范也可以参见官方文档。

来看看官方提供的一个PHP示例，我结合图灵机器人接口做了一些修改:

<?php
/*** wechat php test*/
$wechatObj = new wechatCallbackapiTest();
$wechatObj->responseMsg();class wechatCallbackapiTest
{// the api key string of the tuling // Replace your own apikey here ! const tuling_apiKey = "d8cca87d4ec446629bd4750cf404d84233";const tuling_apiUrl = "http://www.tuling123.com/openapi/api?key=";const tuling_userid = 0;// response the wechat user by tuling robot according to the keywordfunction responseByTulingRobot( $keyword ){$responseStr = "";$apiUrlStr = self::tuling_apiUrl . self::tuling_apiKey . '&userid=' . self::tuling_userid . '&info=';try{$text = file_get_contents($apiUrlStr . urlencode($keyword));$result = json_decode($text);switch ($result->code) {// text type case 100000 :$responseStr = $result -> text;break;// link type case 200000 :$responseStr = $result -> text . ": </br> " . "<a style=\"color='#000000';\" href=\"" . $result -> url . "\"> ---go---</a>";break;// others default:$responseStr = "I don't know  how to response you !";break;}}catch(Exception $e) {$responseStr = "Sorry I don't know  how to response you !";}return $responseStr;}private function writeLog($content){file_put_contents("/tmp/log.txg", $content, FILE_APPEND);}public function responseMsg(){//get post data, May be due to the different environments$postStr = $GLOBALS["HTTP_RAW_POST_DATA"];$this->writeLog( $postStr );//extract post dataif (!empty($postStr)){/* libxml_disable_entity_loader is to prevent XML eXternal Entity Injection,the best way is to check the validity of xml by yourself */libxml_disable_entity_loader(true);$postObj = simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_NOCDATA);  $fromUsername = $postObj->FromUserName;$toUsername = $postObj->ToUserName;$keyword = trim($postObj->Content);$time = time();$textTpl = "<xml><ToUserName><![CDATA[%s]]></ToUserName><FromUserName><![CDATA[%s]]></FromUserName><CreateTime>%s</CreateTime><MsgType><![CDATA[%s]]></MsgType><Content><![CDATA[%s]]></Content><FuncFlag>0</FuncFlag></xml>";             if(!empty( $keyword )){$msgType = "text";//$contentStr = "Welcome to wechat world!";$contentStr = $this->responseByTulingRobot($keyword);$resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr);echo $resultStr;writeLog($resultStr);}else{echo "Input something...";}}else {echo "";exit;}}
}?>

简单的测试了下效果如下：

希望本文所述对大家基于php的微信公众平台开发有所帮助。