绯樱月姬
公眾號自定義菜單設置教程

[mw_shl_code=php,true]

先讲一下原理(详见公共平台开发文档):

1,注册公众号、开通开发者模式时,平台将提供两个参数 APPID,APPSECRET (对于微信的订阅号,平台不提供; 易信所有公众号均提供)

2,自定义菜单前,须向平台申请一个使用凭证(AccessToken), 方法如下:

用GET方式读取URL https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET

其中:APPID,APPSECRET 用实际参数值代入

返回结果是一个JSON格式的文本,其中有AccessToken. (JSON是一种数据交换格式,不了解的同学要从头学一下才能明白)

AccessToken不是永久有效的,返回结果中有一个失效时间,即过了XX秒后(一般是一天左右), AccessToken就会失效。

对于易信平台,上述URL为 https://api.yixin.im/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET

3,获得有效的AccessToken后,就可以进行自定义菜单创建、删除操作了。

3.1 创建菜单

用POST方式向这个URL提交菜单定义数据, URL:https://api.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN

其中:ACCESS_TOKEN 用实际参数值代入

菜单定义数据是一个JSON格式的文本 (开发文档讲得不是那么清晰,让我理解了好一会),做为POST方式的提交数据

返回结果是一个JSON格式的文本,其中有操作成功码和出错信息

对于易信平台,创建菜单的URL为 https://api.yixin.im/cgi-bin/menu/create?access_token=ACCESS_TOKEN

3.2 删除菜单

用GET方式读取URL https://api.weixin.qq.com/cgi-bin/menu/delete?access_token=ACCESS_TOKEN

其中:ACCESS_TOKEN 用实际参数值代入

返回结果是一个JSON格式的文本,其中有AccessToken. (JSON是一种数据交换格式,不了解的同学要从头学一下才能明白)

AccessToken不是永久有效的,返回结果中还有一个失效时间,即过了XX秒后(一般是一天左右), AccessToken就会失效。

对于易信平台,上述URL为 https://api.yixin.im/cgi-bin/menu/delete?access_token=ACCESS_TOKEN

上述过程需要开发者非常了解 HTTP协议细节和JSON格式,对于一般开发者来说,可能是个噩梦。

经本人编码、测试,在此提供两个类,彻底简化开发者的自定义菜单的开发工作 (开发者无需再去理解HTTP协议、JSON和公共平台协议了)

结果如下:

开发语言: PHP 5.X

源码下载地址: http://download.csdn.net/detail/c80486/6357873

文件名:jostudio.wechatmenu.php 此处只讲其使用。(感兴趣的同学,可以看源代码注释)

文件中定义了两个类:

第一个类:WeChatMenu 用于菜单操作

第二个类:MenuDefine 用于菜单数据定义

用这两个类实现的自定义菜单操作,例程文件 test_menu.php

<?php

include_once 'jostudio.wechatmenu.php'; //包含WeChatMenu类

$AppId="9cXXXXXXXXXXXXXXXXXX"; //公共平台提供的AppId参数

$AppSecret="61XXXXXXXXXXXXXX"; //公共平台提供的AppSecret参数

//创建一个WeChatMenu类的实例

$object = new WeChatMenu("weixin",$AppId, $AppSecret); //第一个参数 "weixin", 表明是针对微信平台的

//$object = new WeChatMenu("yixin",$AppId, $AppSecret); //第一个参数 "yixin", 表明是针对易信平台的

//定义一个菜单数据

$menu = new MenuDefine(); //创建一个MenuDefine实例

$menu->menuStart(); //菜单开始

$menu->addMenu("娱乐天地");

$menu->addMenuItem("猜谜语", "riddle");

$menu->addMenuItem("讲笑话", "joke");

$menu->addMenuItem("听音乐", "music");

$menu->addMenuItem("看电影", "movie");

$menu->addMenuItem("看小说", "novel");

$menu->addMenu("实用工具");

$menu->addMenuItem("找美食", "food");

$menu->addMenuItem("城市天气", "weather");

$menu->addMenuItem("翻译", "translate");

$menu->menuEnd(); //菜单定义结束, 则此时$menu->str中有菜单定义数据(JSON格式)

//生成菜单

echo " *本站禁止HTML标签噢* Create Menu</h2>";

if ($object->createMenu($menu->str)) //$menu->str中有菜单定义数据(JSON格式)

echo "Create menu OK";

else

echo "Create menu failure:".$menuObject->errmsg;

echo " *本站禁止HTML标签噢* ";

//获取当前菜单数据

echo " *本站禁止HTML标签噢* Get Menu: the menu json data is</h2>";

echo $object->getMenu();

echo " *本站禁止HTML标签噢* ";

/*

//删除菜单

echo " *本站禁止HTML标签噢* Delete Menu</h2>";

echo $object->deleteMenu();

echo " *本站禁止HTML标签噢* ";

*/

?>

代码说明:

1,首先: include_once 'jostudio.wechatmenu.php'; //包含WeChatMenu类

2,$AppId, $AppSecret是平台提供的两个参数,请修改代码,填入真实的值

3,创建一个WeChatMenu类的实例

$object = new WeChatMenu($platform, $AppId, $AppSecret);

第一个参数(文本型) $platform 指明是针对哪个平台,微信平台为"weixin", 易信平台为"yixin"

4, 定义菜单数据

4.1首先,创建一个MenuDefine实例

$menu = new MenuDefine(); //创建一个MenuDefine实例

4.2然后加入菜单

$menu->addMenu($name); //一级菜单, $name为菜单名

4.3再加入菜单项

$menu->addMenuItem($name, $key); //二级菜单

$name为菜单项名称

$key是菜单的键值,用户点击该菜单项时,将产生一个click消息, 消息中有这个key值,标明是哪个菜单被点击了

4.4如此类推,逐个加入。

上述例程中,共定义了两个一级菜单

4.5菜单定义结束,用 $menu->menuEnd(); 结束菜单定义, 则此时$menu的str变量中已生成了菜单定义数据(JSON格式)

MenuDefine这个类是用于简化菜单定义的,最后生成的JSON格式的数据,保存在 $menu->str中。

5, 调用WeChatMenu类的createMenu($menu_data)方法创建自定义菜单

代码为: $object->createMenu($menu->str))

createMenu() 将自动完成原理介绍中的所有过程

如成功创建菜单, createMenu()将返回true

如创建菜单失败, createMenu()将返回false, 错误代码和错误信息分别记录在 $object->errcode 和 $object->errmsg 两个变量中

6, 调用WeChatMenu类的getMenu()方法可以读取当前平台上的菜单定义数据, 返回结果是一个JSON格式的文本

7, 调用WeChatMenu类的deleteMenu()方法可以删除平台上的菜单定义, 如成功则返回true

test_menu.php 这个例程文件是完整可用的,根据需要修改一下,上传到服务器上,load一下即可完成自定义菜单操作[/mw_shl_code]

绯樱月姬
微信公众平台消息接口PHP版开发教程

本帖最后由 绯樱月姬 于 2013-7-31 19:44 编辑

自動公式轉換神煩

[mw_shl_code=php,true]

使用前提条件:拥有一个公网上的HTTP服务器主机空间,具有创建目录、上传文件等权限。推荐新浪的SAE。http://sae.sina.com.cn/

首先请注册微信公众平台的账号,注册地址:http://mp.weixin.qq.com/

本教程主要讲解接口的开发流程。

官方的文档非常简洁:http://mp.weixin.qq.com/cgi-bin/ ... kapi-doc&lang=zh_CN

事例代码也跑不通。我研究了一番,终于搞定。方法如下:

一、写好接口程序

在你的服务器上上传好一个接口程序文件,如http://www.yourdomain.com/weixin.php 内容如下:

<?php

define("TOKEN", "weixin");//自己定义的token 就是个通信的私钥

$wechatObj = new wechatCallbackapiTest();

$wechatObj->valid();

//$wechatObj->responseMsg();

class wechatCallbackapiTest

{

public function valid()

{

$echoStr = $_GET["echostr"];

if($this->checkSignature()){

echo $echoStr;

exit;

}

}

public function responseMsg()

{

$postStr = $GLOBALS["HTTP_RAW_POST_DATA"];

if (!empty($postStr)){

$postObj = simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_NOCDATA);

$fromUsername = $postObj->FromUserName;

$toUsername = $postObj->ToUserName;

$keyword = trim($postObj->Content);

$time = time();

$textTpl = " *本站禁止HTML标签噢*

*本站禁止HTML标签噢* <![CDATA[%s]]></ToUserName>

*本站禁止HTML标签噢* <![CDATA[%s]]></FromUserName>

*本站禁止HTML标签噢* %s</CreateTime>

*本站禁止HTML标签噢* <![CDATA[%s]]></MsgType>

*本站禁止HTML标签噢* <![CDATA[%s]]></Content>

*本站禁止HTML标签噢* 0 *本站禁止HTML标签噢*

</xml>";

if(!empty( $keyword ))

{

$msgType = "text";

$contentStr = '你好啊,屌丝';

$resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr);

echo $resultStr;

}else{

echo '咋不说哈呢';

}

}else {

echo '咋不说哈呢';

exit;

}

}

private function checkSignature()

{

$signature = $_GET["signature"];

$timestamp = $_GET["timestamp"];

$nonce = $_GET["nonce"];

$token =TOKEN;

$tmpArr = array($token, $timestamp, $nonce);

sort($tmpArr);

$tmpStr = implode( $tmpArr );

$tmpStr = sha1( $tmpStr );

if( $tmpStr == $signature ){

return true;

}else{

return false;

}

}

}

?>

二、配置微信公众平台回复接口

设置回复接口,填好URL和Token(url填上面的http://www.yourdomain.com/weixin.php,token必须跟上面程序里面定义的Token一致)

\

三、验证接口

用自己的个人微信关注下你的公众账号,给这个账号发一条消息过去,收到原样的消息返回,即验证成功了。

四、开始自定义回复

注释掉$wechatObj->valid(); 这行,同时去掉//$wechatObj->responseMsg();这行的注释。

你可以修改responseMsg函数里面的代码,根据用户的消息类型('text','image','location')和消息内容来回复用户不同的内容。

消息接口就可以使用了,发个消息试试看吧?

封装weixin.class.php

由于微信公众平台的通信使用的是特定格式的XML数据,每次接受和回复都要去做一大堆的数据处理。

我们就考虑在这个基础上做一次封装,weixin.class.php,代码如下:

<?php

class Weixin

{

public $token = '';//token

public $debug = false;//是否debug的状态标示,方便我们在调试的时候记录一些中间数据

public $setFlag = false;

public $msgtype = 'text'; //('text','image','location')

public $msg = array();

public function __construct($token,$debug)

{

$this->token = $token;

$this->debug = $debug;

} *本站禁止HTML标签噢*      //获得用户发过来的消息(消息内容和消息类型 )

public function getMsg()

{

$postStr = $GLOBALS["HTTP_RAW_POST_DATA"];

if ($this->debug) {

$this->write_log($postStr);

}

if (!empty($postStr)) {

$this->msg = (array)simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_NOCDATA);

$this->msgtype = strtolower($this->msg['MsgType']);

}

} *本站禁止HTML标签噢*      //回复文本消息

public function makeText($text='')

{

$CreateTime = time();

$FuncFlag = $this->setFlag ? 1 : 0;

$textTpl = " *本站禁止HTML标签噢*

*本站禁止HTML标签噢* <![CDATA[{$this->msg['FromUserName']}]]></ToUserName>

*本站禁止HTML标签噢* <![CDATA[{$this->msg['ToUserName']}]]></FromUserName>

*本站禁止HTML标签噢* {$CreateTime}</CreateTime>

*本站禁止HTML标签噢* <![CDATA[text]]></MsgType>

*本站禁止HTML标签噢* <![CDATA[%s]]></Content>

*本站禁止HTML标签噢* %s</FuncFlag>

</xml>";

return sprintf($textTpl,$text,$FuncFlag);

} *本站禁止HTML标签噢*      //根据数组参数回复图文消息

public function makeNews($newsData=array())

{

$CreateTime = time();

$FuncFlag = $this->setFlag ? 1 : 0;

$newTplHeader = " *本站禁止HTML标签噢*

*本站禁止HTML标签噢* <![CDATA[{$this->msg['FromUserName']}]]></ToUserName>

*本站禁止HTML标签噢* <![CDATA[{$this->msg['ToUserName']}]]></FromUserName>

*本站禁止HTML标签噢* {$CreateTime}</CreateTime>

*本站禁止HTML标签噢* <![CDATA[news]]></MsgType>

*本站禁止HTML标签噢* <![CDATA[%s]]></Content>

*本站禁止HTML标签噢* %s</ArticleCount> *本站禁止HTML标签噢* ";

$newTplItem = " *本站禁止HTML标签噢*

*本站禁止HTML标签噢* <![CDATA[%s]]></Title>

*本站禁止HTML标签噢* <![CDATA[%s]]></Description>

*本站禁止HTML标签噢* <![CDATA[%s]]></PicUrl>

*本站禁止HTML标签噢* <![CDATA[%s]]></Url>

</item>";

$newTplFoot = "</Articles>

*本站禁止HTML标签噢* %s</FuncFlag>

</xml>";

$Content = '';

$itemsCount = count($newsData['items']);

$itemsCount = $itemsCount < 10 ? $itemsCount : 10;//微信公众平台图文回复的消息一次最多10条

if ($itemsCount) {

foreach ($newsData['items'] as $key => $item) {

if ($key<=9) {

$Content .= sprintf($newTplItem,$item['title'],$item['description'],$item['picurl'],$item['url']);

}

}

}

$header = sprintf($newTplHeader,$newsData['content'],$itemsCount);

$footer = sprintf($newTplFoot,$FuncFlag);

return $header . $Content . $footer;

}

public function reply($data)

{

if ($this->debug) {

$this->write_log($data);

}

echo $data;

}

public function valid()

{

if ($this->checkSignature()) {

if( $_SERVER['REQUEST_METHOD']=='GET' )

{

echo $_GET['echostr'];

exit;

}

}else{

write_log('认证失败');

exit;

}

}

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 write_log($log){ *本站禁止HTML标签噢*        //这里是你记录调试信息的地方 请自行完善 以便中间调试 *本站禁止HTML标签噢*     }

}

?>

调用weixin.class.php

把你的微信公众平台主接口文件(如前面定义的http://www.yourdomain.com/weixin.php)中,修改代码为:

<?php

include_once('weixin.class.php');//引用刚定义的微信消息处理类 *本站禁止HTML标签噢* define("TOKEN", "mmhelper"); *本站禁止HTML标签噢* define('DEBUG', true);

$weixin = new Weixin(TOKEN,DEBUG);//实例化

$weixin->getMsg();

$type = $weixin->msgtype;//消息类型

$username = $weixin->msg['FromUserName'];//哪个用户给你发的消息,这个$username是微信加密之后的,但是每个用户都是一一对应的

if ($type==='text') {

if ($weixin->msg['Content']=='Hello2BizUser') {//微信用户第一次关注你的账号的时候,你的公众账号就会受到一条内容为'Hello2BizUser'的消息

$reply = $weixin->makeText('欢迎你关注妈妈助手哦,屌丝');

}else{//这里就是用户输入了文本信息

$keyword = $weixin->msg['Content']; //用户的文本消息内容

include_once("chaxun.php");//文本消息 调用查询程序

$chaxun= new chaxun(DEBUG,$keyword,$username);

$results['items'] =$chaxun->search();//查询的代码

$reply = $weixin->makeNews($results);

}

}elseif ($type==='location') {

//用户发送的是位置信息 稍后的文章中会处理

}elseif ($type==='image') {

//用户发送的是图片 稍后的文章中会处理

}elseif ($type==='voice') {

//用户发送的是声音 稍后的文章中会处理

}

$weixin->reply($reply);

?>

查询代码

还需要将数据库里面的查询结果格式化为特定的形式

<?php

public function search(){

$record=array(); //定义返回结果的数组

$list = $this->search($this->keyword);//普通的根据关键词查询数据库的操作 代码就不用分享了

if(is_array($list)&&!empty($list)){

foreach($list as $msg){

$record[]=array(//以下代码,将数据库中查询返回的数组格式化为微信返回消息能接收的数组形式,即title、description、picurl、url 详见微信官方的文档描述

'title' =>$msg['title'],

'description' =>$msg['discription'],

'picurl' => $msg['pic_url'],

'url' =>$msg['url']

);

}

}

return $record;

}

?>[/mw_shl_code]