《微信公众平台开发：从零基础到ThinkPHP5高性能框架实践》——3.3　微信开发者中心...

xiaoxiao2023-09-17 165

本节书摘来自华章计算机《微信公众平台开发：从零基础到ThinkPHP5高性能框架实践》一书中的第3章，第3.3节，作者方倍工作室，更多章节内容可以访问云栖社区“华章计算机”公众号查看。

3.3　微信开发者中心

3.3.1　配置和启用服务器

登录微信公众平台后台（微信公众平台地址为https://mp.weixin.qq.com），在左侧列表的最下方找到“基本配置”，如图3-19所示。

单击进入配置页面，可以看到当前有服务器配置信息，状态为未启用，如图3-20所示。　　　

单击“修改配置”按钮，进入修改页面，如图3-21所示。

其中，URL为3.1.1节中介绍的云应用的域名，即http://fbstudio.sinaapp.com ，而Token在index.php中定义为weixin，EncodingAESKey不需要填写，单击“随机生成”按钮，让系统自动生成一个即可，“消息加解密方式”选择“明文模式”，然后单击“提交”按钮，弹出确认框，如图3-22所示。

在弹出的提示框中单击“确定”按钮，相关参数填写成功，如图3-23所示。

再单击右上角的“启用”按钮，启用服务器的配置。系统弹出提示框，询问“是否确定开启服务器配置”，如图3-24所示。

单击“确定”按钮，将启用服务器配置。

如果单击按钮后，上方提示“Token验证失败”，可以重试几次，微信服务器有时不稳定也会造成这样的情况，并不是程序本身有问题。启用成功后的界面如图3-25所示。

这样就成功配置并启用了服务器。

3.3.2　配置失败常见问题与分析

提交URL和Token的时候，有时会碰到提交不成功的情况，具体有以下几种。

1.请求URL超时

这种情况一般是由于服务器网速或响应速度太慢。此时可以先重试几次或者等一段时间再试，如果还是这样，则需要考虑更换速度更快、性能更好的服务器。

2.系统发生错误，请稍后重试

这种情况一般是由于微信服务器短时间内的异常引起的，一般重试或者过一段时间尝试即可。

3.Token验证失败

这种情况需要具体分析验证过程被卡在哪一个环节了。此时可以通过调用变量$_SERVER来获取服务器和执行环境信息，以便进行分析。

$_SERVER是一个包含诸如头信息（Header）、路径（Path）及脚本位置（Script Location）等信息的数组。这个数组中的项目由Web服务器创建。若要了解更多关于$_SERVER的信息，可访问官方网站http://www.php.net/manual/zh/reserved.variables.server.php。

这里需要使用以下两个元素。

$_SERVER['REMOTE_ADDR']：来访者的IP地址，此处为微信服务器的IP地址。$_SERVER['QUERY_STRING']：查询请求字符串，此处为微信服务器发过来的GET请求字符串。

将以上两个变量记录到日志中。函数定义如下。

上面代码中，当环境为SAE时，使用SAE的调试函数sae_debug()将内容记录到日志中。而在具有读写权限的空间下，使用file_put_contents()函数把字符串写入文件。

然后在程序的数据处理之前调用该函数，记录信息，代码如下。

define("TOKEN", "weixin"); traceHttp(); $wechatObj = new wechatCallbackapiTest(); if (isset($_GET['echostr'])) { $wechatObj->valid(); }else{ $wechatObj->responseMsg(); }

当提交URL和Token验证的时候，程序目录下应当生成一个log.xml文件。内容类似如下。

2016-10-10 11:03:21 REMOTE_ADDR:101.226.61.144 QUERY_STRING:signature=6e35c6f3d3279338781047dbffd09426b9ecdee3&echostr=59794206 53038092664×tamp=1392001400&nonce=1392192345

下面可以得出初步结论。

