php微信开发自定义菜单

更新时间：2020-03-11 12:56:06 作者：startmvc

目前微信服务号自定义菜单最多包括3个一级菜单，每个一级菜单最多包含5个二级菜单。一

目前微信服务号自定义菜单最多包括3个一级菜单，每个一级菜单最多包含5个二级菜单。一级菜单最多4个汉字，二级菜单最多7个汉字，多出来的部分将会以“...”代替。请注意，创建自定义菜单后，由于微信客户端缓存，需要24小时微信客户端才会展现出来。建议测试时可以尝试取消关注公众账号后再次关注，则可以看到创建后的效果。

目前自定义菜单接口可实现两种类型按钮，如下： click： 用户点击click类型按钮后，微信服务器会通过消息接口推送消息类型为event 的结构给开发者（参考消息接口指南），并且带上按钮中开发者填写的key值，开发者可以通过自定义的key值与用户进行交互； view： 用户点击view类型按钮后，微信客户端将会打开开发者在按钮中填写的url值（即网页链接），达到打开网页的目的，建议与网页授权获取用户基本信息接口结合，获得用户的登入个人信息。

接口调用请求说明 http请求方式：POST（请使用https协议） https://api.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN 请求示例（JSON数据请使用UTF-8编码）


 {
 "button":[
 {"type":"click","name":"我的信息","sub_button":[
 {"type":"click","name":"拇指查询","key":"BUTTON_1"},
 {"type":"click","name":"拇指请假","key":"BUTTON_2"},
 {"type":"view","name":"工号绑定","url":"http://XXXXXXXXXXXXXXXXX"}]
 },
 {"type":"click","name":"业务流程","key":"BUTTON_3"},
 {"name":"员工建议","sub_button":[
 {"type":"view","name":"思想火花","url":"http://XXXXXXXXXXXXXXXXXX"},
 {"type":"view","name":"奖品兑换","url":"http://XXXXXXXXXXXXXXXXXX"},
 {"type":"click","name":"赞一下我们","key":"BUTTON_ZAN"}]
 }
 ]
}

参数说明

返回结果正确时的返回JSON数据包如下： {"errcode":0,"errmsg":"ok"} 错误时的返回JSON数据包如下（示例为无效菜单名长度）： {"errcode":40018,"errmsg":"invalid button name size"}

以下是示例代码（PHP）。


 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="zh-CN">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
 <meta name="author" content="Chris Mao" />
 </head>
 <body>
 <?php
 $url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET";

 $ch = curl_init($url);
 curl_setopt($ch, CURLOPT_HEADER, 0);
 curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
 curl_setopt($ch, CURLOPT_POST, 0);
 curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);
 curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);

 $output = curl_exec($ch);
 curl_close($ch);
 if (empty($output)) { var_dump($output); exit; }
 $result = json_decode($output);
 $token = $result->access_token;
 
 //创建菜单
 $url = "https://api.weixin.qq.com/cgi-bin/menu/create?access_token=$token";
 $jsonData = file_get_contents("menu.json");
 $ch = curl_init($url);
 curl_setopt($ch, CURLOPT_HEADER, 0);
 curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
 curl_setopt($ch, CURLOPT_POST, 1);
 curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonData);
 curl_setopt($ch, CURLOPT_USERAGENT, $_SERVER['HTTP_USER_AGENT']);
 curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);
 curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
 $output = curl_exec($ch);
 curl_close($ch); 
 var_dump($output);
 ?>
 </body>
</html>

menu.json


{
 "button":[
 {"type":"click","name":"我的信息","sub_button":[
 {"type":"click","name":"拇指查询","key":"BUTTON_1"},
 {"type":"click","name":"拇指请假","key":"BUTTON_2"},
 {"type":"view","name":"工号绑定","url":"http://XXXXXXXXXXXXXXXXX"}]
 },
 {"type":"click","name":"业务流程","key":"BUTTON_3"},
 {"name":"员工建议","sub_button":[
 {"type":"view","name":"思想火花","url":"http://XXXXXXXXXXXXXXXXXX"},
 {"type":"view","name":"奖品兑换","url":"http://XXXXXXXXXXXXXXXXXX"},
 {"type":"click","name":"赞一下我们","key":"BUTTON_ZAN"}]
 }
 ]
}

响应自定义菜单事件


 $wechatObj = new wechatCallbackAPI();
 if (isset($_GET["echostr"])) { 
 $wechatObj->valid(); 
 } else { 
 $wechatObj->responseMsg();
 }


 class wechatCallbackAPI {

 private $token = "WEIXIN";

 private $appId = "APPID";

 private $appSecret = "APPSECRET";
 
 private function checkSignature() {
 $signature = $_GET["signature"];
 $timestamp = $_GET["timestamp"];
 $nonce = $_GET["nonce"]; 
 
 $tmpArr = array($this->token, $timestamp, $nonce);
 sort($tmpArr);
 $tmpStr = implode($tmpArr);
 $tmpStr = sha1($tmpStr);
 
 if($tmpStr == $signature) {
 return true;
 } else {
 return false;
 }
 }

 private function getAccessToken() {
 $url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=$this->appId&secret=$this->appSecret";

 $ch = curl_init($url);
 $curl_setopt($ch, CURLOPT_HEADER, 0);
 $curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
 $curl_setopt($ch, CURLOPT_POST, 0);
 $curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);
 $curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);

 $output = curl_exec($ch);
 curl_close($ch);
 if (empty($output)) { return ""; }

 $result = json_decode($result);
 return $result->access_token;
 }

 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"];
 if (empty($postStr)){
 echo "";
 exit;
 }

 //extract post data
 $postObj = simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_NOCDATA);
 $fromUsername = $postObj->FromUserName;
 $toUsername = $postObj->ToUserName;
 $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>";
 
 switch (strtolower(trim($postObj->MsgType))) {
 case "text": //文本消息
 $keyword = trim($postObj->Content);
 if(!empty($keyword)) {
 $msgType = "text";
 $contentStr = "$fromUsername, 您发送了文本信息: $keyword ";
 if (strtolower($keyword) == "time") {
 $contentStr = date("Y-m-d H:i:s", $time);
 }
 $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr);
 } else {
 $resultStr = "Input something...";
 }
 break;
 case "image": //图片消息
 $msgType = "text";
 $contentStr = "$fromUsername, 您发送了图片信息";
 $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr);
 break;
 case "voice": //声音消息
 $msgType = "text";
 $contentStr = "$fromUsername, 您发送了声音信息";
 $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr);
 break;
 case "video": //视频消息
 $msgType = "text";
 $contentStr = "$fromUsername, 您发送了视频信息";
 $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr);
 break;
 case "location": //位置消息
 $msgType = "text";
 $contentStr = "$fromUsername, 您发送了位置信息";
 $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr);
 break;
 case "link": //链接消息
 $msgType = "text";
 $contentStr = "$fromUsername, 您发送了链接信息";
 $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr);
 break;
 case "event": //事件
 switch (strtolower(trim($postObj->Event))) {
 case "subscribe": //关注事件
 $msgType = "text";
 $contentStr = "欢迎您关注XXXXXXX";
 $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr);
 break;
 case "unsubscribe": //取消关注事件
 break;
 case "scan": //用户已关注时扫描二维码事件
 $msgType = "text";
 $contentStr = "$fromUsername, 您扫描了二维码";
 $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr);
 break;
 case "location": //上传地理位置事件
 $msgType = "text";
 $contentStr = "$fromUsername, 您上传地理位置";
 $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr);
 break;
 case "click": //自定义菜单事件
 $msgType = "text";
 $contentStr = "$fromUsername, 您点击了自定义菜单 $postObj->EventKey ";
 if ("BUTTON_ZAN" == $postObj->EventKey) {
 $contentStr = "感谢您的赞，我们会继续提供更优质的服务。";
 }
 $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr);
 ;
 break;
 default:
 $resultStr = "";
 }
 break;
 default:
 $resultStr = "";
 }
 echo $resultStr;
 }
 }
?>

自定义菜单查询

使用接口创建自定义菜单后，开发者还可使用接口查询自定义菜单的结构。

请求说明 http请求方式：GET https://api.weixin.qq.com/cgi-bin/menu/get?access_token=ACCESS_TOKEN

返回说明对应创建接口，正确的Json返回结果:

{"menu":{"button":[{"name":"我的信息","sub_button":[{"type":"click","name":"拇指查询","key":"BUTTON_1","sub_button":[]},{"type":"click","name":"拇指请假","key":"BUTTON_2","sub_button":[]},{"type":"view","name":"工号绑定","url":"http:\/\/XXXXXXXX","sub_button":[]}]},{"type":"click","name":"业务流程","key":"BUTTON_3","sub_button":[]},{"name":"员工建议","sub_button":[{"type":"view","name":"思想火花","url":"http:\/\/XXXXXXXX","sub_button":[]},{"type":"view","name":"奖品兑换","url":"http:\/\/XXXXXXXX","sub_button":[]},{"type":"click","name":"赞一下我们","key":"BUTTON_ZAN","sub_button":[]}]}]}}

自定义菜单删除

使用接口创建自定义菜单后，开发者还可使用接口删除当前使用的自定义菜单。

请求说明 http请求方式：GET https://api.weixin.qq.com/cgi-bin/menu/delete?access_token=ACCESS_TOKEN

返回说明 对应创建接口，正确的Json返回结果: {"errcode":0,"errmsg":"ok"}

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持脚本之家。