首頁
編程語言
C語言|JAVA編程
Python編程
網頁編程
ASP編程|PHP編程
JSP編程
數據庫
MYSQL數據庫|SqlServer數據庫
Oracle數據庫|DB2數據庫
您现在的位置: 程式碼之家 >> 編程語言 >  >> 網頁程式設計 >> PHP 程式設計 >> PHP 綜合知識

PHP 開發微信公眾平台智能回復功能完整教程

     編輯:PHP 綜合知識

微信公眾平台開發前言

自微信推出以來,其生態系統迅速擴張,支付功能的加入更將其推向不可撼動的高度。越來越多的個人和企業申請訂閱號或服務號,開發者也紛紛投入微信公眾平台接口開發。本文將詳細講解如何使用 PHP 實現微信公眾平台的智能回復功能,從賬號申請、服務器配置到具體代碼實現,提供完整的開發指南。

一、賬號申請與模式選擇

首先前往 微信公眾平台 申請賬號。個人僅能申請訂閱號(僅基礎功能),企業可同時申請訂閱號和服務號。兩者主要區別:

  • 訂閱號:每天可群發 1 條消息,需微信認證(企業資質,300 元/次)才能自定義菜單
  • 服務號:每月可群發 1 條消息,默認擁有自定義菜單,認證後升級高級功能

個人開發者通常選擇訂閱號,提交手持身份證照片後約一天完成審核。

二、開發模式啟用與服務器配置

審核通過後,進入公眾平台 → 功能 → 高級功能,關閉編輯模式,開啟開發模式。下載官方 Demo(wx_sample.php),上傳至服務器(如根目錄),然後在開發模式配置中填寫:

  • URL:你的接口地址(如 https://www.example.com/wx_sample.php)
  • Token:自定義字符串(需與代碼中定義的一致,默認 weixin)
  • EncodingAESKey:可手動填寫或隨機生成

三、核心代碼解析

官方 Demo 主要包含兩個核心方法:valid() 用於驗證服務器有效性,responseMsg() 用於處理消息回復。初次配置時需啟用 valid() 通過驗證,之後註釋掉它,啟用 responseMsg() 實現智能回復。

<?php
/** 
 * wechat php test 
 */
// 定義 Token
define("TOKEN", "weixin");
$wechatObj = new wechatCallbackapiTest();
// $wechatObj->valid();  // 驗證通過後註釋掉
$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)){
            $postObj = simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_NOCDATA);
            $fromUsername = $postObj->FromUserName;
            $toUsername = $postObj->ToUserName;
            $keyword = trim($postObj->Content);
            $time = time();
            $MsgType = $postObj->MsgType;
            
            $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($MsgType != 'event') {
                if(!empty($keyword)) {
                    $msgType = "text";
                    $contentStr = "Welcome to wechat world!";
                    $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr);
                    echo $resultStr;
                } else {
                    echo "Input something...";
                }
            } else {
                // 關注事件處理
                $msgType = "text";
                $contentStr = "感謝您關注 AndyYang 個人博客微信小助手。\r\n".
                    "回復【1】返回兩篇最新文章\r\n".
                    "回復【2】返回兩篇人氣文章\r\n".
                    "回復【3】返回兩篇熱評文章\r\n".
                    "回復【4】返回兩篇最新技術文章\r\n".
                    "回復【5】返回兩篇最新寫作文章\r\n".
                    "回復其他返回搜索關鍵字的兩篇文章\r\n";
                $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr);
                echo $resultStr;
            }
        } else {
            echo "";
            exit;
        }
    }

    private function checkSignature() {
        $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);
        return $tmpStr == $signature;
    }
}
?>

四、智能回復邏輯實現

智能回復的核心是根據用戶輸入的關鍵字(如數字 1-5)返回不同內容。進階版本可結合數據庫查詢,實現動態內容推送。以下是封裝後的類結構,支援文本和圖文消息:

