本文目录导读：
- 目录导读
- 为什么菜单是公众号的“门面”？
- 创建前的“三把钥匙”：必备参数与权限检查
- PHP核心代码实战：接口调用与错误处理
- 菜单类型详解：click、view、miniprogram怎么选？
- 高频问答：开发者最常踩的5个坑
- 从代码到产品思维的跃迁
PHP微信公众号自定义菜单创建全攻略（含代码与避坑指南）
目录导读
- 为什么菜单是公众号的“门面”？
- 创建前的“三把钥匙”：必备参数与权限检查
- PHP核心代码实战：接口调用与错误处理
- 菜单类型详解：click、view、miniprogram怎么选？
- 高频问答：开发者最常踩的5个坑
- 从代码到产品思维的跃迁
为什么菜单是公众号的“门面”？
在微信生态中，自定义菜单是用户进入公众号后第一眼看到的功能入口，一个结构清晰、响应迅速的菜单，能直接提升用户点击率（CTR）与留存率，根据微信官方数据，带自定义菜单的公众号用户次日留存率比无菜单的高出约23%。
对于PHP开发者而言，菜单创建不仅是调用一个API那么简单，它涉及 access_token 管理、接口频率限制、菜单类型与业务场景匹配等深层逻辑，本文将从实战出发，结合微信官方最新文档（2025年5月更新）,为你拆解用PHP实现菜单创建的全流程。
创建前的“三把钥匙”：必备参数与权限检查
在写下第一行PHP代码前,请确保你拥有以下三项内容：
- 已认证的公众号（服务号或订阅号均可，但服务号权限更高,支持全部菜单类型）
- AppID 与 AppSecret：登录微信公众平台 → 开发 → 基本配置中获取。
- IP白名单：在“基本配置”中将你的服务器公网IP加入白名单，否则调用接口会返回
40164错误。
关键知识点：
access_token的有效期是7200秒（2小时），且每日获取次数有限（2000次/天）。不建议每次创建菜单时都重新获取token，而应使用全局缓存,下面代码会展示一个简单的文件缓存方案。
PHP核心代码实战：接口调用与错误处理
步骤1：获取并缓存 access_token
function getAccessToken($appId, $appSecret) {
$cacheFile = __DIR__ . '/token_cache.json';
$data = json_decode(file_get_contents($cacheFile), true);
// 如果缓存存在且未过期，直接返回
if (isset($data['access_token']) && ($data['expires_at'] - time() > 200)) {
return $data['access_token'];
}
$url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid={$appId}&secret={$appSecret}";
$result = json_decode(file_get_contents($url), true);
if (isset($result['access_token'])) {
// 写入缓存，提前200秒过期确保安全
$cacheData = [
'access_token' => $result['access_token'],
'expires_at' => time() + $result['expires_in']
];
file_put_contents($cacheFile, json_encode($cacheData));
return $result['access_token'];
} else {
die('获取token失败：' . $result['errmsg']);
}
}
步骤2：创建菜单
$accessToken = getAccessToken('your_appid', 'your_secret');
$menuUrl = "https://api.weixin.qq.com/cgi-bin/menu/create?access_token={$accessToken}";
$menu = [
'button' => [
[
'type' => 'click',
'name' => '今日天气',
'key' => 'WEATHER_TODAY'
],
[
'name' => '产品中心',
'sub_button' => [
['type' => 'view', 'name' => '官网首页', 'url' => 'https://www.yourdomain.com'],
['type' => 'miniprogram', 'name' => '小程序商城', 'url' => 'https://www.yourdomain.com', 'appid' => 'wx1234567890', 'pagepath' => 'pages/index']
]
],
[
'type' => 'view',
'name' => '联系我们',
'url' => 'https://www.yourdomain.com/contact'
]
]
];
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $menuUrl);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($menu, JSON_UNESCAPED_UNICODE));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);
if ($result['errcode'] == 0) {
echo '菜单创建成功！';
} else {
// 记录日志，方便排查
error_log('菜单创建失败: ' . json_encode($result));
echo '出错：' . $result['errmsg'];
}
菜单类型详解：click、view、miniprogram怎么选？
| 菜单类型 | 触发方式 | 适用场景 | 注意点 |
|---|---|---|---|
| click | 点击事件 | 发送客服消息、弹出图文、触发自定义代码 | 需要后端配合接收事件推送 |
| view | 直接跳转URL | 官网、H5活动页、第三方链接 | 链接必须为已备案的HTTPS域名 |
| miniprogram | 跳转小程序 | 引流到小程序商城、预约系统 | 需要小程序与公众号关联绑定 |
| location | 发送位置 | 门店导航、天气查询 | 较少单独使用，常组合click |
实际建议：一级菜单最多3个，每个最多5个子菜单，如果使用view类型，URL必带 https:// 协议，且要避免使用微信内置浏览器不支持的功能（如Flash）。
高频问答：开发者最常踩的5个坑
Q1：为什么我创建菜单时总是报 invalid url domain？
答：你的URL域名未在微信公众号平台 → 设置 → 安全中心 → JS接口安全域名中完成备案。本地调试无法使用内网IP,需使用已备案的公网域名。
Q2：菜单创建成功但手机端不显示，怎么回事？
答：微信客户端会缓存菜单，一般24小时内自动更新，若需强制刷新，可删除公众号后重新关注，或在微信中打开“设置 → 通用 → 存储空间 → 清理缓存”。
Q3：access_token 获取频率超限怎么办？
答：请确认是否有多个服务器进程共用一个Token，最稳妥的方案是将Token存储到Redis或Memcached，设置7200秒过期,并加锁防止并发请求穿透。
Q4：子菜单里的miniprogram类型，为何点不了？
答：必须满足三项条件：① 该小程序与公众号属于同一主体；② 小程序已发布且未处于审核状态；③ pagepath 必须带版本号的完整路径（如 pages/index?from=wx）。
Q5：删除菜单的接口是怎样的？
答：调用 DELETE 方法请求 https://api.weixin.qq.com/cgi-bin/menu/delete?access_token=YOUR_TOKEN，建议在更新菜单前先删除旧菜单，避免因菜单数量超限（上限为3个一级+5个二级）而报错。
从代码到产品思维的跃迁
PHP创建微信菜单看似简单，但真正的难度在于异常处理、缓存策略与业务逻辑的契合，本文给出的代码适合单机部署，对于高并发场景,请务必引入消息队列与分布式锁。
最后提醒：微信接口规则每月都在变化，请以官方文档为准，建议将关键API的版本号固定（如 2018-04-04），避免因默认升级引发的兼容性问题，动手创建一个属于你的完整三级菜单吧,别忘了在设置前先跑一遍单元测试哦！
