由于微信的大熱,為了更好的友善使用微信的使用者查詢一些資訊,這篇文章是入門級的微信公衆平台開發教程,需要的朋友可以參考下。
在這篇入門教程中,我們假定你已經有了PHP語言程式、MySQL資料庫、計算機網絡通訊及XML語言基礎。如果你還沒有,那麼請先學習相關知識。
我們将使用微信公衆賬号一車大師(賬号:yichemaster,關注微信公衆号營運和開發的可以搜尋公衆号yichemaster,或掃描下方二維碼關注一車大師)作為講解的例子。
這篇入門教程将引導你完成如下任務:
建立百度雲平台應用啟用微信公衆平台開發模式擷取訂閱、文字、圖檔、語音、視訊消息回複文本、圖文及音樂消息程式開發
建立百度雲應用
申請賬号
登入http://developer.baidu.com/bae ,使用郵箱或者手機注冊一個賬号,注冊需要同時綁定手機并且驗證郵箱。
建立應用
注冊并登入成功以後,點選右上側的
,彈出如下視窗。
應用名稱自己随便填寫一個,接入方式選擇“手機web應用”,然後點選确定。
選擇“雲環境(BAE)”,
在新的視窗中,填寫應用域名的名稱,環境類型選擇PHP,其他根據自己需要選擇或者使用上圖預設值,然後點選确定
建立版本
在版本管理中,點選建立新版本
版本号填寫0,然後儲存。
上傳代碼
将以下代碼中的token改為你的名稱,并另存為index.php。
注意:此處填寫的Token将要在下面填寫URL時用到。可以先儲存下來。
複制代碼代碼如下:
<?php
define("TOKEN", "pondbay");
$wechatObj = new wechatCallbackapiTest();
$wechatObj->valid();
class wechatCallbackapiTest
{
public function valid()
$echoStr = $_GET["echostr"];
if($this->checkSignature()){
echo $echoStr;
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;
?>
然後将其壓縮成zip格式
這樣會生成一個index.zip的檔案。
回來版本管理中
選擇包上傳更新
選擇剛才壓縮好的zip包,點選上傳。
确定生效,并且點選 ,點選後如下圖。
百度雲應用的建立就成功了。
微信公衆平台開發模式
進階功能
微信公衆平台位址:https://mp.weixin.qq.com
登入微信公衆平台背景,選擇進階功能
進入後就看到兩種模式
我們需要關閉編輯模式。點選編輯模式的進入
滑動關閉
開發模式
進入開發模式裡面
點選成為開發者
彈出URL和Token填寫框
此處的URL為建立百度雲應用的域名,包括後面的duapp.com,而Token為index.php中定義的值。
URL: http://pondbay.duapp.com
Token: pondbay
填寫如下圖,
送出成功
再滑動右上角啟用按鈕。
至此,你已經成功啟用開發模式。
接收消息類型
目前普通使用者能向公衆賬号推送五種格式的消息:文本(包括表情)、語音、圖檔、視訊、位置、連結。名片發送會失敗。
下面就這五種分别詳解如下:
1. 文本(包括表情)
發送文本
背景格式:
<xml>
<ToUserName><![CDATA[gh_680bdefc8c5d]]></ToUserName>
<FromUserName><![CDATA[oIDrpjqASyTPnxRmpS9O_ruZGsfk]]></FromUserName>
<CreateTime>1359028446</CreateTime>
<MsgType><![CDATA[text]]></MsgType>
<Content><![CDATA[你好]]></Content>
<MsgId>5836982729904121631</MsgId>
</xml>
發送表情
背景格式
<xml><ToUserName><![CDATA[gh_680bdefc8c5d]]></ToUserName>
<CreateTime>1359044526</CreateTime>
<Content><![CDATA[/::)/::)/::)/::)/::)]]></Content>
<MsgId>5837051792978241864</MsgId>
XML格式講解
ToUserName 消息接收方微信号,一般為公衆平台賬号微信号
FromUserName 消息發送方微信号
CreateTime 消息建立時間
MsgType 消息類型;文本消息為text
Content 消息内容
MsgId 消息ID号可以看出,文本和表情的消息類型均為文本
[html]
2. 圖檔
發送圖檔
背景格式:
[code]
<CreateTime>1359028479</CreateTime>
<MsgType><![CDATA[image]]></MsgType>
<PicUrl><![CDATA[http://mmsns.qpic.cn/mmsns/L4qjYtOibuml238YYBcfS2FQ8JtNN69Bc4bbbscvQRrljbedVjlMEAA/0]]></PicUrl>
<MsgId>5836982871638042400</MsgId>
MsgType 消息類型;圖檔消息為image
PicUrl 圖檔連結位址,可以用HTTP GET擷取
MsgId 消息ID号
3. 語音
發送語音
<CreateTime>1359028025</CreateTime>
<MsgType><![CDATA[voice]]></MsgType>
<MediaId><![CDATA[hGm9wmKth8RO_tuv5k9fJkSbovXWzZVYwG2jSsL7ukCqq6q1SiLzYnFEngFNUijs]]></MediaId>
<Format><![CDATA[amr]]></Format>
<MsgId>5836980921722890003</MsgId>
MsgType 消息類型;語音消息為voice
MediaId 媒體ID
Format 語音格式,這裡為amr
MsgId 消息ID号附:AMR接口簡介
全稱Adaptive Multi-Rate,主要用于移動裝置的音頻,壓縮比比較大,但相對其他的壓縮格式品質比較差,由于多用于人聲,通話,效果還是很不錯的。
4. 視訊
發送視訊
<CreateTime>1359028186</CreateTime>
<MsgType><![CDATA[video]]></MsgType>
<MediaId><![CDATA[DBVFRIj29LB2hxuYpc0R6VLyxwgyCHZPbRj_IIs6YaGhutyXUKtFSDcSCPeoqUYr]]></MediaId>
<ThumbMediaId><![CDATA[mxUJ5gcCeesJwx2T9qsk62YzIclCP_HnRdfTQcojlPeT2G9Q3d22UkSLyBFLZ01J]]></ThumbMediaId>
<MsgId>5836981613212624665</MsgId>
MsgType 消息類型;視訊消息為video
ThumbMediaId 媒體縮略ID?
MsgId 消息ID号 原文:http://blog.csdn.net/newhappy2008/
5. 位置
發送位置
<FromUserName><![CDATA[oIDrpjqASyTPnxRmpS9O_ruZGsfk]]></FLACFromUserName>
<CreateTime>1359036619</CreateTime>
<MsgType><![CDATA[location]]></MsgType>
<Location_X>22.539968</Location_X>
<Location_Y>113.954980</Location_Y>
<Scale>16</Scale>
<Label><![CDATA[中國北京市海澱區 郵政編碼: 100000]]></Label>
<MsgId>5837017832671832047</MsgId>
MsgType 消息類型,地理位置為location
Location_X 地理位置緯度
Location_Y 地理位置經度
Scale 地圖縮放大小
Label 地理位置資訊
6. 連結
發送連結
<FromUserName><![CDATA[oIDrpjl2LYdfTAM-oxDgB4XZcnc8]]></FromUserName>
<CreateTime>1359709372</CreateTime>
<MsgType><![CDATA[link]]></MsgType>
<Title><![CDATA[分享一款應用給你 -方倍神圖]]></Title>
<Description><![CDATA[方倍神圖為您提供夫妻相測試,親子鑒定等新奇、好玩的圖檔測試功能]]></Description>
<Url><![CDATA[http://israel.duapp.com/web/photo.php]]></Url>
<MsgId>5839907284805129867</MsgId>
MsgType 消息類型,連結為link
Title 圖文消息标題
Description 圖文消息描述
Url 點選圖文消息跳轉連結
發送消息類型
目前公衆賬号能向普通使用者推送三種格式的消息:文本、圖文、音樂。其中圖文消息包括單條圖文消息和多條圖文消息,展示方式有一點點不同。
另外,回複的消息支援星标操作:通過填寫FuncFlag字段為1來對回複消息做星标操作後,可以在實時消息的星标消息分類中找到對應的推送消息。
下面就這幾種分别詳解如下:
1. 文本消息格式
回複文本
<ToUserName><![CDATA[oIDrpjqASyTPnxRmpS9O_ruZGsfk]]></ToUserName>
<FromUserName><![CDATA[gh_680bdefc8c5d]]></FromUserName>
<CreateTime>1359036631</CreateTime>
<Content><![CDATA[一車大師 微信公衆平台運維及開發技巧]]></Content>
<FuncFlag>0</FuncFlag>
FromUserName 消息發送方
ToUserName 消息接收方
MsgType 消息類型,文本消息必須填寫text
Content 消息内容,大小限制在2048位元組,字段為空為不合法請求
FuncFlag 星标字段
2. 圖文消息格式
2.1 單條圖文消息
回複單條圖文
<CreateTime>1359011899</CreateTime>
<MsgType><![CDATA[news]]></MsgType>
<Content><![CDATA[]]></Content>
<ArticleCount>1</ArticleCount>
<Articles>
<item>
<Title><![CDATA[【天津】天氣實況 ]]></Title>
<Description><![CDATA[溫度:3℃ 濕度:43﹪ 風速:西南風2級]]></Description>
<PicUrl><![CDATA[http://www.doucube.com/weixin/weather/icon/banner.jpg]]></PicUrl>
<Url><![CDATA[]]></Url>
</item>
</Articles>
2.2 多條圖文消息
<CreateTime>1359011829</CreateTime>
<ArticleCount>8</ArticleCount>
<Title><![CDATA[【天津】天氣實況 溫度:3℃ 濕度:43﹪ 風速:西南風2級]]></Title>
<Description><![CDATA[]]></Description>
<Title><![CDATA[06月24日 周四 2℃~-7℃ 晴 北風3-4級轉東南風小于3級]]></Title>
<PicUrl><![CDATA[http://www.doucube.com/weixin/weather/icon/d00.gif]]></PicUrl>
<Title><![CDATA[06月25日 周五 -1℃~-8℃ 晴 東南風小于3級轉東北風3-4級]]></Title>
<Title><![CDATA[06月26日 周六 -1℃~-7℃ 多雲 東北風3-4級轉東南風小于3級]]></Title>
<PicUrl><![CDATA[http://www.doucube.com/weixin/weather/icon/d01.gif]]></PicUrl>
<Title><![CDATA[06月27日 周日 0℃~-6℃ 多雲 東南風小于3級轉東北風3-4級]]></Title>
<Title><![CDATA[06月28日 周一 -1℃~-8℃ 多雲 東北風3-4級轉南風小于3級]]></Title>
<Title><![CDATA[06月29日 周二 1℃~-5℃ 多雲 南風小于3級轉3-4級]]></Title>
<Title><![CDATA[方倍工作室 版權所有]]></Title>
<PicUrl><![CDATA[]]></PicUrl>
MsgType 消息類型,圖文消息必須填寫news
Content 消息内容,圖文消息可填空
ArticleCount 圖文消息個數,限制為10條以内
Articles 多條圖文消息資訊,預設第一個item為大圖
PicUrl 圖檔連結,支援JPG、PNG格式,較好的效果為大圖640*320,小圖80*80
3. 音樂消息
<ToUserName><![CDATA[ollB4jqgdO_cRnVXk_wRnSywgtQ8]]></ToUserName>
<FromUserName><![CDATA[gh_b629c48b653e]]></FromUserName>
<CreateTime>1372310544</CreateTime>
<MsgType><![CDATA[music]]></MsgType>
<Music>
<Title><![CDATA[最炫民族風]]></Title>
<Description><![CDATA[鳳凰傳奇]]></Description>
<MusicUrl><![CDATA[http://zj189.cn/zj/download/music/zxmzf.mp3]]></MusicUrl>
<HQMusicUrl><![CDATA[http://zj189.cn/zj/download/music/zxmzf.mp3]]></HQMusicUrl>
</Music>
ToUserName 接收方帳号(收到的OpenID)
FromUserName 開發者微信号
CreateTime 消息建立時間
MsgType 消息類型,此處為music
Title 音樂标題
Description 音樂描述
MusicUrl 音樂連結
HQMusicUrl 高品質音樂連結,WIFI環境優先使用該連結播放音樂
FuncFlag 位0x0001被标志時,星标剛收到的消息。
事件消息類型
目前使用者在關注和取消關注的時候會自動向公衆平台發送事件推送消息:
1. 關注事件
<ToUserName><![CDATA[gh_b629c48b653e]]></ToUserName>
<FromUserName><![CDATA[ollB4jv7LA3tydjviJp5V9qTU_kA]]></FromUserName>
<CreateTime>1372307736</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[subscribe]]></Event>
<EventKey><![CDATA[]]></EventKey>
2. 取消關注事件
<FromUserName><![CDATA[ollB4jqgdO_cRnVXk_wRnSywgtQ8]]></FromUserName>
<CreateTime>1372309890</CreateTime>
<Event><![CDATA[unsubscribe]]></Event>
3. 菜單點選事件
<CreateTime>1377886191</CreateTime>
<Event><![CDATA[CLICK]]></Event>
<EventKey><![CDATA[天氣深圳]]></EventKey>
ToUserName 接收方微信号
FromUserName 發送方微信号,若為普通使用者,則是一個OpenID
MsgType 消息類型,event
Event 事件類型,subscribe(訂閱)、unsubscribe(取消訂閱)、CLICK(自定義菜單點選事件)
EventKey 事件KEY值,與自定義菜單接口中KEY值對應
簡單的自動回複
我們在官方的例子上做一些修改,實作了一個發送“?”就能回複目前時間的功能。
該例子是接收文本消息($postObj->Content),并且回複文本消息($msgType = "text";)的。
你可以把以下代碼儲存為index.php,按照上面提供的方法重新上傳。
代碼如下:
$wechatObj->responseMsg();
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 = "<xml>
<ToUserName><![CDATA[%s]]></ToUserName>
<FromUserName><![CDATA[%s]]></FromUserName>
<CreateTime>%s</CreateTime>
<MsgType><![CDATA[%s]]></MsgType>
<Content><![CDATA[%s]]></Content>
</xml>";
if($keyword == "?")
$msgType = "text";
$contentStr = date("Y-m-d H:i:s",time());
$resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr);
echo $resultStr;
echo "";
效果如下: