微信公眾平臺開發（三） 訂閱事件（subscribe）處理

Merlin_Tang發表於2013-06-25
事件

一、簡介

新使用者關注微信公眾平臺，將產生一個訂閱事件，即subscribe事件，預設程式碼中沒有對這一事件進行相應回覆處理。

在新使用者關注公眾平臺後，可能想知道該平臺提供了哪些功能，以及怎樣使用該平臺，通俗一點講就是該平臺的“使用說明書”。

本文將詳細講述對subscribe事件的處理過程，回覆相應資訊提升互動性。

二、思路分析

微信目前提供了五種訊息型別，分別為：

  • 文字訊息（text）；
  • 圖片訊息（image）；
  • 地理位置訊息（location）；
  • 連結訊息（link）；
  • 事件推送（event）；

接收到訊息後，首先需要對訊息型別做出判斷，然後再針對不同型別的訊息做出處理。在事件推送中，事件型別又分為三種，subscribe（訂閱）、unsubscribe（取消訂閱）、CLICK（自定義選單點選事件），還需要再加一次判斷；判斷為subscribe事件後，根據設定好的歡迎訊息，回覆給使用者。

三、判斷訊息型別

$postObj = simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_NOCDATA);
$RX_TYPE = trim($postObj->MsgType);

switch($RX_TYPE)
{
    case "text":
        $resultStr = $this->handleText($postObj);
        break;
    case "event":
        $resultStr = $this->handleEvent($postObj);
        break;
    default:
        $resultStr = "Unknow msg type: ".$RX_TYPE;
        break;
}

說明：

$RX_TYPE = trim($postObj->MsgType); 　　得到訊息型別；

case "text":
　　$resultStr = $this->handleText($postObj); 　　使用handleText() 函式處理文字訊息；

case "event":
　　$resultStr = $this->handleEvent($postObj); 　　使用handleEvent() 函式處理事件推送；

四、判斷事件型別

switch ($object->Event)
{
    case "subscribe":
        $contentStr = "感謝您關注【卓錦蘇州】"."\n"."微訊號：zhuojinsz"."\n"."卓越錦繡，名城蘇州，我們為您提供蘇州本地生活指南，蘇州相關資訊查詢，做最好的蘇州微信平臺。"."\n"."目前平臺功能如下："."\n"."【1】 查天氣，如輸入：蘇州天氣"."\n"."【2】 查公交，如輸入：蘇州公交178"."\n"."【3】 翻譯，如輸入：翻譯I love you"."\n"."【4】 蘇州資訊查詢，如輸入：蘇州觀前街"."\n"."更多內容，敬請期待...";
        break;
    default :
        $contentStr = "Unknow Event: ".$object->Event;
        break;
}

說明：

如果是subscribe事件，設定回覆內容為“感謝您關注【卓錦蘇州】...”；

五、完整程式碼

<?php
/**
  * wechat php test
  */

//define your token
define("TOKEN", "zhuojin");
$wechatObj = new wechatCallbackapiTest();
$wechatObj->responseMsg();
//$wechatObj->valid();

class wechatCallbackapiTest
{
    /*public function valid()
    {
        $echoStr = $_GET["echostr"];

        //valid signature , option
        if($this->checkSignature()){
            echo $echoStr;
            exit;
        }
    }*/

    public function responseMsg()
    {
        //get post data, May be due to the different environments
        $postStr = $GLOBALS["HTTP_RAW_POST_DATA"];

        //extract post data
        if (!empty($postStr)){
                
                $postObj = simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_NOCDATA);
                $RX_TYPE = trim($postObj->MsgType);

                switch($RX_TYPE)
                {
                    case "text":
                        $resultStr = $this->handleText($postObj);
                        break;
                    case "event":
                        $resultStr = $this->handleEvent($postObj);
                        break;
                    default:
                        $resultStr = "Unknow msg type: ".$RX_TYPE;
                        break;
                }
                echo $resultStr;
        }else {
            echo "";
            exit;
        }
    }

    public function handleText($postObj)
    {
        $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(!empty( $keyword ))
        {
            $msgType = "text";
            $contentStr = "Welcome to wechat world!";
            $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr);
            echo $resultStr;
        }else{
            echo "Input something...";
        }
    }

    public function handleEvent($object)
    {
        $contentStr = "";
        switch ($object->Event)
        {
            case "subscribe":
                $contentStr = "感謝您關注【卓錦蘇州】"."\n"."微訊號：zhuojinsz"."\n"."卓越錦繡，名城蘇州，我們為您提供蘇州本地生活指南，蘇州相關資訊查詢，做最好的蘇州微信平臺。"."\n"."目前平臺功能如下："."\n"."【1】 查天氣，如輸入：蘇州天氣"."\n"."【2】 查公交，如輸入：蘇州公交178"."\n"."【3】 翻譯，如輸入：翻譯I love you"."\n"."【4】 蘇州資訊查詢，如輸入：蘇州觀前街"."\n"."更多內容，敬請期待...";
                break;
            default :
                $contentStr = "Unknow Event: ".$object->Event;
                break;
        }
        $resultStr = $this->responseText($object, $contentStr);
        return $resultStr;
    }
    
    public function responseText($object, $content, $flag=0)
    {
        $textTpl = "<xml>
                    <ToUserName><![CDATA[%s]]></ToUserName>
                    <FromUserName><![CDATA[%s]]></FromUserName>
                    <CreateTime>%s</CreateTime>
                    <MsgType><![CDATA[text]]></MsgType>
                    <Content><![CDATA[%s]]></Content>
                    <FuncFlag>%d</FuncFlag>
                    </xml>";
        $resultStr = sprintf($textTpl, $object->FromUserName, $object->ToUserName, time(), $content, $flag);
        return $resultStr;
    }

    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;
        }
    }
}

?>

六、關注

請關注 卓錦蘇州 微信公眾帳號，卓錦蘇州 基於BAE 平臺開發，針對於主流的微信功能進行開發測試。

您可以關注 卓錦蘇州 公眾帳號進行功能測試，以及獲取新的應用開發。

1. 登入微信客戶端，通訊錄 -> 新增朋友 -> 查詢公眾號 -> zhuojinsz，查詢並關注。

2. 掃描二維碼：

卓錦蘇州 功能列表。

 

David Camp

我們永遠相信，分享是一種美德 | We Believe, Great People Share Knowledge...

相關文章