我們將使用微信公眾賬號方倍工作室作為講解的例子,二維碼見底部。
本系列教程將引導你完成如下任務:
創建新浪云計算平臺應用啟用微信公眾平臺開發模式基礎接口消息及事件微信公眾平臺PHP SDK微信公眾平臺開發模式原理開發天氣預報功能
第一章 申請服務器資源
創建新浪云計算應用
申請賬號
我們使用SAE新浪云計算平臺作為服務器資源,并且申請PHP環境+MySQL數據庫作為程序運行環境。
申請地址:http://sae.sina.com.cn/ ,使用新浪微博賬號可以直接登錄SAE,登錄后SAE將贈送500個免費云豆。
創建新應用
登錄后點擊頂部【我的首頁】

點擊下側的創建新應用,這時會彈出提示, 禁止放置違法違規內容,點擊繼續創建,彈出如下窗口。

選擇一個未使用的appid,如果老是已經被使用不知道該什么好,就填寫你的QQ號或者手機號吧。
填寫二級域名AppID、應用名稱、驗證碼,開發語言選擇PHP,應用類型選擇web應用。然后點擊創建應用

應用創建成功。并自動跳轉到應用列表中,可以看到已經有剛才創建的CCTV-7

創建版本
選擇CCTV-7右側的應用管理下面的代碼管理,

跳轉到代碼管理

點擊右側的

版本號默認為1,點擊創建,成功后如下圖所示:

到這里,就成功創建了一個域名URL為 http://cctv7.sinaapp.com/ 的應用了。
上傳代碼
將以下代碼復制下來,另存為index.php。必須使用專業的開發編輯軟件操作,例如Notepad++,不要使用Windows自帶的記事本等。
define("TOKEN", "weixin");
$wechatObj = new wechatCallbackapiTest();
if (isset($_GET['echostr'])) {
$wechatObj->valid();
}else{
$wechatObj->responseMsg();
}
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;
}
}
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>
<FuncFlag>0</FuncFlag>
</xml>";
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;
}
}
}
?>
然后將index.php文件壓縮成ZIP格式,注意不能用RAR格式
這樣會生成一個index.zip的文件。或者直接下載方倍已經壓縮好的zip文件 點此下載
在代碼管理界面中,選擇操作按鈕。

選擇上傳代碼包。
點擊上傳文件,選擇剛才壓縮好的index.zip文件,點擊上傳,上傳成功后如下所示,如果上傳有問題,請在Chrome瀏覽器下重試一下。

點擊操作按鈕下的代碼編輯,

我們可以看到index.php已經上傳成功,雙擊可以查看編輯里面的代碼

新浪云應用的創建就成功了。
第二章 啟用開發模式
微信公眾平臺開發模式
高級功能
微信公眾平臺地址:https://mp.weixin.qq.com
登錄微信公眾平臺后臺,選擇高級功能,進入后就看到兩種模式

我們需要先關閉編輯模式。點擊編輯模式的進入

滑動關閉

開發模式
進入開發模式里面

點擊成為開發者

彈出URL和Token填寫框

此處的URL為上篇中介紹的云應用的域名,而Token在index.php中定義為weixin。提交后提示你已成為開發者。

再滑動右上角啟用按鈕。

恭喜,你成功啟用開發模式。
自動回復
在上面的例子中,實現了一個發送“?”就能回復當前時間的功能。
效果如下:

至此,你的微信公眾平臺賬號已經實現自動回復了。
第三章 基礎接口消息及事件
所有賬號在申請之后,都將獲得基礎接口的權限,基礎接口中將包括接收用戶消息,向用戶回復消息,接受事件推送等三種服務。

接收用戶消息
目前普通用戶能向公眾賬號推送五種格式的消息:文本(包括表情)、語音、圖片、視頻、位置、鏈接。
下面就這五種分別詳解如下:
1. 文本(包括表情)
發送文本及表情

2. 圖片
發送圖片

3. 語音
發送語音

4. 視頻
發送視頻

5. 位置
發送位置

6. 鏈接
發送鏈接

向用戶回復消息
目前普通公眾賬號能向用戶推送六種格式的消息:文本、圖文、音樂、圖片、語音、視頻。其中圖文消息包括單條圖文消息和多條圖文消息,展示方式有一點點不同。
下面就這幾種分別詳解如下:【圖片、語音、視頻由于需要用到和高級接口相關的media_id,在本教程中暫不討論。】
1. 文本消息格式
回復文本

2. 圖文消息格式
2.1 單條圖文消息
回復單條圖文

2.2 多圖文消息
回復多圖文

3. 音樂消息
回復音樂消息

接收事件推送
目前用戶在關注和取消關注,以及點擊菜單的時候會自動向公眾平臺發送事件推送消息:
1. 關注事件


