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

 

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

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

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

  1. 创建新浪云计算平台应用

  2. 启用微信公众平台开发模式

  3. 了解数据收发原理及消息格式

  4. 开发实现微信天气预报功能

 

第一章 申请服务器资源

创建新浪云计算应用

申请账号

我们使用SAE新浪云计算平台作为服务器资源,并且申请PHP环境+MySQL数据库作为程序运行环境。
申请地址:http://sae.sina.com.cn/ ,使用新浪微博账号可以直接登录SAE,登录后SAE将赠送500个免费云豆。

 

 

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

登录后点击顶部【我的首页

 

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

 

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

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

 

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

 

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

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

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

 

 

跳转到代码管理

 

点击右侧的

 

版本号默认为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页有详细讲解。

 

<?("TOKEN", "weixin" =  ((['echostr'->->  = ["echostr"(->   = ["signature" = ["timestamp" = ["nonce" = = (, , ( = (  = ( (  ==     = ["HTTP_RAW_POST_DATA" (!( = (, 'SimpleXMLElement', = -> = -> = (-> =  = ""( == "?" ||  == "?" = "text" = ("Y-m-d H:i:s", = (, , , , ,   ""?>

 

我们将使用上述代码与微信公众平台对接。

将上述代码用专业的软件存为utf-8格式的index.php文件后再使用WinRAR压缩为index.zip,

或者直接下载方倍工作室已经压缩好的index.zip文件。点此进入下载

回到SAE,在代码管理界面中,选择操作按钮。

 

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

 

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

点击编辑代码按钮,

 

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

 

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

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

 

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

 

第二章 启用开发模式

微信公众平台开发模式

高级功能

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

登录微信公众平台后台,在左侧列表中最下方,找到“开发者中心”,点击进入

 

进入服务器配置填写框。

 

点击“修改配置”按钮

 

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

 

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

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

 

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

 

成功启用后如图。

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

 

自动回复

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

 

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

 

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

 

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

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

在开发者首次提交验证申请时,微信服务器将发送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

 

表情后台格式

 

13590445265837051792978241864

 

XML格式讲解

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

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

2. 图片
接收图片

 

后台格式:

 

13590284795836982871638042400

 

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>13590281865836981613212624665

 

XML格式讲解

 

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

 

5. 位置

接收位置

 

后台格式:

 

135903661922.539968113.954980165837017832671832047

 

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. 文本消息格式
回复文本

 

后台格式:

 

13590366310

 

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值对应

 

 

 第四章 实现天气预报功能

 

这一章里,我们来实现微信上的天气预报功能,我们使用方倍工作室的天气预报接口,其接口为

http:

这个接口的参数appkey为公众号原始id,参数city为城市名

例如,查询深圳的天气预报时,将city值做urlencode,最终访问的url为

http:

返回的内容如下

 

: : : : : : : : : : : : : : : : : : : : : : : :

 

我们在微信中调用这一接口来获取天气预报信息,实现代码如下

 

<?("TOKEN", "weixin" =  (!(['echostr'->->
      = ["echostr" = ["signature" = ["timestamp" = ["nonce" = = (, , ( = ( = (( ==    = ["HTTP_RAW_POST_DATA" (!(->logger("R ". = (, 'SimpleXMLElement', = (-> = "" ( "event":                     = ->receiveEvent( "text":                     = ->receiveText(->logger("T ".  ""  receiveEvent( (-> "subscribe":                 = "欢迎关注方倍工作室 " = ->transmitText(,    receiveText( = (-> = "http://apix.sinaapp.com/weather/?appkey=".->ToUserName."&city=".( = ( = json_decode(,  = ->transmitNews(,    transmitText(,  (!() || ( "" = "" = (, ->FromUserName, ->ToUserName, (),    transmitNews(, (!( "" = "" = "" (   .= (, ['Title'], ['Description'], ['PicUrl'], ['Url' = "" = (, ->FromUserName, ->ToUserName, (), (   logger(?>

 

上述代码的下载地址为 http://pan.baidu.com/s/1gdsyHWJ,同样的方法,可将代码上传到SAE上。

在公众账号中使用的命令如下:

  1. 发送城市名称,如“深圳”,可以查询该城市的天气

在你的公众账号输入相应的命令,实现效果类似如下所示:

 

 

第五章 小结

 

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

  • 1. 你通过本教程得到了一个免费的新浪云计算空间,云计算哦

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

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

  • 4. 你使用方倍工作室的天气预报接口,实现了一个微信公众平台上的天气预报功能。

接下来该做什么呢?你可以学习开发一些基础的常用功能,推荐:方倍工作室 编写,机械工业出版社 出版的《微信公众平台开发最佳实践》,里面包含很多php开发技巧、数据库使用、及近30项微信公众平台实用功能或技术 

未经允许请勿转载:超人很忙空间 » 微信公众平台开发入门教程

赞一个 (0)
分享到: +More