萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 微信公眾平台開發核心類完整實現與解析

概述

微信公眾平台開發的核心在於「接收推送」與「被動回覆」。本文提供一個完整、可直接使用的 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'];
    }
}

關鍵點深度解析

1. 構造函數的三大職責

  • 簽名驗證:確保請求來自微信服務器,防止偽造。
  • 首次驗證響應:微信接入時會發送 GET 請求攜帶 echostr,需原樣返回。
  • 消息解析:讀取 php://input 獲取原始 XML,轉為關聯數組供後續業務使用。

2. XML 組裝與 CDATA 處理

微信要求非數值字段必須用 CDATA 包裹。data2xml() 通過 dom_import_simplexml 獲取 DOM 節點,再調用 createCDATASection 實現,兼容巢狀結構(如 Articles)。

3. 圖文消息的 10 條限制

代碼中 if ($key >= 10) break; 直接截斷,實際開發建議在業務層預先截取,避免靜默丟失數據。

4. 安全性考量

  • 構造函數中 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');
?>

擴展建議

  • 引入 PSR-4 自動加載,將類放入獨立命名空間。
  • 增加事件處理分發器(關注、掃碼、菜單點擊等)。
  • 整合 easywechat 等成熟 SDK 以獲得更完善的功能(客服消息、模板消息、素材管理等)。
copyright © 萬盛學電腦網 all rights reserved