没有生成日志文件：微信服务器没有访问到你的服务器，需要先检查你的服务器是否可以通过公网访问，以及URL路径是否正确并且可以访问。如果可以通过公网访问，而微信服务器不能访问，那么可能是防火墙拦截了80端口或微信服务器的IP地址，也可能是服务器所在区域与微信服务器通信不畅，需要更换服务器。

已经生成日志文件：查看REMOTE_ADDR和QUERY_STRING的内容是否与上述类似。确认signature、timestamp、nonce、echostr等4个参数都有值。如果这些都没有问题，则检查程序中定义的Token值是否与提交的一致，再检查程序流程及数据处理是否与官方文档描述的一致。

如果确定以上均没有问题，可以使用下面章节中的微信调试器进行测试，它提供了更为宽松的校验方式，并且可以实时输出当前的XML数据供调试时参考。

3.3.3　自动回复当前时间

在上面的例子中，已经嵌入了一个简单的时间查询功能，发送一个问号“?”就能回复当前的时间，如图3-26所示。

这个功能是基于下面的代码实现的。

if($keyword == "?" || $keyword == "？") { $msgType = "text"; $content = date("Y-m-d H:i:s",time()); $result = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $content); echo $result; }

上述代码在收到消息后，判断消息内容是否为问号（包括英文输入状态下的问号和中文输入状态下的问号），如果包含，则将当前时间（包括年月日时分秒）作为回复内容，构造成一个消息回复给用户。这样公众号就实现了当前时间的自动回复。

3.3.4　消息交互原理分析

下面结合3.3.3节的代码来分析微信公众平台的消息交互原理。下面的代码基于微信公众平台官方示例代码修改完善而成。

1 <?php 2 /* 3 方倍工作室 http:// www.fangbei.org/ 4 CopyRight 2013 www.doucube.com All Rights Reserved 5 */ 6 7 define("TOKEN", "weixin"); 8 $wechatObj = new wechatCallbackapiTest(); 9 if (isset($_GET['echostr'])) { 10 $wechatObj->valid(); 11 }else{ 12 $wechatObj->responseMsg(); 13 } 14 15 class wechatCallbackapiTest 16 { 17 public function valid() 18 { 19 $echoStr = $_GET["echostr"]; 20 if($this->checkSignature()){ 21 echo $echoStr; 22 exit; 23 } 24 } 25 26 private function checkSignature() 27 { 28 $signature = $_GET["signature"]; 29 $timestamp = $_GET["timestamp"]; 30 $nonce = $_GET["nonce"]; 31 32 $token = TOKEN; 33 $tmpArr = array($token, $timestamp, $nonce); 34 sort($tmpArr); 35 $tmpStr = implode( $tmpArr ); 36 $tmpStr = sha1( $tmpStr ); 37 38 if( $tmpStr == $signature ){ 39 return true; 40 }else{ 41 return false; 42 } 43 } 44 45 public function responseMsg() 46 { 47 $postStr = $GLOBALS["HTTP_RAW_POST_DATA"]; 48 49 if (!empty($postStr)){ 50 $postObj = simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_ NOCDATA); 51 $fromUsername = $postObj->FromUserName; 52 $toUsername = $postObj->ToUserName; 53 $keyword = trim($postObj->Content); 54 $time = time(); 55 $textTpl = "<xml> 56 <ToUserName><![CDATA[%s]]></ToUserName> 57 <FromUserName><![CDATA[%s]]></FromUserName> 58 <CreateTime>%s</CreateTime> 59 <MsgType><![CDATA[%s]]></MsgType> 60 <Content><![CDATA[%s]]></Content> 61 <FuncFlag>0</FuncFlag> 62 </xml>"; 63 if($keyword == "?" || $keyword == "？") 64 { 65 $msgType = "text"; 66 $content = date("Y-m-d H:i:s",time()); 67 $result = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $content); 68 echo $result; 69 } 70 }else{ 71 echo ""; 72 exit; 73 } 74 } 75 } 76 ?>

