微信公衆平臺開發【接收消息】接收普通消息

原創 小易Smalle 2020-02-20 21:21

當普通微信用戶向公衆賬號發消息時，微信服務器將POST消息的XML數據包到開發者填寫的URL上。服務器在解析此數據包，獲取相關參數的值從而做出回覆。接收普通消息主要包括：文本消息、圖片消息、語音消息、視頻消息、小視頻消息、地理位置消息、鏈接消息。XML數據包結構和相關參數如下：

1、文本消息

 <xml>
 <ToUserName><![CDATA[toUser]]></ToUserName>
 <FromUserName><![CDATA[fromUser]]></FromUserName> 
 <CreateTime>1348831860</CreateTime>
 <MsgType><![CDATA[text]]></MsgType>
 <Content><![CDATA[this is a test]]></Content>
 <MsgId>1234567890123456</MsgId>
 </xml>
參數				描述
ToUserName		開發者微信號
FromUserName	 發送方帳號（一個OpenID）
CreateTime	 	消息創建時間 （整型）
MsgType	 		text
Content	 		文本消息內容
MsgId	 		消息id，64位整型

那麼這些參數該如何獲取呢，示例代碼如下：

index.php（完整代碼下載）

<?php
/**
  * 作者：smalle
  * 網址：http://blog.csdn.net/oldinaction
  * 微信公衆號：smallelife
  */

//定義 token
define("TOKEN", "smalle");
//實例化對象
$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;
		}
	}

	public function responseMsg()
	{
		$postStr = $GLOBALS["HTTP_RAW_POST_DATA"];  

		if (!empty($postStr)){  
			libxml_disable_entity_loader(true);//安全防護  
			$postObj = simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_NOCDATA);  
			$fromUsername = $postObj->FromUserName;  
			$toUsername = $postObj->ToUserName;
			$createTime = $postObj->CreateTime;
			$msgType = $postObj->MsgType;
			$content = $postObj->Content;
			$msgId = $postObj->MsgId;
			if($msgType == 'text'){
				$textTpl = "<xml>  
						<ToUserName><![CDATA[%s]]></ToUserName>  
						<FromUserName><![CDATA[%s]]></FromUserName>  
						<CreateTime>%s</CreateTime>  
						<MsgType><![CDATA[text]]></MsgType>  
						<Content><![CDATA[%s]]></Content>  
						<FuncFlag>0</FuncFlag>  
						</xml>";
				$time = time();
				$contentStr = "您發的是消息包含以下信息：\n發信人OpenID：".$fromUsername."\n收信人微信號：".$toUsername."\n發信時間：".$createTime."\n消息類型：".$msgType."\n消息內容：".$content."\n消息ID：".$msgId;  
				$resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $contentStr);  
				echo $resultStr;  
			}else{
				$textTpl = "<xml>  
						<ToUserName><![CDATA[%s]]></ToUserName>  
						<FromUserName><![CDATA[%s]]></FromUserName>  
						<CreateTime>%s</CreateTime>  
						<MsgType><![CDATA[text]]></MsgType>  
						<Content><![CDATA[%s]]></Content>  
						<FuncFlag>0</FuncFlag>  
						</xml>";
				$time = time();
				$contentStr = "您發的消息類型不是文本。而是".$msgType;
				$resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $contentStr);  
				echo $resultStr;  
			}

		}
	}
		
	private function checkSignature()
	{
		if (!defined("TOKEN")) {
			throw new Exception('TOKEN is not defined!');
		}
		$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;
		}
	}
}

?>
效果預覽：


