程序師世界是廣大編程愛好者互助、分享、學習的平台,程序師世界有你更精彩!
首頁
編程語言
C語言|JAVA編程
Python編程
網頁編程
ASP編程|PHP編程
JSP編程
數據庫知識
MYSQL數據庫|SqlServer數據庫
Oracle數據庫|DB2數據庫
 程式師世界 >> 編程語言 >> 網頁編程 >> PHP編程 >> 關於PHP編程 >> PHP微信公眾平台開發 - 消息回復的封裝

PHP微信公眾平台開發 - 消息回復的封裝

編輯:關於PHP編程

【PHP微信公眾平台開發系列】

01.配置微信接口
02.公眾平台示例代碼分析
03.訂閱事件(subscribe)處理
04.簡單回復功能開發
05.天氣預報功能開發
06.翻譯功能開發
07.聊天機器人功能開發 
08.自定義菜單功能 
09.數據庫操作
10.消息回復的封裝


本文地址:http://www.phpchina.com/archives/view-43418-1.html
本系列由PHPChina特邀作者@David_Tang供稿,轉載請注明作者信息與本文地址。

一、簡介

微信公眾平台提供了三種消息回復的格式,即文本回復、音樂回復和圖文回復,在這一篇文章中,我們將對這三種消息回復的格式做一下簡單講解,然後封裝成函數,以供讀者使用。

二、思路分析

對於每一個POST請求,開發者在響應包中返回特定xml結構,對該消息進行響應(現支持回復文本、圖文、語音、視頻、音樂)。

三、文本回復

3.1 文本回復xml 結構

復制代碼
 <xml>
 <ToUserName><![CDATA[toUser]]></ToUserName>
 <FromUserName><![CDATA[fromUser]]></FromUserName>
 <CreateTime>12345678</CreateTime>
 <MsgType><![CDATA[text]]></MsgType>
 <Content><![CDATA[content]]></Content>
 </xml>
復制代碼

3.2 結構說明

3.3 具體實施

針對上面給出的xml 結構,我們只需要在對應的位置填上內容,然後格式化輸出就可以了。

說明:

ToUserName 位置上填寫的是$fromUsername = $postObj->FromUserName,就是把消息返回給發送信息過來的用戶,即接收方賬號。

FromUserName 位置上填寫的是$toUsername = $postObj->ToUserName,既是開發者微信號。

這是官方的文本回復,只需實例化它的responseMsg() 方法就可以回復 “Welcome to wechat world!” 消息了。

這裡我們稍做修改,返回fromUsername 和toUsername 消息,便於讀者理解以上的說明。

3.4 測試結果

3.5 封裝成可調用的函數

我們可以將上面的內容封裝成函數,在需要回復文本的地方直接調用,方便簡潔,responseText.func.inc.php 代碼如下。

復制代碼
function _response_text($object,$content){
    $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;
}
復制代碼

這樣,只要傳入$object 和$content,然後在需要回復文本的文件中引入該文件,然後調用 _response_text() 方法,就可以直接回復文本了。 

3.6 測試代碼

3.6.1 在主文件中引入回復文本的函數文件

require_once 'responseText.func.inc.php';

3.6.2 普通消息回復

復制代碼
public function handleText($postObj)
    {
        $keyword = trim($postObj->Content);

        if(!empty( $keyword ))
        {
            $contentStr = "微信公眾平台-文本回復功能源代碼";
            //$resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr);
            $resultStr = _response_text($postObj,$contentStr);
            echo $resultStr;
        }else{
            echo "Input something...";
        }
}
復制代碼

3.6.3 關注時回復

復制代碼
public function handleEvent($object)
    {
        $contentStr = "";
        switch ($object->Event)
        {
            case "subscribe":
                $contentStr = "感謝您關注【卓錦蘇州】"."\n"."微信號:zhuojinsz";
                break;
            default :
                $contentStr = "Unknow Event: ".$object->Event;
                break;
        }
        $resultStr = _response_text($object, $contentStr);
        return $resultStr;
}
復制代碼

3.7 測試結果

回復文本成功。

四、圖文回復

4.1 圖文回復xml 結構

