PHP开发之用微信远程遥控服务器
摘要
微信公众好的开发很火,小程序更火。于是也凑个热闹,尝试了一把。
大致的功能还是有的,不过是不全,很多地方我没有进行处理。不过对于纯文本方式的交流,已经没有问题啦。
环境搭建
下面大致的讲讲微信公众号的原理吧。可能我理解的有些不到位,如果有些许不当,欢迎批评指教。
客户端发送给微信平台请求,微信平台将请求转发给私服,交给程序处理之后,获取到私服的处理结果,然后反馈给客户端。
当然,这其中起到核心作用的自然是“微信公众平台”啦。相当于提供了一个舞台,一个能让各位能人异士展现出各自的特色的平台。其实,不仅微信如此,阿里同样是这样,如此各大电商才能一展手脚不是。
开启配置
这第一步,就是先申请一个微信开发者账号,个人的话选择订阅号就足够了。网上相关的资料很多,也很详细,我就不多说了。咱们直奔主题好了。
首先登陆开发者账号成功后,开启服务器端的设置即可,如下图
开启完成,根据自己服务器的情况进行一下设置即可。
- url就是你的私服用于处理请求数据的地址
- token就是一个令牌,随便设置。不过记住待会自己的代码上会用到。
- 至于密钥嘛,没什么较大的作用,暂且可以先不用管。
按需设置
设置完,就可以启用了。这就好比家里的电线全部装修好了,现在要使用,按下开关一样。如下图
启用服务器配置
服务器环境
关于服务器这块,官网上讲解的也是很详细的啦。
我们还可以下载官方的demo来模拟。
官方样本
代码也很简单。基本上学过了php基本语法的都能够看得懂。
<?php /** * wechat php test */ //define your token define("token", "weixin"); $wechatobj = new wechatcallbackapitest(); $wechatobj->valid(); class wechatcallbackapitest { public function valid() { $echostr = $_get["echostr"]; //valid signature , option if($this->checksignature()){ echo $echostr; exit; } } public function responsemsg() { //get post data, may be due to the different environments $poststr = $globals["http_raw_post_data"]; //extract post data if (!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!"; $resultstr = sprintf($texttpl, $fromusername, $tousername, $time, $msgtype, $contentstr); echo $resultstr; }else{ echo "input something..."; } }else { echo ""; exit; } } private function checksignature() { // you must define token by yourself if (!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 rule sort($tmparr, sort_string); $tmpstr = implode( $tmparr ); $tmpstr = sha1( $tmpstr ); if( $tmpstr == $signature ){ return true; }else{ return false; } } } ?>
核心思路,无非检验一下签名,处理一下请求,反馈一下结果罢了。
这里我不得不想说的就是,我觉得腾讯其实可以将那些个模板什么的去掉,直接暴露出黑盒模式,这样的话安全性会更高一点。很多时候,权限放的越开,效果可能越差。
核心类
接下来就是我自己的处理逻辑了,参照官方文档。微信公众好上有6大接收接口,三大回复接口。依据msgtype即可判定。
接口详情
验证
private function checksignature() { // you must define token by yourself if (! 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 rule sort ( $tmparr, sort_string ); $tmpstr = implode ( $tmparr ); $tmpstr = sha1 ( $tmpstr ); if ($tmpstr == $signature) { return true; } else { return false; } }
验证方法核心就是依据咱们之前网页上设置的token来工作的,所以代码上会用得到。
回复
回复的代码需要依据客户端发送的数据的类型来区分对待,类型这块微信平台会将数据打包好封装起来,我们住需要调用内部的msgtype进行处理即可。
拓展
拓展部分,是我自己异想天开往上加的。
添加机器人
调用一个机器人接口,来代替自己发送回复,技能让用户得到一个良好的用户体验,还能愉悦大众,何乐而不为?
我这边测试了两个接口,一个是curl模式,一个是file_get_contents模式,都挺好用的啦。
<?php /** * 图灵 机器人接口 * * 使用curl来进行浏览器模拟并抓取数据 */ function turing($requeststr) { // 图灵机器人接口 $url = "http://www.tuling123.com/openapi/api"; // 用于post请求的数据 $data = array( 'key'=>"哈哈,这个key还是得你自己去申请的啦", 'info'=>$requeststr, ); // 构造curl下载器 $ch = curl_init(); curl_setopt($ch, curlopt_url, $url); curl_setopt($ch, curlopt_returntransfer, 1); curl_setopt($ch, curlopt_post, 1); curl_setopt($ch, curlopt_postfields, $data); $responsestr = curl_exec($ch); curl_close($ch); return $responsestr; } /** * 调用另外的接口 * @param unknown $req * @return mixed */ function test($req){ $url = "http://api.qingyunke.com/api.php?key=free&appid=0&msg=".$req; $result = file_get_contents($url); $result = json_decode($result, true); return $result['content']; } $req = 'hello'; $res = test($req); echo $res;
命令模式
手机相对于电脑一个很大的优点就是便携,我们虽然不能随时随地携带电脑,但是却能使用手机来代替。很多时候对服务器的管理需要的命令很简单,但是远程登录的时候也不方便。这个时候就用微信来帮忙传话也是不错的啦。
我平时喜欢使用python写一些脚本,什么获取本地ip,聊天,查看内存,网速啥的,可谓是应有尽有。这下也终于能有用武之地了。利用微信的关键字匹配,就可以简单的让微信公众号当一个小小传话员啦。
这里给个思路,具体实现起来也比较简单,当做是文本来处理即可。
完整代码
下面贴出我服务器上的完整代码,有些私密的地方我做了些更改,届时按照自己的情况进行修改即可。
<?php /** * wechat php test */ // define your token define ( "token", "您的token" ); $wechatobj = new wechatcallbackapitest (); // $wechatobj->valid(); // 调用回复信息方法 $wechatobj->responsemsg (); // 微信消息处理核心类 class wechatcallbackapitest { public function valid() { $echostr = $_get ["echostr"]; // valid signature , option if ($this->checksignature ()) { echo $echostr; exit (); } else { echo "验证失败!"; } } public function responsemsg() { // get post data, may be due to the different environments // 类似$_post但是可以接受xml数据,属于增强型 $poststr = $globals ["http_raw_post_data"]; // extract post data if (! 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 */ // 不解析外部数据,防止xxml漏洞 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 (); /* * 微信客户端发送信息的时候会附带一些参数,详见官方文档。所以要根据不同的类型,来分别做相关的处理。 * 于是msgtype 就充当这样的一个区分的标记 */ $msgtype = $postobj->msgtype; /* * 当有用户关注后者退订的时候,会触发相应的事件。所以再来个event事件的监听更为友好。 * $event = $postobj->event. * 具体的参数信息,官网上很详细。 */ $event = $postobj->event; switch ($msgtype) { // 文本消息 处理部分 case "text" : if (! empty ( $keyword )) { // 在此处进行对关键字的匹配就可以实现:针对不同关键字组装的相应数据 if($keyword=='音乐' || $keyword == "music") { $msgtype = 'music'; $musictitle = "the mountain"; $musicdescription = "夏日舒心清凉歌曲"; $musicurl = "http://101.200.58.242/wx/themaintain.mp3"; $hqmusicurl = "http://101.200.58.242/wx/themaintain.mp3"; musicmessagehandle($fromusername, $tousername, $time, $msgtype, $musictitle, $musicdescription, $musicurl, $hqmusicurl); }elseif($keyword == '1'){ $msgtype = 'text'; $contentstr = "人生得意须尽欢,莫使金樽空对月!"; textmessagehandle($fromusername, $tousername, $time, $msgtype, $contentstr); }elseif($keyword == '命令模式'){ $msgtype = 'text'; $contentstr = "进入命令模式,开始对服务器进行管理!\n接下来将依据您输入的命令对服务器进行管理!"; textmessagehandle($fromusername, $tousername, $time, $msgtype, $contentstr); }else { // 直接调用 机器人接口,与用户进行交流 $msgtype = "text"; $contentstr = turing($keyword)!=""?turing($keyword):"这里是微信 纯文本测试数据!"; textmessagehandle ( $fromusername, $tousername, $time, $msgtype, $contentstr ); } } else { echo "您得输入点数据,我才能回复不是!"; } break; // 接收图片信息 case "image" : if (! empty ( $keyword )) { // $msgtype = "image"; $contentstr = "您发送的图片看起来还真不错!"; textmessagehandle ( $fromusername, $tousername, $time, $msgtype, $contentstr ); } else { echo "服务器没能收到您发送的图片!"; } break; // 接收语音信息 case "voice" : if (! empty ( $keyword )) { // $msgtype = "voice"; $contentstr = "您发送的语音听起来还真不错!"; textmessagehandle ( $fromusername, $tousername, $time, $msgtype, $contentstr ); } else { echo "服务器没能收到您发送的语音!"; } break; // 接收视频信息 case "video" : if (! empty ( $keyword )) { // $msgtype = "video"; $contentstr = "您发送的视频看起来还真不错!"; textmessagehandle ( $fromusername, $tousername, $time, $msgtype, $contentstr ); } else { echo "服务器没能收到您发送的视频!"; } break; // 接收视频信息 case "shortvideo" : if (! empty ( $keyword )) { // $msgtype = "shortvideo"; $contentstr = "您发送的小视频看起来还真不错!"; textmessagehandle ( $fromusername, $tousername, $time, $msgtype, $contentstr ); } else { echo "服务器没能收到您发送的小视频!"; } break; // 接收位置信息 case "location" : if (! empty ( $keyword )) { // $msgtype = "location"; $contentstr = "您发送的位置已被接收!"; textmessagehandle ( $fromusername, $tousername, $time, $msgtype, $contentstr ); } else { echo "服务器没能收到您发送的位置!"; } break; // 接收视频信息 case "link" : if (! empty ( $keyword )) { // $msgtype = "link"; $contentstr = "您发送的链接看起来还真不错!"; textmessagehandle ( $fromusername, $tousername, $time, $msgtype, $contentstr ); } else { echo "服务器没能收到您发送的链接!"; } break; // 对事件进行侦听 case "event": switch ($event) { case "subscribe": // 发送一些消息! $msgtype = 'text'; $contentstr = "终于等到你!"; textmessagehandle($fromusername, $tousername, $time, $msgtype, $contentstr); break; } break; default : break; } } else { echo ""; exit (); } } private function checksignature() { // you must define token by yourself if (! 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 rule sort ( $tmparr, sort_string ); $tmpstr = implode ( $tmparr ); $tmpstr = sha1 ( $tmpstr ); if ($tmpstr == $signature) { return true; } else { return false; } } } /** * 定义为心中想难关的六个接口的数据发送格式模板 */ function textmessagehandle($fromusername, $tousername, $time, $msgtype, $contentstr) { $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>"; $resultstr = sprintf ( $texttpl, $fromusername, $tousername, $time, $msgtype, $contentstr ); echo $resultstr; } function imagemessagehandle($fromusername, $tousername, $time, $msgtype, $contentstr) { $imagetpl = "<xml> <tousername><![cdata[%s]]></tousername> <fromusername><![cdata[%s]]></fromusername> <createtime>%s</createtime> <msgtype><![cdata[%s]]></msgtype> <content><![cdata[%s]]></content> <picurl><![cdata[this is a url]]></picurl> <mediaid><![cdata[media_id]]></mediaid> <msgid>1234567890123456</msgid> </xml>"; $resultstr = sprintf ( $texttpl, $fromusername, $tousername, $time, $msgtype, $contentstr ); echo $resultstr; } function musicmessagehandle($fromusername, $tousername, $time, $msgtype, $musictitle, $musicdescription, $musicurl, $hqmusicurl) { $musictpl = "<xml> <tousername><![cdata[%s]]></tousername> <fromusername><![cdata[%s]]></fromusername> <createtime>%s</createtime> <msgtype><![cdata[%s]]></msgtype> <music> <title><![cdata[%s]]></title> <description><![cdata[%s]]></description> <musicurl><![cdata[%s]]></musicurl> <hqmusicurl><![cdata[%s]]></hqmusicurl> </music> </xml>"; $resultstr = sprintf($musictpl, $fromusername, $tousername, $time, $msgtype, $musictitle, $musicdescription, $musicurl, $hqmusicurl); echo $resultstr; } /** * 图灵 机器人接口 * * 使用curl来进行浏览器模拟并抓取数据 */ function turing($requeststr) { /* // 图灵机器人接口 $url = "http://www.tuling123.com/openapi/api"; // 用于post请求的数据 $data = array( "key"=>"您在图灵机器人官网上申请的key", "info"=>$requeststr ); // 构造curl下载器 $ch = curl_init(); curl_setopt($ch, curlopt_url, $url); curl_setopt($ch, curlopt_returntransfer, 1); curl_setopt($ch, curlopt_post, 1); curl_setopt($ch, curlopt_postfields, $data); $requeststr = curl_exec($ch); curl_close($ch); return responsestr; */ $url = "http://api.qingyunke.com/api.php?key=free&appid=0&msg=".$requeststr; $result = file_get_contents($url); $result = json_decode($result, true); return $result['content']; } ?>
总结
最后来回顾一下,本次试验用到了哪些知识点。
- php的面向对象方法编程简单实现。
- 接口处理的两种方式
- 微信公众号后台私服的接入,处理,反馈。
- 前后端的交互,以及聊天机器人的应用。
其实,这些代码跟我一开始的设想还是差别挺大的,原本是想实现一个“遥控器”,晚上想睡觉之前,用微信发一条命令“打开电热毯”,半个小时后,电视看完了,去睡觉的时候发现被窝很暖和,是的,只要加上点硬件,这很容易实现啦再者冰箱了,电视了统统可以完成,那样估计就诊的是“智能家居”了吧。
上一篇: php实现统计二进制中1的个数算法示例
推荐阅读