<?php
define("TOKEN", "weixin");
$wechatObj = new wechatCallbackapiTest();
$wechatObj->weixin_run();

class wechatCallbackapiTest {
    private $fromUsername;
    private $toUsername;
    private $times;
    private $keyword;
    private $MsgType;

    public function responseMsg() {
        $postStr = $GLOBALS["HTTP_RAW_POST_DATA"];
        if (!empty($postStr)) {
            $postObj = simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_NOCDATA);
            $this->fromUsername = $postObj->FromUserName;
            $this->toUsername = $postObj->ToUserName;
            $this->keyword = trim($postObj->Content);
            $this->time = time();
            $this->MsgType = $postObj->MsgType;
        } else {
            echo "Pay attention to <a href='https://{$_SERVER['HTTP_HOST']}'>https://{$_SERVER['HTTP_HOST']}</a>,thanks!";
            exit;
        }
    }

    public function weixin_run() {
        $this->responseMsg();
        if($this->MsgType != 'event') {
            $data = $this->getData();  // 根據關鍵字查詢數據庫
            $this->fun_xml("news", $data, count($data));
        } else {
            $data = $this->getWelData();  // 歡迎語
            $this->fun_xml("text", $data, 1);
        }
    }

    // 統一 XML 輸出方法
    private function fun_xml($type, $value_arr, $count) {
        $con = "<xml>
            <ToUserName><![CDATA[{$this->fromUsername}]]></ToUserName>
            <FromUserName><![CDATA[{$this->toUsername}]]></FromUserName>
            <CreateTime>{$this->times}</CreateTime>
            <MsgType><![CDATA[{$type}]]></MsgType>";

        switch($type) {
            case "text":
                $con .= "<Content><![CDATA[$value_arr]]></Content>";
                break;
            case "news":
                $con .= "<ArticleCount>{$count}</ArticleCount> <Articles>";
                foreach($value_arr as $key => $v) {
                    $con .= "<item>
                        <Title><![CDATA[{$v[0]}]]></Title>
                        <Description><![CDATA[{$v[1]}]]></Description>
                        <PicUrl><![CDATA[{$v[2]}]]></PicUrl>
                        <Url><![CDATA[{$v[3]}]]></Url>
                        </item>";
                }
                $con .= "</Articles>";
                break;
        }
        echo $con . "</xml>";
    }

    private function getData() {
        // 實現數據庫查詢邏輯,返回文章數組
        // 格式:array(array(標題, 介紹, 圖片, 鏈接), ...)
        return $data;
    }

    private function getWelData() {
        return "感謝您關注 AndyYang 個人博客微信小助手。\r\n".
            "回復【1】返回兩篇最新文章\r\n".
            "回復【2】返回兩篇人氣文章\r\n".
            "回復【3】返回兩篇熱評文章\r\n".
            "回復【4】返回兩篇最新技術文章\r\n".
            "回復【5】返回兩篇最新寫作文章\r\n".
            "回復其他返回搜索關鍵字的兩篇文章\r\n";
    }
}
?>

五、常見問題與注意事項

  • 中文亂碼:確保文件編碼為 UTF-8,且數據庫連接設置 SET NAMES utf8
  • 服務器響應超時:微信要求 5 秒內響應,複雜邏輯建議異步處理
  • Token 不匹配:雙方配置必須完全一致,區分大小寫
  • 圖文消息限制:單次回復最多 10 條圖文

六、擴展學習資源

更多 PHP 微信開發技巧請參考:

  • 《PHP 微信開發技巧匯總》
  • 《PHP 編碼與轉碼操作技巧匯總》
  • 《PHP 網絡編程技巧總結》
  • 《PHP 基本語法入門教程》

希望本教程能幫助你快速上手微信公眾平台開發,構建屬於自己的智能回復機器人!

  1. 上一篇文章:
  2. 下一篇文章:
Copyright © 程式碼之家 All Rights Reserved