微信利用PHP创建自定义菜单的方法

PHP 1950 0 2014-02-18

在使用通用接口前，你需要做以下两步工作：
1.拥有一个微信公众账号，并获取到appid和appsecret（在公众平台申请内测资格，审核通过后可获得）
2.通过获取凭证接口获取到access_token
注意：
access_token是第三方访问api资源的票据；
access_token对应于公众号是全局唯一的票据，重复获取将导致上次获取的access_token失效。

访问下面这个地址（注意替换你的appid和secret）：

https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET

然后在浏览器能看到一下返回信息：

{"access_token":"这里就是你的access_token","expires_in":7200}

创建自定义菜单：

[代码]php代码：

01 <?php
02 header("Content-type: text/html; charset=utf-8");
03 define("ACCESS_TOKEN", "这里填入你上面获取到的access_token");
04
05
06 //创建菜单
07 function createMenu($data){
08 $ch = curl_init();
09 curl_setopt($ch, CURLOPT_URL, "https://api.weixin.qq.com/cgi-bin/menu/create?access_token=".ACCESS_TOKEN);
10 curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
11 curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
12 curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);
13 curl_setopt($ch, CURLOPT_USERAGENT, 'Mozilla/5.0 (compatible; MSIE 5.01; Windows NT 5.0)');
14 curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 1);
15 curl_setopt($ch, CURLOPT_AUTOREFERER, 1);
16 curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
17 curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
18 $tmpInfo = curl_exec($ch);
19 if (curl_errno($ch)) {
20   return curl_error($ch);
21 }
22
23 curl_close($ch);
24 return $tmpInfo;
25
26 }
27
28 //获取菜单
29 function getMenu(){
30 return file_get_contents("https://api.weixin.qq.com/cgi-bin/menu/get?access_token=".ACCESS_TOKEN);
31 }
32
33 //删除菜单
34 function deleteMenu(){
35 return file_get_contents("https://api.weixin.qq.com/cgi-bin/menu/delete?access_token=".ACCESS_TOKEN);
36 }
37
38
39
40
41
42 $data = '{
43      "button":[
44      {
45           "type":"click",
46           "name":"首页",
47           "key":"home"
48       },
49       {
50            "type":"click",
51            "name":"简介",
52            "key":"introduct"
53       },
54       {
55            "name":"菜单",
56            "sub_button":[
57             {
58                "type":"click",
59                "name":"hello word",
60                "key":"V1001_HELLO_WORLD"
61             },
62             {
63                "type":"click",
64                "name":"赞一下我们",
65                "key":"V1001_GOOD"
66             }]
67        }]
68 }';
69
70
71
72
73 echo createMenu($data);
74 //echo getMenu();
75 //echo deleteMenu();

上一篇：php运行出现Call to undefined function curl_init()的解决方法

下一篇：php中验证一个字符串中是否存在某个字符串

讨论数量：1

天涯网魂 3 杠 5 星2014-02-18 15:01:14

一、简介

微信公众平台服务号以及之前成功申请内测资格的订阅号都具有自定义菜单的功能。开发者可利用该功能为公众账号的会话界面底部增加自定义菜单，用户点击菜单中的选项，可以调出相应的回复信息或网页链接。自定义菜单接口将为公众账号的信息展示空间提供更多可能性。本文将针对自定义菜单做简单的开发应用，以供读者参考。

二、官方说明

开发者获取使用凭证后，可以使用该凭证对公众账号的自定义菜单进行创建、查询和删除等操作。自定义菜单接口可实现以下类型按钮：

click（点击事件）：

用户点击click类型按钮后，微信服务器会通过消息接口(event类型)推送点击事件给开发者，并且带上按钮中开发者填写的key值，开发者可以通过自定义的key值进行消息回复。

view（访问网页）：

用户点击view类型按钮后，会直接跳转到开发者指定的url中。

创建自定义菜单后，由于微信客户端缓存，需要24小时微信客户端才会展现出来。建议测试时可以尝试取消关注公众账号后，再次关注，则可以看到创建后的效果。

文档地址：http://mp.weixin.qq.com/wiki/index.php?title=%E8%87%AA%E5%AE%9A%E4%B9%89%E8%8F%9C%E5%8D%95%E6%8E%A5%E5%8F%A3

三、获取使用凭证

3.1 获取appid 和appsecret

在微信公众平台 > 高级功能 > 开发模式中找到appid 和appsecret。

3.2 使用appid 和appsecret 向微信凭证获取接口请求access_token

请求地址：https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET

请求参数说明：

grant_type：获取access_token填写client_credential

appid：第三方用户唯一凭证

secret：第三方用户唯一凭证密钥，既appsecret

返回说明：

正确的Json返回结果:

{"access_token":"ACCESS_TOKEN","expires_in":7200}

返回参数说明：

