基于PHP的微信公众号的开发流程详解
微信公众号开发分傻瓜模式和开发者模式两种,前者不要考虑调用某些接口,只要根据后台提示傻瓜式操作即可,适用于非专业开发人员。
开发模式当然就是懂程序开发的人员使用的。
下面简单说一下微信公众号开发的简易流程,新手看看会有帮助,高手请一笑而过。
1、配置服务器:
A、首先在本机建立如下结构的文件夹(这里是我自己的习惯,仅供参考)
MMPN:总目录mro message public number 微信公众号
backup:备份目录,主要用于备份php文件,每次修改时将原稿备份到里面去。
images:存放图片
includes:包含文件,包括mysql配置,smarty模板包含文件等等
menu:存放公众号菜单信息,txt文档即可
gr****zx.php:开发文件,即公众号关联的程序文件,也就是配置的url对应的文件
最后的是需求等等的文件
主程序文件:gr****zx.php
<?php define("TOKEN", "aabbc_lzpt"); //获取微信发送数据 $postStr = $GLOBALS["HTTP_RAW_POST_DATA"]; //返回回复数据 if (!empty($postStr)) { //解析数据 $postObj = simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_NOCDATA); //发送消息方ID $fromUsername = $postObj->FromUserName; //接送消息方ID $toUsername = $postObj->ToUserName; //消息类型 $form_MsgType = $postObj->MsgType; //事件消息 if($form_MsgType=="event") { //获取事件类型 $form_Event = $postObj->Event; //订阅事件 if($form_Event=="subscribe") { //回复欢迎图文信息 /* $resultStr = "<xml> <ToUserName><![CDATA[".$fromUsername."]]></ToUserName> <FromUserName><![CDATA[".$toUsername."]]></FromUserName> <CreateTime>".time()."</CreateTime> <MsgType><![CDATA[news]]></MsgType> <ArticleCount>2</ArticleCount> <Articles> <item> <Title><![CDATA[ 欢迎关注***微信服务平台,****]]></Title> <Description><![CDATA[这是简短描述文字]]></Description> <PicUrl><![CDATA[http://a.hiphotos.baidu.com/baike/c0%3Dbaike116%2C5%2C5%2C116%2C38/sign=5cae7405f21f3a294ec5dd9cf84cd754/32fa828ba61ea8d32de5a1df950a304e241f5822.jpg]]></PicUrl> <Url><![CDATA[http://www.baidu.com]]></Url> </item> <item> <Title><![CDATA[最新动态]]></Title> <Description><![CDATA[]]></Description> <PicUrl><![CDATA[http://a.hiphotos.baidu.com/baike/c0%3Dbaike116%2C5%2C5%2C116%2C38/sign=5cae7405f21f3a294ec5dd9cf84cd754/32fa828ba61ea8d32de5a1df950a304e241f5822.jpg]]></PicUrl> <Url><![CDATA[http://www.baidu.com]]></Url> </item> </Articles> </xml> "; */ //回复欢迎文字信息 $reply="您好,欢迎关注******微信公众平台"; $resultStr="<xml> <ToUserName><![CDATA[".$fromUsername."]]></ToUserName> <FromUserName><![CDATA[".$toUsername."]]></FromUserName> <CreateTime>".time()."</CreateTime> <MsgType><![CDATA[text]]></MsgType> <Content><![CDATA[".$reply."]]></Content> </xml>"; } else if($form_Event=="CLICK") { $form_Event_Key = $postObj->EventKey; if($form_Event_Key=="V3002_CONTACT") { /* $resultStr = "<xml> <ToUserName><![CDATA[".$fromUsername."]]></ToUserName> <FromUserName><![CDATA[".$toUsername."]]></FromUserName> <CreateTime>".time()."</CreateTime> <MsgType><![CDATA[news]]></MsgType> <ArticleCount>1</ArticleCount> <Articles> <item> <Title><![CDATA[如何成为本站会员]]></Title> <Description><![CDATA[本栏目介绍详细的加入流程!]]></Description> <PicUrl><![CDATA[http://a.hiphotos.baidu.com/baike/c0%3Dbaike116%2C5%2C5%2C116%2C38/sign=5cae7405f21f3a294ec5dd9cf84cd754/32fa828ba61ea8d32de5a1df950a304e241f5822.jpg]]></PicUrl> <Url><![CDATA[http://www.baidu.com]]></Url> </item> </Articles> </xml> "; */ $reply="我们的地址:黄河东路222号\n我们的热线:0510-88888888"; $resultStr="<xml> <ToUserName><![CDATA[".$fromUsername."]]></ToUserName> <FromUserName><![CDATA[".$toUsername."]]></FromUserName> <CreateTime>".time()."</CreateTime> <MsgType><![CDATA[text]]></MsgType> <Content><![CDATA[".$reply."]]></Content> </xml>"; } } } else if($form_MsgType=="location"){ $lng1=$postObj->Location_X; $lat1=$postObj->Location_Y; $from_Location_Label=$postObj->Label; $reply="地理位置:"; $reply.="纬度".$lat1."\t经度".$lng1."位置".$from_Location_Label; $resultStr = "<xml> <ToUserName><![CDATA[".$fromUsername."]]></ToUserName> <FromUserName><![CDATA[".$toUsername."]]></FromUserName> <CreateTime>".time()."</CreateTime> <MsgType><![CDATA[text]]></MsgType> <Content><![CDATA[".$reply."]]></Content> </xml> "; } echo $resultStr; exit; } else { echo ""; exit; } ?>
临时文件:wx_sample.php
<?php /** * wechat php test */ //define your token define("TOKEN", "aabbc_lzpt"); $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)){ $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() { $signature = $_GET["signature"]; $timestamp = $_GET["timestamp"]; $nonce = $_GET["nonce"]; $token = TOKEN; $tmpArr = array($token, $timestamp, $nonce); sort($tmpArr, SORT_STRING); $tmpStr = implode( $tmpArr ); $tmpStr = sha1( $tmpStr ); if( $tmpStr == $signature ){ return true; }else{ return false; } } } ?>
注意看两个文件开头都有代码:define("TOKEN", "aabbc_lzpt"); 这是定义token,后面的值自己设置,但是自己要记住,在微信后台配置服务器要用到它。
B、现在开始操作,首先,将gr****zx.php文件中的内容(代码),临时清空,代替以临时文件中的内容(代码),保存。将MMPN项目传到服务器,这时,主程序文件url为“http://www.****.com/MMPN/fy_hzx/grape_fy_hzx.php”这样的形式,确保路径正确,打开微信公众号后台开发者中心,点击下图中“修改配置”,将刚才的url填入相应控件
token就是刚才提到要记住的token的值,要一致。第三个“消息加密密钥”可以随机生成,然后提交。
token正确和url正确以及文件代码无误的话,会提示成功,再点启用。
C、刚才主程序文件中的代码是临时的,只是为了开通注册验证token,成功以后,可以再次清除,恢复成原来的内容。(保存好再上传到服务器)
这样服务器配置工作就结束了。
2、介绍一下主程序文件中的代码
$form_MsgType = $postObj->MsgType;
$form_MsgType消息类型,分为“事件”、“位置”(粉丝发送位置)、“文字类型”、“图片类型”等,具体可查看后台接口文档
$form_Event = $postObj->Event;
$form_Event 事件类型分为“订阅”(subscribe)(也就是点关注)、退订(unsubscribe)、“点击”(CLICK)――点击菜单,但是只针对click类型的菜单,如果是url类型的菜单,则直接打开对应的url,无须在代码中处理。
回复粉丝的内容形式一般为文字或图文两种,代码中都有。
3、菜单配置
菜单配置要知道开发者ID中的AppID(这个可以直接看到)和AppSecret(这个有可能是被隐藏的,要通过公众号管理员验证通过申请查看才能显示完整,显示完整后要及时保存记录,这样下次就不用再找管理员了)。
配置菜单前,首先要拿到access_token,它的有效期为2小时。如图点击获取access_token
然后在右下方点击“使用网页调试工具调试该接口”
输入appid和secret,点“检查问题”提交
拷贝获取到的access_token
重新选择自定义菜单:
将刚获取到的access_token 拷入
如果接口列表选择的是查询菜单,提交的结果是不存在,这就对了,因为我们还没有创建菜单呢
那么,我们就创建一个,将以下json格式代码拷入body中,提交
{ "button": [ { "name": "首页", "sub_button": [ { "type": "view", "name": "注册登录", "url": "http://www.baidu.com", "sub_button": [ ] }, { "type": "click", "name": "娱乐一刻", "key": "V1001_QUERY", "sub_button": [ ] }, { "type": "view", "name": "查看官网", "url": "http://www.baidu.com", "sub_button": [ ] } ] }, { "name": "主页", "sub_button": [ { "type": "view", "name": "注册登录", "url": "http://www.baidu.com", "sub_button": [ ] }, { "type": "click", "name": "娱乐一刻", "key": "V1001_QUERY", "sub_button": [ ] }, { "type": "view", "name": "查看官网", "url": "http://www.baidu.com", "sub_button": [ ] } ] }, { "name": "关注我们", "sub_button": [ { "type": "view", "name": "注册登录", "url": "http://www.baidu.com", "sub_button": [ ] }, { "type": "click", "name": "娱乐一刻", "key": "V1001_QUERY", "sub_button": [ ] }, { "type": "view", "name": "查看官网", "url": "http://www.baidu.com", "sub_button": [ ] } ] } ] }
提交,提示成功菜单即生成。
菜单内容中,有两个类型 (type),一个是view,这个会直接打开相应url链接;一个是click,这个就会在刚才主程序文件中寻找对应key值运行相关的代码。
格式不要弄错就行。
如果要修改菜单,先删除,再创建;一般来说,菜单更改后,公众号须重新关注才能马上看到更改效果,否则要等24小时自动更新。