第四章 微信公眾平臺PHP SDK
方倍工作室開發了微信公眾平臺的PHPSDK,集成了目前所有消息及事件的接收及發送,代碼如下:
define("TOKEN", "weixin");
$wechatObj = new wechatCallbackapiTest();
if (!isset($_GET['echostr'])) {
$wechatObj->responseMsg();
}else{
$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, 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)){
$this->logger("R ".$postStr);
$postObj = simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_NOCDATA);
$RX_TYPE = trim($postObj->MsgType);
switch ($RX_TYPE)
{
case "event":
$result = $this->receiveEvent($postObj);
break;
case "text":
$result = $this->receiveText($postObj);
break;
case "image":
$result = $this->receiveImage($postObj);
break;
case "location":
$result = $this->receiveLocation($postObj);
break;
case "voice":
$result = $this->receiveVoice($postObj);
break;
case "video":
$result = $this->receiveVideo($postObj);
break;
case "link":
$result = $this->receiveLink($postObj);
break;
default:
$result = "unknown msg type: ".$RX_TYPE;
break;
}
$this->logger("T ".$result);
echo $result;
}else {
echo "";
exit;
}
}
//接收事件消息
private function receiveEvent($object)
{
$content = "";
switch ($object->Event)
{
case "subscribe":
$content = "歡迎關注方倍工作室 ";
$content .= (!empty($object->EventKey))?("/n來自二維碼場景 ".str_replace("qrscene_","",$object->EventKey)):"";
break;
case "unsubscribe":
$content = "取消關注";
break;
case "SCAN":
$content = "掃描場景 ".$object->EventKey;
break;
case "CLICK":
switch ($object->EventKey)
{
case "COMPANY":
$content = "方倍工作室提供互聯網相關產品與服務。";
break;
default:
$content = "點擊菜單:".$object->EventKey;
break;
}
break;
case "LOCATION":
$content = "上傳位置:緯度 ".$object->Latitude.";經度 ".$object->Longitude;
break;
case "VIEW":
$content = "跳轉鏈接 ".$object->EventKey;
break;
default:
$content = "receive a new event: ".$object->Event;
break;
}
$result = $this->transmitText($object, $content);
return $result;
}
//接收文本消息
private function receiveText($object)
{
switch ($object->Content)
{
case "文本":
$content = "這是個文本消息";
break;
case "圖文":
case "單圖文":
$content = array();
$content[] = array("Title"=>"單圖文標題", "Description"=>"單圖文內容", "PicUrl"=>"http://discuz.comli.com/weixin/weather/icon/cartoon.jpg", "Url" =>"http://m.cnblogs.com/?u=txw1958");
break;
case "多圖文":
$content = array();
$content[] = array("Title"=>"多圖文1標題", "Description"=>"", "PicUrl"=>"http://discuz.comli.com/weixin/weather/icon/cartoon.jpg", "Url" =>"http://m.cnblogs.com/?u=txw1958");
$content[] = array("Title"=>"多圖文2標題", "Description"=>"", "PicUrl"=>"http://d.hiphotos.bdimg.com/wisegame/pic/item/f3529822720e0cf3ac9f1ada0846f21fbe09aaa3.jpg", "Url" =>"http://m.cnblogs.com/?u=txw1958");
$content[] = array("Title"=>"多圖文3標題", "Description"=>"", "PicUrl"=>"http://g.hiphotos.bdimg.com/wisegame/pic/item/18cb0a46f21fbe090d338acc6a600c338644adfd.jpg", "Url" =>"http://m.cnblogs.com/?u=txw1958");
break;
case "音樂":
$content = array("Title"=>"最炫民族風", "Description"=>"歌手:鳳凰傳奇", "MusicUrl"=>"http://121.199.4.61/music/zxmzf.mp3", "HQMusicUrl"=>"http://121.199.4.61/music/zxmzf.mp3");
break;
default:
$content = date("Y-m-d H:i:s",time());
break;
}
if(is_array($content)){
if (isset($content[0]['PicUrl'])){
$result = $this->transmitNews($object, $content);
}else if (isset($content['MusicUrl'])){
$result = $this->transmitMusic($object, $content);
}
}else{
$result = $this->transmitText($object, $content);
}
return $result;
}
//接收圖片消息
private function receiveImage($object)
{
$content = array("MediaId"=>$object->MediaId);
$result = $this->transmitImage($object, $content);
return $result;
}
//接收位置消息
private function receiveLocation($object)
{
$content = "你發送的是位置,緯度為:".$object->Location_X.";經度為:".$object->Location_Y.";縮放級別為:".$object->Scale.";位置為:".$object->Label;
$result = $this->transmitText($object, $content);
return $result;
}
//接收語音消息
private function receiveVoice($object)
{
if (isset($object->Recognition) && !empty($object->Recognition)){
$content = "你剛才說的是:".$object->Recognition;
$result = $this->transmitText($object, $content);
}else{
$content = array("MediaId"=>$object->MediaId);
$result = $this->transmitVoice($object, $content);
}
return $result;
}
//接收視頻消息
private function receiveVideo($object)
{
$content = array("MediaId"=>$object->MediaId, "ThumbMediaId"=>$object->ThumbMediaId, "Title"=>"", "Description"=>"");
$result = $this->transmitVideo($object, $content);
return $result;
}
//接收鏈接消息
private function receiveLink($object)
{
$content = "你發送的是鏈接,標題為:".$object->Title.";內容為:".$object->Description.";鏈接地址為:".$object->Url;
$result = $this->transmitText($object, $content);
return $result;
}
//回復文本消息
private function transmitText($object, $content)
{
$textTpl = "<xml>
<ToUserName><![CDATA[%s]]></ToUserName>
<FromUserName><![CDATA[%s]]></FromUserName>
<CreateTime>%s</CreateTime>
<MsgType><![CDATA[text]]></MsgType>
<Content><![CDATA[%s]]></Content>
</xml>";
$result = sprintf($textTpl, $object->FromUserName, $object->ToUserName, time(), $content);
return $result;
}
//回復圖片消息
private function transmitImage($object, $imageArray)
{
$itemTpl = "<Image>
<MediaId><![CDATA[%s]]></MediaId>
</Image>";
$item_str = sprintf($itemTpl, $imageArray['MediaId']);
$textTpl = "<xml>
<ToUserName><![CDATA[%s]]></ToUserName>
<FromUserName><![CDATA[%s]]></FromUserName>
<CreateTime>%s</CreateTime>
<MsgType><![CDATA[image]]></MsgType>
$item_str
</xml>";
$result = sprintf($textTpl, $object->FromUserName, $object->ToUserName, time());
return $result;
}
//回復語音消息
private function transmitVoice($object, $voiceArray)
{
$itemTpl = "<Voice>
<MediaId><![CDATA[%s]]></MediaId>
</Voice>";
$item_str = sprintf($itemTpl, $voiceArray['MediaId']);
$textTpl = "<xml>
<ToUserName><![CDATA[%s]]></ToUserName>
<FromUserName><![CDATA[%s]]></FromUserName>
<CreateTime>%s</CreateTime>
<MsgType><![CDATA[voice]]></MsgType>
$item_str
</xml>";
$result = sprintf($textTpl, $object->FromUserName, $object->ToUserName, time());
return $result;
}
//回復視頻消息
private function transmitVideo($object, $videoArray)
{
$itemTpl = "<Video>
<MediaId><![CDATA[%s]]></MediaId>
<ThumbMediaId><![CDATA[%s]]></ThumbMediaId>
<Title><![CDATA[%s]]></Title>
<Description><![CDATA[%s]]></Description>
</Video>";
$item_str = sprintf($itemTpl, $videoArray['MediaId'], $videoArray['ThumbMediaId'], $videoArray['Title'], $videoArray['Description']);
$textTpl = "<xml>
<ToUserName><![CDATA[%s]]></ToUserName>
<FromUserName><![CDATA[%s]]></FromUserName>
<CreateTime>%s</CreateTime>
<MsgType><![CDATA[video]]></MsgType>
$item_str
</xml>";
$result = sprintf($textTpl, $object->FromUserName, $object->ToUserName, time());
return $result;
}
//回復圖文消息
private function transmitNews($object, $newsArray)
{
if(!is_array($newsArray)){
return;
}
$itemTpl = " <item>
<Title><![CDATA[%s]]></Title>
<Description><![CDATA[%s]]></Description>
<PicUrl><![CDATA[%s]]></PicUrl>
<Url><![CDATA[%s]]></Url>
</item>
";
$item_str = "";
foreach ($newsArray as $item){
$item_str .= sprintf($itemTpl, $item['Title'], $item['Description'], $item['PicUrl'], $item['Url']);
}
$newsTpl = "<xml>
<ToUserName><![CDATA[%s]]></ToUserName>
<FromUserName><![CDATA[%s]]></FromUserName>
<CreateTime>%s</CreateTime>
<MsgType><![CDATA[news]]></MsgType>
<Content><![CDATA[]]></Content>
<ArticleCount>%s</ArticleCount>
<Articles>
$item_str</Articles>
</xml>";
$result = sprintf($newsTpl, $object->FromUserName, $object->ToUserName, time(), count($newsArray));
return $result;
}
//回復音樂消息
private function transmitMusic($object, $musicArray)
{
$itemTpl = "<Music>
<Title><![CDATA[%s]]></Title>
<Description><![CDATA[%s]]></Description>
<MusicUrl><![CDATA[%s]]></MusicUrl>
<HQMusicUrl><![CDATA[%s]]></HQMusicUrl>
</Music>";
$item_str = sprintf($itemTpl, $musicArray['Title'], $musicArray['Description'], $musicArray['MusicUrl'], $musicArray['HQMusicUrl']);
$textTpl = "<xml>
<ToUserName><![CDATA[%s]]></ToUserName>
<FromUserName><![CDATA[%s]]></FromUserName>
<CreateTime>%s</CreateTime>
<MsgType><![CDATA[music]]></MsgType>
$item_str
</xml>";
$result = sprintf($textTpl, $object->FromUserName, $object->ToUserName, time());
return $result;
}
//日志記錄
private function logger($log_content)
{
if(isset($_SERVER['HTTP_APPNAME'])){ //SAE
sae_set_display_errors(false);
sae_debug($log_content);
sae_set_display_errors(true);
}else if($_SERVER['REMOTE_ADDR'] != "127.0.0.1"){ //LOCAL
$max_size = 10000;
$log_filename = "log.xml";
if(file_exists($log_filename) and (abs(filesize($log_filename)) > $max_size)){unlink($log_filename);}
file_put_contents($log_filename, date('H:i:s')." ".$log_content."/r/n", FILE_APPEND);
}
}
}
?>
在公眾賬號中回復以下文字,你將得到和上一章一樣的回復內容。
還可以嘗試以下操作,體驗一下其他消息
發送一張圖片給公眾賬號
發送一段語音給公眾賬號
發送一段視頻給公眾賬號
發送位置信息給公眾賬號
發送收藏中的鏈接給公眾賬號第五章 微信公眾平臺開發模式原理分析
在體驗了上一節的各種功能之后,我們只是知其然,這一節里面,將介紹在上面的基礎上介紹微信公眾平臺收發消息機制及原理,這是知其所以然。
開發模式成為開發者時的消息校驗原理
在開發者首次提交驗證申請時,微信服務器將發送GET請求到填寫的URL上,并且帶上四個參數(signature、timestamp、nonce、echostr),開發者通過對簽名(即signature)的效驗,來判斷此條消息的真實性。
此后,每次開發者接收用戶消息的時候,微信也都會帶上前面三個參數(signature、timestamp、nonce)訪問開發者設置的URL,開發者依然通過對簽名的效驗判斷此條消息的真實性。效驗方式與首次提交驗證申請一致。
| 參數 | 描述 |
|---|---|
| signature | 微信加密簽名,signature結合了開發者填寫的token參數和請求中的timestamp參數、nonce參數。 |
| timestamp | 時間戳 |
| nonce | 隨機數 |
| echostr | 隨機字符串 |
加密/校驗流程如下:
1. 將token、timestamp、nonce三個參數進行字典序排序
2. 將三個參數字符串拼接成一個字符串進行sha1加密
3. 開發者獲得加密后的字符串可與signature對比,標識該請求來源于微信啟用接口是由代碼中的checkSignature()函數來實現校驗的。如果對這一原理難以理解,可以暫時不用深究,繼續看下面。
成為開發者后消息收發時的原理
再來看下這個圖,當用戶發送一個“?”時,系統回復了一個時間

