微信公众平台开发入门教程

在这篇微信公众平台开发教程中，我们假定你已经有了PHP语言程序、MySQL数据库、计算机网络通讯、及HTTP/XML/CSS/JS等基础。

我们将使用微信公众账号方倍工作室作为讲解的例子，二维码见底部。

本系列教程将引导你完成如下任务：

1. 创建新浪云计算平台应用
2. 启用微信公众平台开发模式
3. 体验常用接收消息及发送消息类型
4. 了解数据收发原理及消息格式

 

第一章 申请服务器资源

创建新浪云计算应用

申请账号

我们使用SAE新浪云计算平台作为服务器资源，并且申请PHP环境+MySQL数据库作为程序运行环境。
申请地址为：

http://www.sinacloud.com/

直接点击上述网址，可以看到右上角微博登录的链接。

点击进入之后，使用新浪微博账号登录 

登录之后，按照提示注册个人信息即可。 

 

创建新应用 http://www.cnblogs.com/txw1958/p/wechat-tutorial.html

回到首页，在菜单顶部选择 控制台 ，再选择 云应用SAE 。

进入SAE应用列表

点击下侧的创建新应用，这时会弹出提示， 禁止放置违法违规内容，点击继续创建，弹出如下窗口。

选择一个未使用的appid，如果老是已经被使用不知道该什么好，就填写你的QQ号或者手机号吧。

填写二级域名AppID、应用名称、验证码，开发语言选择PHP5.3，全部应用和框架下面选择第一个【PHP 空应用】。然后点击左下方的创建应用

 

应用创建成功。并自动跳转到应用列表中，可以看到已经有刚才创建的1354386063这个应用。

 

创建版本 http://www.cnblogs.com/txw1958/p/wechat-tutorial.html 

点击刚才创建的应用名称，进入应用主页。

点击左侧的应用管理下面的代码管理，

 

在代码管理中，选择使用SVN托管的方式。

跳转到代码管理

点击右侧的“创建版本”

版本号默认为1，点击创建，有时会弹出安全登录，需要输入安全密码，如果不知道或者忘记了，就点里面的找回密码，重新设置一下。：

验证通过之后，如下所示

到这里，就成功创建了一个域名URL为 http://1354386063.sinaapp.com/ 的应用了，记住你的这个URL，后面将会用到。

 原文：http://www.cnblogs.com/txw1958/p/wechat-tutorial.html 

上传代码 http://www.cnblogs.com/txw1958/p/wechat-tutorial.html

下述代码是一个微信接口文件，看不懂没有关系，你可以暂时不用弄明白它的意思。

如果想弄明白，可以购买《微信公众平台开发最佳实践》，在该书中第25页~第27页有详细讲解。

valid();
}else{
    $wechatObj->responseMsg();
}

class wechatCallbackapiTest
{
    public function valid()
    {
        $echoStr = $_GET["echostr"];
        if($this->checkSignature()){
            header('content-type:text');
            echo $echoStr;
            exit;
        }
    }

    private function checkSignature()
    {
        $signature = $_GET["signature"];
        $timestamp = $_GET["timestamp"];
        $nonce = $_GET["nonce"];

        $token = TOKEN;
        $tmpArr = array($token, $timestamp, $nonce);
        sort($tmpArr, SORT_STRING);
        $tmpStr = implode( $tmpArr );
        $tmpStr = sha1( $tmpStr );

        if( $tmpStr == $signature ){
            return true;
        }else{
            return false;
        }
    }

    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 = "
                        
                        
                        %s
                        
                        
                        0
                        ";
            if($keyword == "?" || $keyword == "？")
            {
                $msgType = "text";
                $contentStr = date("Y-m-d H:i:s",time());
                $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr);
                echo $resultStr;
            }
        }else{
            echo "";
            exit;
        }
    }
}
?>

我们将使用上述代码与微信公众平台对接。直接下载方倍工作室已经压缩好的上述代码的zip文件。点此进入下载

回到SAE的代码管理界面中。

再选择“上传代码包”，点击上传文件，选择刚才的index.zip文件，点击上传，上传成功后中间是一个绿色的横条，如下所示

如果没有绿色的横条，表示上传失败，需要重试。可以考虑在Chrome浏览器下重试一下。

点击编辑代码按钮，

 有时候需要输入自己的安全密码，如果不记得了就点击“找回密码”。

安全验证成功后继续之前的操作。

我们可以看到index.php已经上传成功，双击可以查看编辑里面的代码

新浪云应用的创建就成功了。

充值（本步骤可选择性进行）

新浪云SAE实行的是配额免费+超额付费的方式，相关标准请查看SAE价格体系介绍。初期对于大部分用户来说免费配额已够用，如果您将来使用量比较大建议预先至少充值100元获得10000云豆，以免超额后应用被禁用而影响业务。

第二章 启用开发模式

微信公众平台开发模式

高级功能

微信公众平台地址：https://mp.weixin.qq.com

登录微信公众平台后台，在左侧列表中最下方，找到“ 基本配置 ”，点击进入

进入服务器配置填写框。

点击“修改配置”按钮

此处的URL为上篇中介绍的云应用的域名，而Token在index.php中定义为weixin。EncodingAESKey则不用填，点击“随机生成”让自动生成一个，消息加解密方式选择“明文模式”，然后点击“提交”按钮。

 

在弹出的提示框中，点击“确定”

配置修改后如图所示，再点击“启用”按钮

询问“是否确定开启服务器配置”，点击“确定”

如果提示“token验证失败”，可以先重次几次，微信服务器有时候不稳定。另外新浪SAE要求进行实名认证，请先上传身份证进行实名认证并通过审核后再试！

如果还是失败，请先用微信调试器测试一下url和token是否正确，点此查看详细测试方法。

成功启用后如图。

恭喜，你成功启用开发模式。

 

自动回复

在上面的例子中，实现了一个发送“?”就能回复当前时间的功能。
效果如下：

至此，你的微信公众平台账号已经实现自动回复了。 

第三章 常用消息类型接收与发送

 

关注公众账号下载扩展型代码

微信扫描下列二维码，然后回复“入门教程代码”，或查看到扩展型代码的完整地址。

将上述消息复制后，通过 手机版微信发给电脑版微信 或 手机版QQ发给电脑版QQ 的方式，将下载地址转到电脑上，并下载其中的压缩文件。

然后通过前面章节同样的方式，上传到新浪SAE应用中。

然后在你的公众账号中分别回复下列文字

文本 表情 单图文 多图文 音乐

  

或者发送以下类型的消息：语音 图片 小视频 我的收藏 位置

 

你将体验到微信公众账号中最常见的接收消息及发送消息的类型。

 

 

第四章 数据收发原理及消息数据格式

 

★ 本章是理论部分，初学者会比较难以理解，不用太过追究。

开发模式成为开发者时的消息校验原理

在开发者首次提交验证申请时，微信服务器将发送GET请求到填写的URL上，并且带上四个参数（signature、timestamp、nonce、echostr），开发者通过对签名（即signature）的效验，来判断此条消息的真实性。

此后，每次开发者接收用户消息的时候，微信也都会带上前面三个参数（signature、timestamp、nonce）访问开发者设置的URL，开发者依然通过对签名的效验判断此条消息的真实性。效验方式与首次提交验证申请一致。

参数	描述
signature	微信加密签名，signature结合了开发者填写的token参数和请求中的timestamp参数、nonce参数。
timestamp	时间戳
nonce	随机数
echostr	随机字符串

开发者通过检验signature对请求进行校验（下面有校验方式）。若确认此次GET请求来自微信服务器，请原样返回echostr参数内容，则接入生效，成为开发者成功，否则接入失败。

加密/校验流程如下：
1. 将token、timestamp、nonce三个参数进行字典序排序
2. 将三个参数字符串拼接成一个字符串进行sha1加密
3. 开发者获得加密后的字符串可与signature对比，标识该请求来源于微信

启用接口是由代码中的checkSignature()函数来实现校验的。如果对这一原理难以理解，可以暂时不用深究，继续看下面。

 

成为开发者后消息收发时的原理

上一章节中图，当用户发送一个“?”时，系统回复了一个时间

这一原理的消息流程图如下所示。

从上图可以看出，用户在发送一个?后，微信服务器将组装一个消息发送给我们自己的服务器，自己的服务器然后回复一个时间，并且将该时间也按一定的规则组装，回复给公众账号，公众账号再回复给用户，在这个收发过程中，发送方和接收方进行了调换(ToUserName和FromUserName值互换)，收发都是以xml格式在后台进行传输的，

所以掌握各种消息类型的接收回复就是进行微信公众平台开发的基础！

下面对前面所述的各种消息类型讲解其XML数据包的格式。

 

各种收发消息的XML数据包分析

接收消息

1. 文本（包括表情）
接收文本及表情

文字后台格式:

 
 
 1359028446
 
 
 5836982729904121631

表情后台格式

1359044526


5837051792978241864

XML格式讲解

ToUserName 消息接收方微信号，一般为公众平台账号微信号
FromUserName 消息发送方微信号
CreateTime 消息创建时间
MsgType 消息类型；文本消息为text
Content 消息内容
MsgId 消息ID号

可以看出，文本和表情的消息类型均为文本

2. 图片
接收图片

后台格式：

1359028479


5836982871638042400

XML格式讲解

ToUserName 消息接收方微信号，一般为公众平台账号微信号
FromUserName 消息发送方微信号
CreateTime 消息创建时间
MsgType 消息类型；图片消息为image
PicUrl 图片链接地址，可以用HTTP GET获取
MsgId 消息ID号

3. 语音
接收语音

后台格式：

    
    
    1364883809
    
    
    
    5862131322594912688

XML格式讲解