首先看一下代码的结构。

第2～5行是注释部分。

第7行使用define()函数定义常量，常量名称为TOKEN，常量的值为weixin，这个值就是在启用开发模式时填写的Token。

第15～75行定义了一个类wechatCallbackapiTest，并在类中定义了3个方法valid()、checkSignature()和responseMsg()。

第8～13行为程序执行语句。第8行实例化了一个类对象。在第9行中，判断是否有GET请求有echostr变量，如果有，则执行valid()方法，否则执行responseMsg()方法。

下面分析微信消息交互流程。

提交URL和Token申请验证的时候，微信服务器将发送GET请求到填写的URL上，并且带上4个参数（signature、timestamp、nonce、echostr）。GET请求类似如下。

signature=6e35c6f3d3279338781047dbffd09426b9ecdee3&echostr=5979420653038092664&t imestamp=1392001400&nonce=1392192345

上述请求的参数说明如表3-1所示。

这个GET请求是包含echostr变量的，所以执行valid()方法。在该方法中，又调用了校验签名方法checkSignature()。如果签名校验为真，则原样输出变量$echoStr的值。

加密/校验流程如下。

1）将token、timestamp、nonce等3个参数进行字典序排序，见第33～34行。2）将3个参数字符串拼接成一个字符串进行sha1加密，见第35～36行。3）开发者获得加密后的字符串可与signature对比，标识该请求来源于微信，见第38～42行。

发送问号的时候，微信服务器也会带上前面3个参数（signature、timestamp、nonce）访问开发者设置的URL，同时还会将消息的XML数据包POST到URL上。XML格式类似如下。

而消息请求不包含echostr变量，所以将执行响应消息方法responseMsg()。

响应消息方法首先接收上述原始POST数据，见第47行。

然后它将数据载入对象中，对象名为SimpleXMLElement，LIBXML_NOCDATA?表示将CDATA合并为文本节点，代码中第50行实现此功能。

第51～54行取得XML类对象的值，并赋给新的变量，注意发送方变为接收方，接收方变为发送方。

第55～62行构造要回复的XML数据包。

第63行判断发送过来的关键字是不是问号。

第64～65行设置回复的消息类型为text，内容为当前年月日时分秒。

第66～67行封装回复的XML数据包，并且向微信服务器输出。XML格式如下。

这样用户就会收到回复的消息，效果如图3-26所示。

3.3.5　消息体加/解密实现

在图3-21中，微信公众平台在配置服务器时，提供了3种加解密模式供开发者选择，即“明文模式”、“兼容模式”、“安全模式（推荐）”。选择“兼容模式”和“安全模式（推荐）”前，需在开发者中心填写AES对称加密算法的消息加解密密钥EncodingAESKey。公众号用此密钥对收到的密文消息体进行解密，回复消息体也用此密钥加密。

明文模式：维持现有模式，没有适配加解密新特性，消息体明文收发，默认设置为明文模式。兼容模式：公众平台发送消息内容将同时包括明文和密文，消息包长度增加到原来的3倍左右；公众号回复明文或密文均可，不影响现有消息收发；开发者可在此模式下进行调试。安全模式（推荐）：公众平台发送消息体的内容只含有密文，公众号回复的消息体也为密文，建议开发者在调试成功后使用此模式收发消息。

消息体加解密的实现过程如下。假设本次的开发配置中URL为

http:// www.fangbei.org/index.php

接口程序中需要配置以下3个参数。

/* 方倍工作室 http:// www.cnblogs.com/txw1958/ CopyRight 2014 All Rights Reserved */ define("TOKEN", "weixin"); define("AppID", "wxbad0b45542aa0b5e"); define("EncodingAESKey", "abcdefghijklmnopqrstuvwxyz0123456789ABCDEFG"); require_once('wxBizMsgCrypt.php');

当用户向公众号发送消息时，微信公众号将会在URL中带上signature、timestamp、nonce、encrypt_type、msg_signature等参数，类似如下。

