微信公眾平台開發的核心在於「接收推送」與「被動回覆」。本文提供一個完整、可直接使用的 Wechat 類,涵蓋簽名驗證、XML 解析、多類型消息回覆(文本、圖文、音樂)及 XML 組裝,並對關鍵邏輯進行深度解析。
<?php
class Wechat {
/** @var array 微信推送/回覆數據 */
private $data = [];
/**
* 構造函數:驗證簽名、處理首次驗證請求、解析用戶消息
* @param string $token 微信後台配置的 Token
*/
public function __construct($token) {
// 1. 簽名驗證失敗直接退出
$this->auth($token) || exit;
// 2. 首次接入驗證:直接輸出 echostr
if (!empty($_GET['echostr'])) {
exit($_GET['echostr']);
}
// 3. 解析用戶發送的 XML 消息
try {
$xmlStr = file_get_contents('php://input');
$xml = new SimpleXMLElement($xmlStr);
if (!$xml) exit;
foreach ($xml as $key => $value) {
$this->data[$key] = strval($value);
}
} catch (Exception $e) {
// 解析失敗靜默退出,避免洩露錯誤信息
}
}
/** 獲取解析後的請求數組 */
public function request() {
return $this->data;
}
/**
* 回覆消息給微信服務器
* @param mixed $content 回覆內容(文本為字符串,圖文/音樂為數組)
* @param string $type 消息類型:text, news, music
* @param int $flag 是否星標
*/
public function response($content, $type = 'text', $flag = 0) {
// 基礎字段
$this->data = [
'ToUserName' => $this->data['FromUserName'],
'FromUserName' => $this->data['ToUserName'],
'CreateTime' => time(),
'MsgType' => $type,
];
// 根據類型填充具體內容
$this->$type($content);
$this->data['FuncFlag'] = $flag;
// 組裝 XML 並輸出
$xml = new SimpleXMLElement(' ');
$this->data2xml($xml, $this->data);
exit($xml->asXML());
}
/** 文本消息 */
private function text($content) {
$this->data['Content'] = $content;
}
/** 音樂消息 */
private function music($music) {
list($this->data['Music']['Title'],
$this->data['Music']['Description'],
$this->data['Music']['MusicUrl'],
$this->data['Music']['HQMusicUrl']) = $music;
}
/** 圖文消息(最多 10 條) */
private function news($news) {
$articles = [];
foreach ($news as $key => $value) {
if ($key >= 10) break; // 微信限制最多 10 條
list($articles[$key]['Title'],
$articles[$key]['Description'],
$articles[$key]['PicUrl'],
$articles[$key]['Url']) = $value;
}
$this->data['ArticleCount'] = count($articles);
$this->data['Articles'] = $articles;
}
/**
* 遞歸將數組轉為 XML(支援 CDATA)
*/
private function data2xml($xml, $data, $item = 'item') {
foreach ($data as $key => $value) {
is_numeric($key) && $key = $item;
if (is_array($value) || is_object($value)) {
$child = $xml->addChild($key);
$this->data2xml($child, $value, $item);
} else {
if (is_numeric($value)) {
$xml->addChild($key, $value);
} else {
$child = $xml->addChild($key);
$node = dom_import_simplexml($child);
$node->appendChild($node->ownerDocument->createCDATASection($value));
}
}
}
}
/**
* 簽名驗證(SHA1)
* @return bool
*/
private function auth($token) {
if (empty($_GET['signature'])) return false;
$tmpArr = [$_GET['timestamp'], $_GET['nonce'], $token];
sort($tmpArr, SORT_STRING);
$signature = sha1(implode($tmpArr));
return $signature === $_GET['signature'];
}
}
echostr,需原樣返回。php://input 獲取原始 XML,轉為關聯數組供後續業務使用。微信要求非數值字段必須用 CDATA 包裹。data2xml() 通過 dom_import_simplexml 獲取 DOM 節點,再調用 createCDATASection 實現,兼容巢狀結構(如 Articles)。
代碼中 if ($key >= 10) break; 直接截斷,實際開發建議在業務層預先截取,避免靜默丟失數據。
try-catch 吞掉異常,生產環境建議記錄日誌。MsgType 做白名單過濾,若擴展新類型需謹慎。<?php
require 'Wechat.php';
$token = 'your_token_here';
$wechat = new Wechat($token);
// 1. 獲取用戶發送的內容
$request = $wechat->request();
// $request['Content'] 為用戶發送的文本
// $request['Event'] 為事件類型(subscribe, CLICK 等)
// 2. 業務邏輯處理(此處略)
$replyContent = '收到:' . $request['Content'];
// 3. 回覆文本消息
$wechat->response($replyContent, 'text');
// 回覆圖文消息範例
$articles = [
['標題1', '描述1', 'https://example.com/img1.jpg', 'https://example.com/link1'],
['標題2', '描述2', 'https://example.com/img2.jpg', 'https://example.com/link2'],
];
$wechat->response($articles, 'news');
?>
easywechat 等成熟 SDK 以獲得更完善的功能(客服消息、模板消息、素材管理等)。