access_token：获取到的凭证

expires_in：凭证有效时间，单位：秒

3.3 具体实现

a. 打印出格式

<?php$APPID="wxdxxxxxxxxxxxxxxx";$APPSECRET="96xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";$TOKEN_URL="https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=".$APPID."&secret=".$APPSECRET;$json=file_get_contents($TOKEN_URL);$result=json_decode($json,true);print_r($result);?>

结果如下：

b. 获取access_token

<?php$APPID="wxdxxxxxxxxxxxxxxx";$APPSECRET="96xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";$TOKEN_URL="https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=".$APPID."&secret=".$APPSECRET;$json=file_get_contents($TOKEN_URL);$result=json_decode($json,true);$ACC_TOKEN=$result['access_token'];echo $ACC_TOKEN;?>

注：access_token对应于公众号是全局唯一的票据，重复获取将导致上次获取的access_token失效。

四、创建菜单

方法：通过POST一个特定结构体，实现在微信客户端创建自定义菜单。

请求地址：https://api.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN

请求示例：

{
 "button":[
 {
       "name":"公共查询",
       "sub_button":[
        {
           "type":"click",
           "name":"天气查询",
           "key":"tianQi"
        },
        {
           "type":"click",
           "name":"公交查询",
           "key":"gongJiao"
        },
        {
           "type":"click",
           "name":"翻译",
           "key":"fanYi"
        }]
  },
  {
       "name":"苏州本地",
       "sub_button":[
        {
           "type":"click",
           "name":"爱上苏州",
           "key":"loveSuzhou"
        },
        {
           "type":"click",
           "name":"苏州景点",
           "key":"suzhouScenic"
        },
        {
           "type":"click",
           "name":"苏州美食",
           "key":"suzhouFood"
        },
        {
           "type":"click",
           "name":"住在苏州",
           "key":"liveSuzhou"
        }]
   },
   {
       "type":"click",
       "name":"联系我们",
       "key":"lianxiUs"
   }]
}

示例说明：

菜单结构及说明：

{
 "button":[             //button定义该结构为一个菜单
  {
       "name":"分支主菜单名",　　
       "sub_button":[　　　　//sub_button定义子菜单
        {
           "type":"click",　　//按钮类型
           "name":"分支子菜单名1",　　//菜单名称
           "key":"loveSuzhou"　　//菜单key值
        },
        {
           "type":"click",
           "name":"分支子菜单名2",
           "key":"liveSuzhou"
        }]
   },　　　　//菜单之间用 , 分隔
   {
       "type":"click",
       "name":"独立菜单",
       "key":"lianxiUs"
   }]
}

返回说明：

正确的Json返回结果:

{"errcode":0,"errmsg":"ok"}

提交菜单：

通过curl 提交以上的菜单数据，代码如下：

$MENU_URL="https://api.weixin.qq.com/cgi-bin/menu/create?access_token=".$ACC_TOKEN;$ch = curl_init(); 

curl_setopt($ch, CURLOPT_URL, $MENU_URL); 
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE); 
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);
curl_setopt($ch, CURLOPT_USERAGENT, 'Mozilla/5.0 (compatible; MSIE 5.01; Windows NT 5.0)');
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 1);
curl_setopt($ch, CURLOPT_AUTOREFERER, 1); 
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $info = curl_exec($ch);if (curl_errno($ch)) {
    echo 'Errno'.curl_error($ch);
}

curl_close($ch);var_dump($info);

运行结果：

测试结果：

菜单创建成功。

五、查询菜单

查询当前使用的自定义菜单结构。

请求地址：https://api.weixin.qq.com/cgi-bin/menu/get?access_token=ACCESS_TOKEN

curl 代码如下：

$MENU_URL="https://api.weixin.qq.com/cgi-bin/menu/get?access_token=".$ACC_TOKEN;$cu = curl_init();
curl_setopt($cu, CURLOPT_URL, $MENU_URL);
curl_setopt($cu, CURLOPT_RETURNTRANSFER, 1);$menu_json = curl_exec($cu);$menu = json_decode($menu_json);
curl_close($cu);echo $menu_json;

运行结果：

菜单查询成功。

六、删除菜单

取消当前使用的自定义菜单。

请求地址：https://api.weixin.qq.com/cgi-bin/menu/delete?access_token=ACCESS_TOKEN

curl 代码如下：

$MENU_URL="https://api.weixin.qq.com/cgi-bin/menu/delete?access_token=".$ACC_TOKEN;$cu = curl_init();
curl_setopt($cu, CURLOPT_URL, $MENU_URL);
curl_setopt($cu, CURLOPT_RETURNTRANSFER, 1);$info = curl_exec($cu);$res = json_decode($info);
curl_close($cu);if($res->errcode == "0"){
    echo "菜单删除成功";
}else{
    echo "菜单删除失败";
}