代碼分析：

  • 第32-42行【$postStr = $GLOBALS["HTTP_RAW_POST_DATA"];......$msgId = $postObj->MsgId;】：實現獲取用戶發送過來的消息數據。
  • 第43-55行【if($msgType == 'text'){......echo $resultStr;】：實現的是被動回覆文本消息給用戶

2、圖片消息

使用方法同文本消息，此處不再贅述，不懂得話可以在博文後面留言。

 <xml>
 <ToUserName><![CDATA[toUser]]></ToUserName>
 <FromUserName><![CDATA[fromUser]]></FromUserName>
 <CreateTime>1348831860</CreateTime>
 <MsgType><![CDATA[image]]></MsgType>
 <PicUrl><![CDATA[http://blog.csdn.net/oldinaction]]></PicUrl>
 <MediaId><![CDATA[media_id]]></MediaId>
 <MsgId>1234567890123456</MsgId>
 </xml>
參數				描述
ToUserName		開發者微信號
FromUserName	發送方帳號（一個OpenID）
CreateTime		消息創建時間 （整型）
MsgType	 		image
PicUrl	 		圖片鏈接
MediaId	 		圖片消息媒體id，可以調用多媒體文件下載接口拉取數據。
MsgId	 		消息id，64位整型

3、語音消息

使用方法同文本消息，此處不再贅述，不懂得話可以在博文後面留言。

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1357290913</CreateTime>
<MsgType><![CDATA[voice]]></MsgType>
<MediaId><![CDATA[media_id]]></MediaId>
<Format><![CDATA[Format]]></Format>
<MsgId>1234567890123456</MsgId>
</xml>
參數				描述
ToUserName		開發者微信號
FromUserName	發送方帳號（一個OpenID）
CreateTime		消息創建時間 （整型）
MsgType	 		語音爲voice
MediaId	 		語音消息媒體id，可以調用多媒體文件下載接口拉取數據。
Format	 		語音格式，如amr，speex等
MsgID	 		消息id，64位整型

請注意，開通語音識別後，用戶每次發送語音給公衆號時，微信會在推送的語音消息XML數據包中，增加一個Recongnition字段（注：由於客戶端緩存，開發者開啓或者關閉語音識別功能，對新關注者立刻生效，對已關注用戶需要24小時生效。開發者可以重新關注此帳號進行測試）。開啓語音識別後的語音XML數據包如下：

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1357290913</CreateTime>
<MsgType><![CDATA[voice]]></MsgType>
<MediaId><![CDATA[media_id]]></MediaId>
<Format><![CDATA[Format]]></Format>
<Recognition><![CDATA[騰訊微信團隊]]></Recognition>
<MsgId>1234567890123456</MsgId>
</xml>
多出的字段中，Format爲語音格式，一般爲amr，Recognition爲語音識別結果，使用UTF8編碼。

4、視頻消息

使用方法同文本消息，此處不再贅述，不懂得話可以在博文後面留言。

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1357290913</CreateTime>
<MsgType><![CDATA[video]]></MsgType>
<MediaId><![CDATA[media_id]]></MediaId>
<ThumbMediaId><![CDATA[thumb_media_id]]></ThumbMediaId>
<MsgId>1234567890123456</MsgId>
</xml>
參數				描述
ToUserName		開發者微信號
FromUserName	發送方帳號（一個OpenID）
CreateTime		消息創建時間 （整型）
MsgType	 		視頻爲video
MediaId	 		視頻消息媒體id，可以調用多媒體文件下載接口拉取數據。
ThumbMediaId		視頻消息縮略圖的媒體id，可以調用多媒體文件下載接口拉取數據。
MsgId	 		消息id，64位整型

5、小視頻消息

使用方法同文本消息，此處不再贅述，不懂得話可以在博文後面留言。

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1357290913</CreateTime>
<MsgType><![CDATA[shortvideo]]></MsgType>
<MediaId><![CDATA[media_id]]></MediaId>
<ThumbMediaId><![CDATA[thumb_media_id]]></ThumbMediaId>
<MsgId>1234567890123456</MsgId>
</xml>
參數				描述
ToUserName		開發者微信號
FromUserName	發送方帳號（一個OpenID）
CreateTime		消息創建時間 （整型）
MsgType	 		小視頻爲shortvideo
MediaId	 		視頻消息媒體id，可以調用多媒體文件下載接口拉取數據。
ThumbMediaId		視頻消息縮略圖的媒體id，可以調用多媒體文件下載接口拉取數據。
MsgId	 		消息id，64位整型

6、地理位置消息

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1351776360</CreateTime>
<MsgType><![CDATA[location]]></MsgType>
<Location_X>23.134521</Location_X>
<Location_Y>113.358803</Location_Y>
<Scale>20</Scale>
<Label><![CDATA[位置信息]]></Label>
<MsgId>1234567890123456</MsgId>
</xml> 
參數				描述
ToUserName		開發者微信號
FromUserName	發送方帳號（一個OpenID）
CreateTime		消息創建時間 （整型）
MsgType	 		location
Location_X		地理位置維度
Location_Y		地理位置經度
Scale	 		地圖縮放大小
Label	 		地理位置信息
MsgId	 		消息id，64位整型

當用戶給公衆賬號發送位置時，便可以獲取相應的地理位置信息。部分示例代碼如下：

index.php（完整代碼下載）

$postStr = $GLOBALS["HTTP_RAW_POST_DATA"];  

if (!empty($postStr)){  
	libxml_disable_entity_loader(true);//安全防護  
	$postObj = simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_NOCDATA);  
	$fromUsername = $postObj->FromUserName;  
	$toUsername = $postObj->ToUserName;
	$msgType = $postObj->MsgType;
	$j = $postObj->Location_Y;//經度
	$w = $postObj->Location_X;//緯度
	$label = $postObj->Label;//地理位置信息
	if($msgType == 'location'){
		$textTpl = "<xml>  
				<ToUserName><![CDATA[%s]]></ToUserName>  
				<FromUserName><![CDATA[%s]]></FromUserName>  
				<CreateTime>%s</CreateTime>  
				<MsgType><![CDATA[text]]></MsgType>  
				<Content><![CDATA[%s]]></Content>  
				<FuncFlag>0</FuncFlag>  
				</xml>";
		$time = time();
		$contentStr = "您的位置信息如下：\n經度：".$j."\n緯度：".$w."\n地理位置信息：".$label;
		$resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $contentStr);  
		echo $resultStr;  
	}else{
		echo '';
	}

}
效果展示：

現在你可能覺得這一小串數字沒什麼用，到後面我會分享一些關於位置信息的小案例，那個時候就起作用了。


7、鏈接消息

使用方法同文本消息，此處不再贅述，不懂得話可以在博文後面留言。

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1351776360</CreateTime>
<MsgType><![CDATA[link]]></MsgType>
<Title><![CDATA[公衆平臺官網鏈接]]></Title>
<Description><![CDATA[公衆平臺官網鏈接]]></Description>
<Url><![CDATA[url]]></Url>
<MsgId>1234567890123456</MsgId>
</xml>
參數				描述
ToUserName		接收方微信號
FromUserName	發送方微信號，若爲普通用戶，則是一個OpenID
CreateTime		消息創建時間
MsgType	 		消息類型，link
Title	 			消息標題
Description		消息描述
Url	 			消息鏈接
MsgId	 		消息id，64位整型




===================================微笑微笑微笑===================================

關注【Smalle】【微信公衆號：smallelife】              微笑             捐贈【Smalle】【微信公衆號：smallelife】

關注就有豪禮相送哦，羨慕源碼、羨慕工具、羨慕文檔應有盡有      微笑       你的掃碼便是我前進的動力，羨慕掃碼、羨慕掃碼、羨慕掃碼

===================================微笑微笑微笑===================================

                                     


小易Smalle
發佈了36 篇原創文章 · 獲贊 15 · 訪問量 17萬+
私信 關注
發表評論
所有評論
還沒有人評論，想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章

微信公衆號前後端分離項目網頁授權登錄問題

問題描述 微信公衆號網頁授權登錄，因爲是前後端項目，所以跳轉是在前端做的，所以回調地址配置的是前端頁面地址，例如：xxx/callback?redirect_url=需要登錄才能訪問的頁面地址，問題發生在需要登錄才能訪問的頁面地址

来了就走下去 2020-07-08 09:38:31

微信開放平臺應用申請

1、註冊賬號 使用郵箱註冊賬號，這裏吐糟一下，微信不同平臺得使用不同的郵箱。 2、填寫賬號信息 企業主體信息填寫 3、企業認證 申請認證，提交企業信息和財務信息，內地每年認證花費300元 4、申請應用 認證通過後，再申請應用，申請

来了就走下去 2020-07-08 09:38:20

PC端瀏覽器模擬微信瀏覽器環境

前提 http訪問； 通過cookie或本地存儲了用戶信息的頁面 原理 針對需要微信授權才能訪問的頁面，如果網頁邏輯判斷到當前並沒有用戶信息，即cookie中沒有記錄用戶信息，那麼會重定向到微信授權地址，由於訪問微信授權地址的

来了就走下去 2020-07-08 09:38:20

微信第三方平臺開發-從開始到測試

一：說明 *當前文檔比較簡陋，如果有其他方法不明確可以留言。 項目框架：.net freamwork 4.6.1 開發工具：vs2019 本次開發使用了Senparc.Weixin組件，地址：https://github.com/Jeff

a123_z 2020-07-08 08:40:05

微信生成二維碼

生成帶參二維碼： 1、臨時二維碼，是有過期時間的，最長可以設置爲在二維碼生成後的30天（即2592000秒）後過期，但能夠生成較多數量。臨時二維碼主要用於帳號綁定等不要求二維碼永久保存的業務場景 2、永久二維碼，是無過期時間的，但數量

gang_strong 2020-07-07 10:07:55

微信公衆號回調接口HttpServletRequest 操作

微信公衆號回調接口，解析參數 1、獲取request 參數 Map<?, ?> parameterMap = request.getParameterMap(); 2、map 轉json JSONObject requestPar

gang_strong 2020-07-07 10:07:53

微信對接廣發銀行（銀行服務商）

微信支付對接銀行服務商 前言 大家好，我是許RR。最近爲公司的聚合支付平臺對接廣發銀行（廣東發展銀行）服務商的支付通道，遇到很多問題，特此記錄一下 概念 估計很多17年前做微信支付的朋友會對現在的微信支付模式感覺到奇怪，比如出現了

许RR 2020-07-06 14:38:48

微信小程序引用外部文件找不到文件報錯問題

util.js目錄代碼      （module.exports 這一步非常重要） //util.js //封裝的函數 function count(str) { console.log(str) } //轉化成小程序模板語言 這一

_speed 2020-07-06 10:47:07

微信小程序開發——微信授權登錄

開發工具 前端 微信小程序開發工具 後端 idea 2018.3 +mysql8.0 後端技術棧 ----Springboot+mybatis ps：因爲我是後端開發 所以只能寫後端。。 開發階段 一 準備賬

Hobo_Cinsc 2020-07-05 15:57:11

[轉載]onReachBottom 事件爲什麼不能觸發? （微信小程序）

如果頁面是自動生成的，下面還有一個onReachBottom事件會覆蓋掉上面自定義的事件。 參考如下：     https://developers.weixin.qq.com/community/develop/doc/000c60ff

jamey8383 2020-07-04 18:17:14

微信小程序支付異常：requestPayment:fail no permission (微信小程序)

先參考了這篇文章，但是我的appID原來也是正確的，點了修改再重新複製粘貼了一遍，就搞定了！ https://www.cnblogs.com/han-1034683568/p/10330179.html 今天在調試微信小程序支付時碰到了這

jamey8383 2020-07-04 18:17:14

綁定並阻止事件冒泡 微信小程序

https://developers.weixin.qq.com/miniprogram/dev/framework/view/wxml/event.html   除 bind 外，也可以用 catch 來綁定事件。與 bind 不同， 

jamey8383 2020-07-04 18:17:13

Java代碼修改微信公衆號菜單

前言 相信大家在微信公衆號開發中都會遇到這樣一個問題：啓用服務器配置後，原先設置的公衆號菜單都失效了，那麼此時只能使用代碼創建公衆號菜單了，代碼如下：          個人微信公衆號：小諸葛的博客，使用過程中如有疑問，可在公衆號後臺留言

Long_Yi_1994 2020-07-04 14:25:03

獲取服務器資源(二)

微信公衆平臺需要有自己的服務器資源，而新浪SAE恰好能給我們提供這樣的資源。 1.申請新浪SAE  地址是http://sae.sina.com.cn/?m=user&a=reg; 2.填寫雲App資料，我這裏已經填寫完畢 3.雲A

Python绿色通道 2020-07-04 03:52:02

微信的玩法（終端零售）

微信比較適合零售企業來玩基於微信幾個特性：1.微信用戶數巨大已達4億並以幾何數增長。2.微信是一個用戶粘性很大的工具，用戶每天會打開多次，這給企業增加了銷售機會。3.微信的朋友圈分享等功能加上好友口碑效應可以極大延伸企業商品的被購買機會。

david-sui 2020-07-02 20:53:52