復制代碼
 <xml>
 <ToUserName><![CDATA[toUser]]></ToUserName>
 <FromUserName><![CDATA[fromUser]]></FromUserName>
 <CreateTime>12345678</CreateTime>
 <MsgType><![CDATA[news]]></MsgType>
 <ArticleCount>2</ArticleCount>
 <Articles>
 <item>
 <Title><![CDATA[title1]]></Title> 
 <Description><![CDATA[description1]]></Description>
 <PicUrl><![CDATA[picurl]]></PicUrl>
 <Url><![CDATA[url]]></Url>
 </item>
 <item>
 <Title><![CDATA[title]]></Title>
 <Description><![CDATA[description]]></Description>
 <PicUrl><![CDATA[picurl]]></PicUrl>
 <Url><![CDATA[url]]></Url>
 </item>
 </Articles>
 </xml> 
復制代碼

4.2 結構說明

類似文本回復的格式,只需要在相應的位置填上對應的內容就可以回復圖文信息了。

4.3 具體實施

圖文回復可以是單圖文,也可以是多圖文,這裡我們先以單圖文的案例來引導讀者,然後再引出多圖文。

我們將回復圖文的xml 結構分解成為以下三個結構,圖文頭,圖文體,圖文尾,圖文體就是圖文回復時看到的標題,描述,圖片URL和原文URL。

復制代碼
$newsTplHead = "<xml>
                <ToUserName><![CDATA[%s]]></ToUserName>
                <FromUserName><![CDATA[%s]]></FromUserName>
                <CreateTime>%s</CreateTime>
                <MsgType><![CDATA[news]]></MsgType>
                <ArticleCount>1</ArticleCount>
                <Articles>";
$newsTplBody = "<item>
                <Title><![CDATA[%s]]></Title> 
                <Description><![CDATA[%s]]></Description>
                <PicUrl><![CDATA[%s]]></PicUrl>
                <Url><![CDATA[%s]]></Url>
                </item>";
$newsTplFoot = "</Articles>
                <FuncFlag>0</FuncFlag>
                </xml>";
復制代碼

接下來,我們對三段結構分別插入對應內容:

A. $newsTplHead

$header = sprintf($newsTplHead, $object->FromUserName, $object->ToUserName, time());

B. $newsTplBody

$title = $newsContent['title'];
$desc = $newsContent['description'];
$picUrl = $newsContent['picUrl'];
$url = $newsContent['url'];
$body = sprintf($newsTplBody, $title, $desc, $picUrl, $url);

說明:$newsContent 是從主文件傳入函數的圖文數組。

C. $newsTplFoot

$FuncFlag = 0;
$footer = sprintf($newsTplFoot, $FuncFlag);

然後將三段進行拼接返回就可以回復單條圖文了。

return $header.$body.$footer;

將以上內容寫到一個函數裡,命名為 _response_news() 函數,以供下面調用測試。

4.4 測試代碼

4.4.1 在主文件中引入回復圖文的函數文件

require_once 'responseNews.func.inc.php';

4.4.2 創建數組並傳入

在主文件中,只需要向 _response_news() 函數中傳入一個數組和$postObj 即可。

復制代碼
$record=array(
    'title' =>'山塘街',
    'description' =>'山塘街東起阊門渡僧橋,西至蘇州名勝虎丘山的望山橋,長約七裡,所以蘇州俗語說“七裡山塘到虎丘”...',
    'picUrl' => 'http://thinkshare.duapp.com/images/suzhou.jpg',
    'url' =>'http://mp.weixin.qq.com/mp/appmsg/show?__biz=MjM5NDM0NTEyMg==&appmsgid=10000046&itemidx=1&sign=9e7707d5615907d483df33ee449b378d#wechat_redirect'
);

$resultStr = _response_news($postObj,$record);
echo $resultStr;
復制代碼

4.5 測試結果

點擊進入查看

單圖文回復測試成功。

4.6 多圖文回復

有了上面的引導,讀者應該能夠想到回復多圖文的思路了,就是將多維數組中的值循環放到相應的位置,然後拼接起來就可以了,下面進行講解。 

4.6.1 獲取圖文條數

$bodyCount = count($newsContent);

4.6.2 判斷圖文條數

因為微信限制了回復的圖文消息數為10條以內,所以需要判斷圖文條數,如果小於10條,則圖文數等於原來的圖文數,如果大於等於10條,則強制限制為10條。

$bodyCount = $bodyCount < 10 ? $bodyCount : 10;

4.6.3 組織圖文體

圖文頭和圖文尾和上面單圖文一樣,不再贅述,主要是圖文體的組織。