這一原理的消息流程圖如下所示。

從上圖可以看出,用戶在發送一個?后,微信服務器將組裝一個消息發送給我們自己的服務器,自己的服務器然后回復一個時間,并且將該時間也按一定的規則組裝,回復給公眾賬號,公眾賬號再回復給用戶,在這個收發過程中,發送方和接收方進行了調換(ToUserName和FromUserName值互換),收發都是以xml格式在后臺進行傳輸的,
所以掌握各種消息類型的收發就是進行微信公眾平臺開發的基礎!
下面對前面所述的各種消息類型講解其XML數據包的格式。
各種收發消息的XML數據包分析
接收消息
1. 文本(包括表情)
發送文本及表情

文字后臺格式:
表情后臺格式
XML格式講解
可以看出,文本和表情的消息類型均為文本
2. 圖片
發送圖片

后臺格式:
XML格式講解
3. 語音
發送語音

后臺格式:
XML格式講解
附:AMR接口簡介
全稱Adaptive Multi-Rate,主要用于移動設備的音頻,壓縮比比較大,但相對其他的壓縮格式質量比較差,由于多用于人聲,通話,效果還是很不錯的。
4. 視頻
發送視頻

后臺格式:
XML格式講解
5. 位置
發送位置

后臺格式:
XML格式講解
6. 鏈接
發送鏈接

后臺格式:
XML格式講解
發送消息
只介紹三種格式的消息:文本、圖文、音樂。其中圖文消息包括單條圖文消息和多條圖文消息,展示方式有一點點不同。
1. 文本消息格式
回復文本

后臺格式:
XML格式講解
2. 圖文消息格式
2.1 單條圖文消息
回復單條圖文


后臺格式:
2.2 多圖文消息
回復多圖文


后臺數據格式