微信自定义菜单是公众号与用户交互的核心入口之一，它能够将丰富的功能和服务以直观、便捷的方式呈现给用户，极大提升用户体验和运营效率，通过PHP进行微信自定义菜单的开发，是实现公众号自动化、服务化管理的关键技术环节，本文将系统性地介绍其核心概念、开发步骤及注意事项。
核心概念解析
在着手编码之前,理解几个核心概念是至关重要的。
Access Token（访问令牌）
Access Token是公众号的全局唯一接口调用凭据，所有自定义菜单的创建、查询、删除等操作，都必须携带此令牌，它由AppID和AppSecret生成，有效期为2小时（7200秒），由于获取次数有限（每日2000次），在实际开发中必须进行全局缓存,避免每次调用接口都重新获取。
菜单结构
微信自定义菜单采用层级结构,具体规则如下：
- 一级菜单：最多3个。
- 二级菜单：每个一级菜单下最多5个。
- 当一级菜单下有二级菜单时，该一级菜单本身不能被点击,仅作为父级容器。
下表清晰地展示了菜单的层级与数量限制：
| 菜单级别 | 最大数量 | 说明 |
|---|---|---|
| 一级菜单 | 3个 | 公众号底部的直接入口 |
| 二级菜单 | 5个/每个一级菜单 | 点击一级菜单后展开的子菜单 |
菜单类型
每个菜单按钮都对应一种特定的交互类型，开发者可以根据业务需求灵活选择,常见的类型包括：
| 类型 | 标识 | 描述 |
|---|---|---|
| 点击推事件 | click |
用户点击后，公众号会收到事件推送，可由后台代码处理 |
| 跳转URL | view |
用户点击后，直接跳转到指定的URL地址 |
| 扫码推事件 | scancode_push |
用户点击后，微信客户端将调起扫一扫工具，扫码后显示结果 |
| 发送图片 | pic_photo_or_album |
用户点击后，弹出选择器，用户可从相册或拍照发送图片 |
| 地理位置 | location_select |
用户点击后，弹出地理位置选择器，发送位置 |
click和view是最为常用的两种类型，前者用于触发后台逻辑,后者用于引导用户访问网页。
PHP开发实战步骤
下面我们将通过PHP代码,一步步实现自定义菜单的创建。
第一步：获取Access Token
我们需要一个函数来获取并缓存Access Token,这里以文件缓存为例。
function getAccessToken($appid, $appsecret) {
$token_file = './access_token.json';
$data = json_decode(file_get_contents($token_file));
if ($data->expire_time < time()) {
// Token已过期，重新获取
$url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid={$appid}&secret={$appsecret}";
$res = json_decode(file_get_contents($url));
if ($res->access_token) {
$new_data = [
'expire_time' => time() + 7000, // 提前200秒过期，防止临界点
'access_token' => $res->access_token
];
file_put_contents($token_file, json_encode($new_data));
return $res->access_token;
} else {
return false;
}
} else {
// Token未过期，直接返回
return $data->access_token;
}
}
第二步：构建菜单数据结构
创建一个PHP数组来定义你想要的菜单样式,这个数组最终会被转换为JSON格式。
// 你的AppID和AppSecret
$appid = 'your_appid';
$appsecret = 'your_appsecret';
$access_token = getAccessToken($appid, $appsecret);
if ($access_token) {
// 构建菜单数据
$menu_data = [
'button' => [
[
'type' => 'click',
'name' => '今日歌曲',
'key' => 'V1001_TODAY_MUSIC'
],
[
'name' => '菜单',
'sub_button' => [
[
'type' => 'view',
'name' => '搜索',
'url' => 'http://www.soso.com/'
],
[
'type' => 'view',
'name' => '视频',
'url' => 'http://v.qq.com/'
],
]
]
]
];
$json_menu_data = json_encode($menu_data, JSON_UNESCAPED_UNICODE);
}
第三步：调用API创建菜单
使用获取到的access_token和构建好的JSON数据,向微信服务器发送POST请求以创建菜单。
function createMenu($access_token, $json_data) {
$url = "https://api.weixin.qq.com/cgi-bin/menu/create?access_token={$access_token}";
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $json_data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
$result = curl_exec($ch);
curl_close($ch);
return $result;
}
// 调用创建函数
$result = createMenu($access_token, $json_menu_data);
echo $result; // 输出创建结果，如 {"errcode":0,"errmsg":"ok"}
菜单的查询与删除
- 查询菜单：通过向
https://api.weixin.qq.com/cgi-bin/menu/get?access_token=ACCESS_TOKEN发送GET请求,可以获取当前已设置的自定义菜单。 - 删除菜单：通过向
https://api.weixin.qq.com/cgi-bin/menu/delete?access_token=ACCESS_TOKEN发送GET请求，可以删除所有自定义菜单,这在调试或重新发布菜单时非常有用。
开发注意事项
- JSON编码：在构建菜单数据时，使用
json_encode($menu_data, JSON_UNESCAPED_UNICODE)可以确保中文字符不会被转义,避免在微信端显示乱码。 - 服务器响应：对于
click类型的菜单，用户点击后，微信服务器会向你的服务器URL推送一个XML格式的POST请求，你的PHP后台需要解析此XML，根据EventKey的值执行不同的业务逻辑并回复用户。 - 客户端缓存：菜单创建成功后，微信客户端会缓存菜单，如果用户未重新关注公众号或未在24小时内与公众号互动，菜单更新可能不会立即生效,取消关注再重新关注即可看到最新菜单。
相关问答FAQs
Q1：为什么我的菜单通过PHP创建成功了（返回{"errcode":0,"errmsg":"ok"}），但在手机上却看不到？
A1：这是一个常见现象，主要由微信客户端的缓存机制导致,请尝试以下几种方法：
- 取消关注再重新关注：这是最直接有效的方法,会强制刷新客户端缓存。
- 等待一段时间：微信服务器会向所有活跃用户推送更新,这个过程可能需要几分钟到半小时不等。
- 清除微信缓存：在微信的设置中找到“通用”->“存储空间”,然后清理缓存。
Q2：Access Token的有效期是多久，我应该如何高效地管理它？
A2：Access Token的有效期为7200秒（2小时），由于获取它的API调用次数非常有限（每日2000次），频繁请求会导致接口被禁用，强烈建议在服务器端进行全局缓存,最佳实践是：
- 首次获取时，将Token和过期时间（当前时间戳 + 7000秒，留出200秒余量）存入缓存系统（如Redis、Memcached）或文件中。
- 每次需要使用Token时,先检查缓存中的Token是否过期。
- 如果未过期,直接使用缓存的Token。
- 如果已过期，再重新调用API获取新的Token，并更新缓存,这样可以确保在有效期内几乎不消耗API调用次数。
图片来源于AI模型，如侵权请联系管理员。作者：酷小编，如若转载，请注明出处：https://www.kufanyun.com/ask/20127.html