ToUserName 消息接收方微信号，一般为公众平台账号微信号
FromUserName 消息发送方微信号
CreateTime 消息创建时间
MsgType 消息类型；语音消息为voice
MediaId 媒体ID
Format 语音格式，这里为amr
MsgId 消息ID号

附：AMR接口简介
全称Adaptive Multi-Rate，主要用于移动设备的音频，压缩比比较大，但相对其他的压缩格式质量比较差，由于多用于人声，通话，效果还是很不错的。

4. 视频

接收视频

后台格式：

xml>

1359028186



5836981613212624665

XML格式讲解

ToUserName 消息接收方微信号，一般为公众平台账号微信号
FromUserName 消息发送方微信号
CreateTime 消息创建时间
MsgType 消息类型；视频消息为video
MediaId 媒体ID
ThumbMediaId 媒体缩略ID？
MsgId 消息ID号

5. 位置

接收位置

后台格式：

1359036619

22.539968
113.954980
16

5837017832671832047

XML格式讲解

 ToUserName 消息接收方微信号，一般为公众平台账号微信号
 FromUserName 消息发送方微信号
 CreateTime 消息创建时间
 MsgType 消息类型，地理位置为location
 Location_X 地理位置纬度
 Location_Y 地理位置经度
 Scale 地图缩放大小
 Label 地理位置信息
 MsgId 消息ID号

6. 链接

接收链接

后台格式：

 
 
1359709372 
 
 
 
5839907284805129867 
 

XML格式讲解

 ToUserName 消息接收方微信号，一般为公众平台账号微信号
 FromUserName 消息发送方微信号
 CreateTime 消息创建时间
 MsgType 消息类型，链接为link
 Title 图文消息标题
 Description 图文消息描述
 Url 点击图文消息跳转链接
 MsgId 消息ID号

 

回复消息

只介绍三种格式的消息：文本、图文、音乐。其中图文消息包括单条图文消息和多条图文消息，展示方式有一点点不同。

1. 文本消息格式
回复文本

后台格式：

1359036631


0

XML格式讲解

 FromUserName 消息发送方
 ToUserName 消息接收方
 CreateTime 消息创建时间
 MsgType 消息类型，文本消息必须填写text
 Content 消息内容，大小限制在2048字节，字段为空为不合法请求
 FuncFlag 星标字段

 
2. 图文消息格式
2.1 单条图文消息
回复单条图文

后台格式：

    
    
    1359011899
    
    
    1
    
        
            
    
            
            
        
    
    0

2.2 多图文消息

回复多图文

后台数据格式

    
    
    1359011829
    
    
    5
    
        
            

            
        
        
            
            
            
        
        
            
    
            
        
        
            

            
        
        
            

            
        
    
    0

XML格式讲解

FromUserName 消息发送方
 ToUserName 消息接收方
 CreateTime 消息创建时间
 MsgType 消息类型，图文消息必须填写news
 Content 消息内容，图文消息可填空
 ArticleCount 图文消息个数，限制为10条以内
 Articles 多条图文消息信息，默认第一个item为大图
  Title 图文消息标题
  Description 图文消息描述
  PicUrl 图片链接，支持JPG、PNG格式，较好的效果为大图640*320，小图80*80
  Url 点击图文消息跳转链接
FuncFlag 星标字段

 3. 音乐消息

回复音乐消息

后台格式：

    
    
    1372310544
    
    
        
        
        
    
    0

XML格式讲解

ToUserName     接收方帐号（收到的OpenID）
FromUserName     开发者微信号
CreateTime     消息创建时间
MsgType          消息类型，此处为music
    Title       音乐标题
    Description 音乐描述
    MusicUrl     音乐链接
    HQMusicUrl     高质量音乐链接，WIFI环境优先使用该链接播放音乐
FuncFlag     位0x0001被标志时，星标刚收到的消息。

 

事件消息类型

目前用户在关注和取消关注，以及点击菜单的时候会自动向公众平台发送事件推送消息：

1. 关注事件

    
    
    1372307736
    
    
    

2. 取消关注事件

    
    
    1372309890
    
    
    

3. 菜单点击事件

    
    
    1377886191
    
    
    

XML格式讲解

ToUserName     接收方微信号
FromUserName 发送方微信号，若为普通用户，则是一个OpenID
CreateTime     消息创建时间
MsgType     消息类型，event
Event     事件类型，subscribe(订阅)、unsubscribe(取消订阅)、CLICK(自定义菜单点击事件)
EventKey 事件KEY值，与自定义菜单接口中KEY值对应

 

第五章 小结

总的来说，通过本教程，你得到了以下收获：

1. 通过本教程得到了一个新浪云应用，该应用以后将会收取少量费用。你也可以另外自行购买空间服务器。

2. 成功启用了开发模式，并且实现了时间的自动回复。

3. 体验了微信公众账号最常用的接收消息及发送消息类型

4. 了解了微信公众平台开发的原理，并且熟悉了各种消息及发送是怎么一回事