用foreach 循環出數組的內容並賦予圖文體,並進行拼接:

foreach($newsContent as $key => $value){
    $body .= sprintf($newsTplBody, $value['title'], $value['description'], $value['picUrl'], $value['url']);
}

說明:$newsContent 是從主文件傳入函數的圖文數組。

4.6.4 拼接並返回

return $header.$body.$footer;

將以上內容寫到一個函數裡,命名為 _response_multiNews() 函數,以供下面調用測試。

4.7 測試多圖文

4.7.1 在主文件中引入回復多圖文的函數文件

require_once 'responseMultiNews.func.inc.php';

4.7.2 創建多維數組並傳入

復制代碼
$record[0]=array(
    'title' =>'觀前街',
    'description' =>'觀前街位於江蘇蘇州市區,是成街於清朝時期的百年商業老街,街上老店名店雲集,名聲遠播海內外...',
    'picUrl' => 'http://joythink.duapp.com/images/suzhou.jpg',
    'url' =>'http://mp.weixin.qq.com/mp/appmsg/show?__biz=MjM5NDM0NTEyMg==&appmsgid=10000052&itemidx=1&sign=90518631fd3e85dd1fde7f77c04e44d5#wechat_redirect'
);

......

$record[11]=array(
    'title' =>'平江路',
    'description' =>'平江路位於蘇州古城東北,是一條傍河的小路,北接拙政園,南眺雙塔,全長1606米,是蘇州一條歷史攸久的經典水巷。宋元時候蘇州又名平江,以此名路...',
    'picUrl' => 'http://joythink.duapp.com/images/suzhouScenic/pingjianglu.jpg',
    'url' =>'http://mp.weixin.qq.com/mp/appmsg/show?__biz=MjM5NDM0NTEyMg==&appmsgid=10000056&itemidx=1&sign=ef18a26ce78c247f3071fb553484d97a#wechat_redirect'
);

$resultStr = _response_multiNews($postObj,$record);
echo $resultStr;
復制代碼

4.8 測試多圖文結果

點擊進入查看

測試多圖文成功。

五、音樂回復

微信還提供了一種消息回復的格式,即音樂回復,下面我們編寫程序測試一下。

注意:由於音樂版權的問題,現在很少有回復音樂的API,開放的API 查詢出來的音樂信息也有很多是不正確的。所以在這裡,我們上傳幾首音樂到自己的服務器空間測試。

本地文件:

測試是否能夠正常播放:

5.1 音樂回復xml 結構

復制代碼
 <xml>
 <ToUserName><![CDATA[toUser]]></ToUserName>
 <FromUserName><![CDATA[fromUser]]></FromUserName>
 <CreateTime>12345678</CreateTime>
 <MsgType><![CDATA[music]]></MsgType>
 <Music>
 <Title><![CDATA[TITLE]]></Title>
 <Description><![CDATA[DESCRIPTION]]></Description>
 <MusicUrl><![CDATA[MUSIC_Url]]></MusicUrl>
 <HQMusicUrl><![CDATA[HQ_MUSIC_Url]]></HQMusicUrl>
 </Music>
 </xml>
復制代碼

5.2 結構說明

5.3 具體實施

我們先做一個固定的歌曲回復來引導讀者,然後再引出更高級別的歌曲查詢回復。

5.3.1 在xml 結構的相應位置插入相應數據

復制代碼
<Music>
<Title><![CDATA[Far Away From Home]]></Title>
<Description><![CDATA[Groove Coverage]]></Description>
<MusicUrl><![CDATA[http://thinkshare.duapp.com/music/10001.mp3]]></MusicUrl>
<HQMusicUrl><![CDATA[http://thinkshare.duapp.com/music/10001.mp3]]></HQMusicUrl>
</Music>
復制代碼

5.3.2 測試代碼

$resultStr = _response_music($postObj,$keyword);
echo $resultStr;                    

5.3.3 測試結果

5.4 模擬點歌

有了上面的簡單案例引導,讀者應該可以想到模擬點歌的具體實現了吧,下面就來簡單介紹一下。

思路:將歌曲代碼和對應的歌曲名存入數據庫,用戶輸入歌曲名,在數據庫中找到歌曲名對應的歌曲編號,然後就可以生成MusicUrl 回復用戶了。

5.4.1 創建數據庫

  1. 上一頁:
  2. 下一頁:
Copyright © 程式師世界 All Rights Reserved