萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

微信公眾平台開發入門教程(2024 更新版):從零構建天氣查詢機器人

本教程假設讀者具備 PHP 基礎、MySQL 基本操作、HTTP/XML/JSON 基礎。以「方倍工作室」公眾號為例,手把手帶你完成:SAE 雲部署、開發模式啟用、基礎消息接口、PHP SDK 封裝、天氣查詢功能開發。

第一章:申請雲服務器資源(以新浪雲 SAE 為例)

1. 註冊/登錄 SAE

  • 訪問 sae.sina.com.cn,微博賬號直接登錄,贈送 500 雲豆/月(足夠低流量應用)。

SAE 登錄頁面

2. 創建應用

  • 「我的首頁」→「創建新應用」。
  • AppID:唯一標識(如 wechat-weather),將成二級域名 wechat-weather.sinaapp.com。
  • 開發語言選 **PHP 7.4+**,類型選 **Web 應用**。

創建應用表單

應用創建成功

3. 創建版本並部署代碼

  • 進入「代碼管理」→「創建版本」(版本號 1)。
  • 編寫 index.php(見下),壓縮為 index.zip 上傳。

版本創建成功

第二章:啟用微信公眾平台開發模式

  1. 登錄 mp.weixin.qq.com → 「開發」→「基本配置」。
  2. **關閉「編輯模式」**(二者互斥)。
  3. 「開發模式」→「修改配置」:
  • URL:`https://wechat-weather.sinaapp.com/`(你的 SAE 域名)
  • Token:自定義(如 `weixin`),需與代碼一致。
  • EncodingAESKey:隨機生成或留空(明文模式)。
  • 消息加解密方式:**明文模式**(調試期),上線後改「安全模式」。

開發模式配置

關閉編輯模式

滑動關閉

第三章:基礎消息接口驗證代碼 (index.php)

<?php
/**
 * 微信公眾平台驗證入口
 * 方倍工作室 https://www.cnblogs.com/txw1958/
 */
define("TOKEN", "weixin");

$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;  // 原樣返回 echostr,驗證通過
            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;
    }

    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();
            
            $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>";

            if ($keyword == "?" || $keyword == "?") {
                $msgType = "text";
                $contentStr = date("Y-m-d H:i:s", $time);
                $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr);
                echo $resultStr;
            }
        } else {
            echo "";
            exit;
        }
    }
}
?>

代碼編輯器截圖

壓縮上傳

上傳成功

第四章:接入第三方天氣 API 實現「查天氣」

  1. 申請免費天氣 API(如 天行數據、和風天氣),獲取 API Key。
  2. 在 `responseMsg()` 中解析用戶文本,調用天氣 API,組裝回復:
if (strpos($keyword, "天氣") === 0) {
    $city = trim(substr($keyword, 2));
    $weather = $this->getWeather($city);
    $contentStr = $weather ? $weather : "查詢失敗,請檢查城市名";
    $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, "text", $contentStr);
    echo $resultStr;
}

private function getWeather($city) {
    $key = "YOUR_API_KEY";
    $url = "https://api.tianapi.com/tianqi/index?key=$key&city=" . urlencode($city);
    $json = @file_get_contents($url);
    if (!$json) return false;
    $data = json_decode($json, true);
    if ($data['code'] != 200) return false;
    $w = $data['newslist'][0];
    return "{$w['date']} {$w['week']}\n{$w['city']} 天氣:{$w['weather']}\n溫度:{$w['real']}°C\n風向:{$w['wind']}\n濕度:{$w['humidity']}%";
}

第五章:進階開發建議

  • 使用成熟 SDK:wechat-php-sdk、EasyWeChat(Laravel 首選),封裝簽名驗證、消息解析、客服接口、素材管理、支付等。
  • 異步處理:耗時操作(AI 回復、圖片生成)放入隊列(Redis/RabbitMQ),立即返回「收到」或空串,避免 5 秒超時。
  • 安全加固:驗證簽名、啟用安全模式(AES 加密)、設置 IP 白名單、限流防刷。
  • 日誌與監控:記錄請求/回復 XML、錯誤堆棧,接入 Sentry/ELK。
  • 多客服/模板消息/小程序關聯:拓展業務邊界。

常見問題排查

總結

完成以上步驟,你已擁有一個可運行的微信公眾號後端。後續可持續豐富指令:笑話、翻譯、快遞查詢、圖文推送、OAuth 網頁授權……微信開發的大門已為你打開。

copyright © 萬盛學電腦網 all rights reserved
現象原因解決
驗證失敗Token 不一致、URL 不可訪問、輸出多餘空白字符核對 Token、瀏覽器直訪 URL、ob_clean()
用戶收不到回復超時(>5s)、XML 格式錯誤、未返回 echostr異步化、xml 輸出檢查、驗證邏輯正確
SAE 部署 403/500代碼語法錯誤、權限、缺少擴展查看 SAE 日誌、啟用 display_errors