http:// www.fangbei.org/index.php?signature=35703636de2f9df2a77a662b68e521ce17c34d b4×tamp=1414243737&nonce=1792106704&encrypt_type=aes&msg_signature=61479843 31daf7a1a9eed6e0ec3ba69055256154

同时向该接口推送如下XML消息，即一个已加密的消息。

这时程序需要从URL中获得以下参数。这些参数将用于加解密过程。

$timestamp = $_GET['timestamp']; $nonce = $_GET["nonce"]; $msg_signature = $_GET['msg_signature']; $encrypt_type = $_GET['encrypt_type'];

接口程序收到消息后，先进行解密，解密部分代码如下。

$postStr = $GLOBALS["HTTP_RAW_POST_DATA"]; if ($encrypt_type == 'aes'){ $pc = new WXBizMsgCrypt(TOKEN, EncodingAESKey, AppID); $this->logger(" D \r\n".$postStr); $decryptMsg = ""; // 解密后的明文 $errCode = $pc->DecryptMsg($msg_signature, $timestamp, $nonce, $postStr, $decryptMsg); $postStr = $decryptMsg; }

解密完成后，把解密内容又返回给$postStr，这是为了将消息中解密后的内容和明文模式时的消息统一，方便后续处理。解密后的XML如下。

对消息在自己的原有的代码流程中处理，完成之后，一个要回复的文本消息如下。

把上述消息加密，返回给微信公众号，加密过程如下。

// 加密 if ($encrypt_type == 'aes'){ $encryptMsg = ''; // 加密后的密文 $errCode = $pc->encryptMsg($result, $timeStamp, $nonce, $encryptMsg); $result = $encryptMsg; $this->logger(" E \r\n".$result); }

加密后的内容如下。

这样一个安全模式下的加解密消息就完成了。完整的代码如下。

1 <?php 2 /* 3 方倍工作室 http:// www.cnblogs.com/txw1958/ 4 CopyRight 2014 All Rights Reserved 5 */ 6 define("TOKEN", "weixin"); 7 define("AppID", "wxbad0b45542aa0b5e"); 8 define("EncodingAESKey", "abcdefghijklmnopqrstuvwxyz0123456789ABCDEFG"); 9 require_once('wxBizMsgCrypt.php'); 10 11 $wechatObj = new wechatCallbackapiTest(); 12 if (!isset($_GET['echostr'])) { 13 $wechatObj->responseMsg(); 14 }else{ 15 $wechatObj->valid(); 16 } 17 18 class wechatCallbackapiTest 19 { 20 // 验证签名 21 public function valid() 22 { 23 $echoStr = $_GET["echostr"]; 24 $signature = $_GET["signature"]; 25 $timestamp = $_GET["timestamp"]; 26 $nonce = $_GET["nonce"]; 27 $tmpArr = array(TOKEN, $timestamp, $nonce); 28 sort($tmpArr); 29 $tmpStr = implode($tmpArr); 30 $tmpStr = sha1($tmpStr); 31 if($tmpStr == $signature){ 32 echo $echoStr; 33 exit; 34 } 35 } 36 37 // 响应消息 38 public function responseMsg() 39 { 40 $timestamp = $_GET['timestamp']; 41 $nonce = $_GET["nonce"]; 42 $msg_signature = $_GET['msg_signature']; 43 $encrypt_type = (isset($_GET['encrypt_type']) && ($_GET['encrypt_type'] == 'aes')) ? "aes" : "raw"; 44 45 $postStr = $GLOBALS["HTTP_RAW_POST_DATA"]; 46 if (!empty($postStr)){ 47 // 解密 48 if ($encrypt_type == 'aes'){ 49 $pc = new WXBizMsgCrypt(TOKEN, EncodingAESKey, AppID); 50 $this->logger(" D \r\n".$postStr); 51 $decryptMsg = ""; // 解密后的明文 52 $errCode = $pc->DecryptMsg($msg_signature, $timestamp, $nonce, $postStr, $decryptMsg); 53 $postStr = $decryptMsg; 54 } 55 $this->logger(" R \r\n".$postStr); 56 $postObj = simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_ NOCDATA); 57 $RX_TYPE = trim($postObj->MsgType); 58 59 // 消息类型分离 60 switch ($RX_TYPE) 61 { 62 case "event": 63 $result = $this->receiveEvent($postObj); 64 break; 65 case "text": 66 $result = $this->receiveText($postObj); 67 break; 68 } 69 $this->logger(" R \r\n".$result); 70 // 加密 71 if ($encrypt_type == 'aes'){ 72 $encryptMsg = ''; // 加密后的密文 73 $errCode = $pc->encryptMsg($result, $timeStamp, $nonce, $encry ptMsg); 74 $result = $encryptMsg; 75 $this->logger(" E \r\n".$result); 76 } 77 echo $result; 78 }else { 79 echo ""; 80 exit; 81 } 82 } 83 84 // 接收事件消息 85 private function receiveEvent($object) 86 { 87 $content = ""; 88 switch ($object->Event) 89 { 90 case "subscribe": 91 $content = "欢迎关注方倍工作室 "; 92 break; 93 } 94 95 $result = $this->transmitText($object, $content); 96 return $result; 97 } 98 99 // 接收文本消息 100 private function receiveText($object) 101 { 102 $keyword = trim($object->Content); 103 if (strstr($keyword, "文本")){ 104 $content = "这是个文本消息"; 105 }else if (strstr($keyword, "单图文")){ 106 $content = array(); 107 $content[] = array("Title"=>"单图文标题", "Description"=>"单图文内容", "PicUrl"=>"http:// discuz.comli.com/weixin/weather/icon/cartoon.jpg", "Url" =>"http:// m.cnblogs.com/?u=txw1958"); 108 }else if (strstr($keyword, "图文") || strstr($keyword, "多图文")){ 109 $content = array(); 110 $content[] = array("Title"=>"多图文1标题", "Description"=>"", "Pic Url"=>"http:// discuz.comli.com/weixin/weather/icon/cartoon.jpg", "Url" => "http:// m.cnblogs.com/?u=txw1958"); 111 $content[] = array("Title"=>"多图文2标题", "Description"=>"", "Pic Url"=>"http:// d.hiphotos.bdimg.com/wisegame/pic/item/f3529822720e0cf3ac 9f1ada0846f21fbe09aaa3.jpg", "Url" =>"http:// m.cnblogs.com/?u=txw1958"); 112 $content[] = array("Title"=>"多图文3标题", "Description"=>"", "Pic Url"=>"http:// g.hiphotos.bdimg.com/wisegame/pic/item/18cb0a46f21fbe090d33 8acc6a600c338644adfd.jpg", "Url" =>"http:// m.cnblogs.com/?u=txw1958"); 113 }else if (strstr($keyword, "音乐")){ 114 $content = array(); 115 $content = array("Title"=>"最炫民族风", "Description"=>"歌手：凤凰传奇", "MusicUrl"=>"http:// 121.199.4.61/music/zxmzf.mp3", "HQMusicUrl"=> "http:// 121.199.4.61/music/zxmzf.mp3"); 116 }else{ 117 $content = date("Y-m-d H:i:s",time())."\n".$object->FromUserName. "\n技术支持方倍工作室"; 118 } 119 120 if(is_array($content)){ 121 if (isset($content[0])){ 122 $result = $this->transmitNews($object, $content); 123 }else if (isset($content['MusicUrl'])){ 124 $result = $this->transmitMusic($object, $content); 125 } 126 }else{ 127 $result = $this->transmitText($object, $content); 128 } 129 return $result; 130 } 131 132 // 回复文本消息 133 private function transmitText($object, $content) 134 { 135 $xmlTpl = "<xml> 136 <ToUserName><![CDATA[%s]]></ToUserName> 137 <FromUserName><![CDATA[%s]]></FromUserName> 138 <CreateTime>%s</CreateTime> 139 <MsgType><![CDATA[text]]></MsgType> 140 <Content><![CDATA[%s]]></Content> 141 </xml>"; 142 $result = sprintf($xmlTpl, $object->FromUserName, $object->ToUserName, time(), $content); 143 return $result; 144 } 145 146 // 回复图文消息 147 private function transmitNews($object, $newsArray) 148 { 149 if(!is_array($newsArray)){ 150 return; 151 } 152 $itemTpl = "<item> 153 <Title><![CDATA[%s]]></Title> 154 <Description><![CDATA[%s]]></Description> 155 <PicUrl><![CDATA[%s]]></PicUrl> 156 <Url><![CDATA[%s]]></Url> 157 </item>"; 158 159 $item_str = ""; 160 foreach ($newsArray as $item){ 161 $item_str .= sprintf($itemTpl, $item['Title'], $item['Description'], $item['PicUrl'], $item['Url']); 162 } 163 $xmlTpl = "<xml> 164 <ToUserName><![CDATA[%s]]></ToUserName> 165 <FromUserName><![CDATA[%s]]></FromUserName> 166 <CreateTime>%s</CreateTime> 167 <MsgType><![CDATA[news]]></MsgType> 168 <ArticleCount>%s</ArticleCount> 169 <Articles> 170 $item_str </Articles> 171 </xml>"; 172 173 $result = sprintf($xmlTpl, $object->FromUserName, $object->ToUserName, time(), count($newsArray)); 174 return $result; 175 } 176 177 // 回复音乐消息 178 private function transmitMusic($object, $musicArray) 179 { 180 $itemTpl = "<Music> 181 <Title><![CDATA[%s]]></Title> 182 <Description><![CDATA[%s]]></Description> 183 <MusicUrl><![CDATA[%s]]></MusicUrl> 184 <HQMusicUrl><![CDATA[%s]]></HQMusicUrl> 185 </Music>"; 186 187 $item_str = sprintf($itemTpl, $musicArray['Title'], $musicArray['Des cription'], $musicArray['MusicUrl'], $musicArray['HQMusicUrl']); 188 189 $xmlTpl = "<xml> 190 <ToUserName><![CDATA[%s]]></ToUserName> 191 <FromUserName><![CDATA[%s]]></FromUserName> 192 <CreateTime>%s</CreateTime> 193 <MsgType><![CDATA[music]]></MsgType> 194 $item_str 195 </xml>"; 196 197 $result = sprintf($xmlTpl, $object->FromUserName, $object->ToUserName, time()); 198 return $result; 199 } 200 201 // 日志记录 202 public function logger($log_content) 203 { 204 if(isset($_SERVER['HTTP_APPNAME'])){ // SAE 205 sae_set_display_errors(false); 206 sae_debug($log_content); 207 sae_set_display_errors(true); 208 }else if($_SERVER['REMOTE_ADDR'] != "127.0.0.1"){ // LOCAL 209 $max_size = 500000; 210 $log_filename = "log.xml"; 211 if(file_exists($log_filename) and (abs(filesize($log_filename)) > $max_ size)){unlink($log_filename);} 212 file_put_contents($log_filename, date('Y-m-d H:i:s').$log_content."\r \n", FILE_APPEND); 213 } 214 } 215 } 216 ?> 相关资源：微信公众号第三方代授权API范例（PHP）

最新回复(0)

《微信公众平台开发：从零基础到ThinkPHP5高性能框架实践》——3.3 微信开发者中心...

3.3 微信开发者中心

3.3.1 配置和启用服务器

3.3.2 配置失败常见问题与分析

3.3.3 自动回复当前时间

3.3.4 消息交互原理分析

3.3.5 消息体加/解密实现