DIV CSS 佈局教程網

用 Node.js 搭建微信公眾號後台的實戰記錄
編輯:關於JavaScript     

摘要:微信憑藉龐大的用戶基數與極強的黏著度,近兩年吸引了大量開發者投入。Node.js 則是發展迅速、特別適合承載行動後台的技術選擇。本文以筆者自己的實作,說明如何以 Node.js 打造自己的微信公眾號,主要用到 express、wechat、mongodb、monk 等模組。

前期準備

一、申請微信公眾號,前往 https://mp.weixin.qq.com/ 辦理。

二、準備伺服器。這裡推薦 Amazon EC2,首次使用者可選 micro instance 享一年免費,只要輸入信用卡資料即可完成申請;整個流程為英文介面,但為了免費額度,多花一點時間值得。

安裝 Node.js 開發環境

yum -y install gcc
yum -y install gcc-c++
yum -y install make automake
wget https://nodejs.org/dist/v0.10.29/node-v0.10.29.tar.gz
tar -xvzf node-v0.10.29.tar.gz
cd 解壓目錄
./configure
make
make install

安裝 MongoDB

wget https://downloads.10gen.com/linux/mongodb-linux-x86_64-enterprise-amzn64-2.6.3.tgz
tar -xvzf mongodb-linux-x86_64-enterprise-amzn64-2.6.3.tgz
sudo cp -R -n mongodb-linux-x86_64-enterprise-amzn64-2.6.3 /usr/local/mongodb

實例背景

筆者班上有支足球隊,大家把錢集中交給隊長,由他支付每次場地費並記錄每人的支出與餘額。由於不是每次都能全員到場,費用只能由參加者以 AA 方式分攤,用人工記錄頗為繁瑣。

於是筆者做了一個微信公眾號:只要輸入活動消費金額並選擇參與人數,就自動算出每人攤派金額與餘額,再把明細轉發到微信群裡,每個人都能看到。

實際架構上,這其實是一個微網站——用網頁記錄與顯示活動花費與餘額。微信公眾號扮演的是使用者與微網站之間的橋梁:當使用者關注帳號後,透過微信公眾平台的開發者模式,系統會自動回覆操作說明,其中包含對應的網址連結,點擊即可進入功能頁。

建置後台服務

先簡述兩個關鍵模組。express 是優秀的 Web 開發框架,能快速搭建網站。由於微信伺服器會以 HTTP POST 與開發者伺服器互動,因此需要 express 來接。

以下是新使用者關注時的 log,其中 103.7.30.84 為微信伺服器的 IP:

103.7.30.84 POST /wechat?signature=8a8e408fdae6bbdd6e470af98865a5f993cea283&timestamp=1408610461&nonce=1572142586 2 200

wechat 模組則封裝了與微信伺服器互動的細節,讓開發者只需專注自己的業務邏輯。

建立 express 專案

npm install -g express
express -e your_project   // -e 表示使用 ejs 引擎,不帶參數則預設 jade
cd your_project && npm install

安裝後的目錄結構:

[ec2-user@ip-172-31-2-188 your_project]$ ls
app.js  bin  node_modules  package.json  public  routes  views

接著安裝 wechat:

npm install wechat

微信開發者模式設定

在公眾平台後台填寫 URL 與 token:

接入認證與自動回覆

修改 app.js:

app.use('/users', users);
app.use('/weixin', weixin);

app.use(express.query());

app.use('/wechat', wechat('hchismylove', function (req, res, next) {
  // 微信傳入的訊息都在 req.weixin 上
  var message = req.weixin;
  console.log(message);

  if ((message.MsgType == 'event') && (message.Event == 'subscribe')) {
    var refillStr = "<a href=\"https://your_IP/weixin/refill?weixinId=" + message.FromUserName + "\">1. 點擊記錄團隊充值</a>";

    var consumeStr = "<a href=\"https://your_IP/weixin/consume?weixinId=" + message.FromUserName + "\">2. 點擊記錄團隊消費</a>";

    var deleteStr = "<a href=\"https://your_IP/weixin/delete?weixinId=" + message.FromUserName + "\">3. 點擊回退記錄</a>";

    var historyStr = "<a href=\"https://your_IP/weixin/history?weixinId=" + message.FromUserName + "\">4. 點擊查詢歷史記錄</a>";

    var emptyStr = "    ";
    var replyStr = "感謝你的關注!" + "\n" + emptyStr + "\n" + refillStr + "\n" + emptyStr + "\n" + consumeStr
                 + "\n" + emptyStr + "\n" + deleteStr + "\n" + emptyStr + "\n" + historyStr;
    res.reply(replyStr);
  }
}));

其中 app.use('/wechat', wechat('your_token', ...)) 這一行就完成了微信伺服器的接入認證。

而判斷 MsgType == 'event' && Event == 'subscribe' 的區塊,實現了新使用者關注時自動發送操作說明:

幾點實務提醒

上述程式碼是幾年前的寫法,今日重做時有幾處必須調整。首先是 express 4 已移除內建的 express.query() 中介層,改用 router 與 express-session 等機制;Node 版本也應選用長期支援版。

其次是安全性:your_token 不應硬編碼在程式碼中,應從環境變數讀取;回覆內容中直接嵌入 FromUserName 也建議先做驗證。此外,微信伺服器要求回應必須在五秒內完成,若後端處理較慢,正確做法是先回覆佔位訊息,再用客服訊息接口補推結果,避免因超時導致重複推送。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved