PHP开发者必看！手把手教你微信公众号对接

还在为微信公众号对接发愁？PHP开发者看过来！本文手把手教你搞定微信公众号对接，让你的PHP代码与微信服务器无缝“聊”起来。核心步骤包括：**服务器地址验证**，开发者需准备备案域名、PHP服务器、AppID、AppSecret和自定义Token，通过SHA1加密验证请求的有效性；**消息接收与响应**，解析POST的XML数据，根据关键词构建回复消息；**OpenID获取**，可通过用户消息或网页授权流程获取；**自定义菜单实现**，获取access_token后构造JSON菜单数据，调用微信接口创建。同时，文章还总结了常见的签名错误原因及解决方案，助你轻松排查问题，快速上手微信公众号开发。

公众号对接核心在于验证服务器地址有效性并处理消息响应。1.准备备案域名、PHP服务器、AppID、AppSecret及自定义Token；2.验证服务器地址时，微信发送GET请求，开发者需用token、timestamp、nonce排序后SHA1加密并与signature对比，成功则返回echostr；3.接收消息时解析POST的XML数据，构建回复消息格式并根据关键词响应；4.获取OpenID可通过用户消息中的FromUserName或网页授权流程获取；5.实现自定义菜单需先获取access_token，构造JSON菜单数据，再调用微信接口创建菜单；6.签名错误常见原因包括Token不一致、参数排序错误、字符串排序方式不对、URL不可达等，可逐一排查解决。

公众号对接，说白了，就是让你的PHP代码能跟微信服务器“聊”起来。核心在于验证服务器地址的有效性，然后根据用户发送的消息，做出相应的响应。

解决方案

1. 准备工作：

   
   • 一个备案过的域名（微信要求）。
   • 一个能跑PHP代码的服务器（废话，但还是要说）。
   • 微信公众号的开发者ID（AppID）和开发者密码（AppSecret），在公众号后台可以找到。
   • Token，自己随便设置一个，但要记住，后面要用到。

2. 验证服务器地址的有效性：

   

   这是第一步，也是最重要的一步。微信服务器会向你填写的URL发送一个GET请求，你需要按照微信的要求，返回一个特定的字符串。

   • Token： YOUR_TOKEN 替换成你在公众号后台设置的Token。
   • 排序： sort($tmpArr, SORT_STRING) 这里要注意，要按照字符串排序，否则可能验证失败。
   • SHA1加密： sha1($tmpStr) 使用SHA1算法加密。
   • 验证： $tmpStr == $signature 比较加密后的字符串和微信发送过来的signature。
   • 返回echostr： 验证成功，直接echo $echostr，然后exit，结束脚本。

   把这段代码放到你的服务器上，比如wechat.php，然后在公众号后台的“基本配置”中，填写你的URL（比如https://yourdomain.com/wechat.php），Token填写你设置的Token，点击提交。如果验证成功，微信会提示你配置成功。

3. 接收和回复消息：

   验证服务器地址成功后，微信服务器就会把用户发送的消息推送到你的URL。你需要解析这些消息，然后根据消息类型，做出相应的回复。

   FromUserName;
           $toUsername = $postObj->ToUserName;
           $keyword = trim($postObj->Content);
           $time = time();
           $textTpl = "
                          
                          
                          %s
                          
                          
                          0
                          ";
   
           // 根据关键词回复消息
           if(!empty( $keyword )) {
               $contentStr = "你发送的消息是：".$keyword;
               $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $contentStr);
               echo $resultStr;
           }else{
               echo "Input something...";
           }
   
       }else {
           echo "";
           exit;
       }
   } else {
       echo "";
       exit;
   }
   ?>

   • 获取POST数据： $postStr = $GLOBALS["HTTP_RAW_POST_DATA"]; 微信服务器发送的消息是XML格式的，需要获取POST数据。
   • 解析XML数据： simplexml_load_string() 使用这个函数解析XML数据。
   • 获取消息内容： $postObj->Content 获取用户发送的消息内容。
   • 回复消息： 构建XML格式的回复消息，然后echo出去。
   • ： XML中需要使用这个包裹文本内容，防止被XML解析器错误解析。

如何获取用户openid？

OpenID是微信用户在公众号内的唯一标识。获取OpenID的方法主要有两种：

1. 被动回复消息： 在接收到用户消息的时候，$postObj->FromUserName 就是用户的OpenID。 这是最简单直接的方法，但前提是用户必须主动给你的公众号发送消息。

2. 通过网页授权获取： 这种方法可以让用户在网页上授权，然后获取用户的OpenID。 这种方法比较复杂，需要用到微信的OAuth2.0授权机制。 简单来说，你需要：

   • 构造一个授权链接，让用户点击。
   • 用户点击授权链接后，会跳转到微信的授权页面。
   • 用户授权后，微信会跳转到你设置的回调地址，并携带code参数。
   • 使用code参数，调用微信的接口，获取access_token和openid。

   具体步骤可以参考微信官方文档，搜索“网页授权获取用户基本信息”。

如何实现自定义菜单？

自定义菜单可以让用户更方便地使用公众号的功能。实现自定义菜单的步骤如下：

1. 获取access_token： 调用微信的接口，获取access_token。 access_token是调用微信接口的凭证，有效期为2小时，需要定期刷新。

2. 构造菜单数据： 按照微信的要求，构造JSON格式的菜单数据。

   {
       "button":[
       {
           "type":"click",
           "name":"今日歌曲",
           "key":"V1001_TODAY_MUSIC"
       },
       {
           "name":"菜单",
           "sub_button":[
           {
               "type":"view",
               "name":"搜索",
               "url":"http://www.soso.com/"
           },
           {
               "type":"miniprogram",
               "name":"wxa",
               "url":"http://mp.weixin.qq.com",
               "appid":"wx286b93c14b3xxxx",
               "pagepath":"pages/lunar/index"
           },
           {
               "type":"click",
               "name":"赞一下我们",
               "key":"V1001_GOOD"
           }]
       }]
   }

   • type： 菜单类型，常用的有click（点击事件）、view（跳转URL）、miniprogram（跳转小程序）。
   • name： 菜单名称。
   • key： click类型菜单的key值，用于在接收消息的时候区分不同的菜单。
   • url： view类型菜单的URL。
   • appid： miniprogram类型菜单的小程序appid。
   • pagepath： miniprogram类型菜单的小程序页面路径。

3. 调用接口创建菜单： 调用微信的接口，创建自定义菜单。

   • YOUR_ACCESS_TOKEN： 替换成你获取的access_token。
   • $data： 替换成你构造的JSON格式的菜单数据。
   • Content-Type: application/json： 设置请求头，告诉微信服务器发送的是JSON数据。

遇到签名错误怎么办？

签名错误是微信公众号开发中常见的问题。通常是因为以下原因：

1. Token错误： 检查你代码中的Token和公众号后台设置的Token是否一致。
2. 参数顺序错误： 确保按照token、timestamp、nonce的顺序排序。
3. 字符串排序错误： 使用sort($tmpArr, SORT_STRING)进行字符串排序。
4. 缓存问题： 有时候微信服务器会有缓存，导致签名验证失败。可以尝试清除微信服务器的缓存，或者等待一段时间再试。
5. URL错误： 确保你填写的URL可以正常访问，并且能够正确处理微信服务器发送的GET请求。可以使用在线工具测试URL是否可用。

如果以上方法都不能解决问题，可以尝试打印出微信发送过来的参数和你的计算结果，进行对比，找出错误的原因。 另外，仔细检查你的代码，确保没有语法错误或者逻辑错误。

今天关于《PHP开发者必看！手把手教你微信公众号对接》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！