一、寫在前面的話 Node.js是一個開放源代碼、跨平臺的JavaScript語言運行環境,採用Google開發的V8運行代碼,使用事件驅動、非阻塞和非同步輸入輸出模型等技術來提高性能,可優化應用程式的傳輸量和規模。這些技術通常用於數據密集的事實應用程式。—— "來自維基百科" ...
一、寫在前面的話
Node.js是一個開放源代碼、跨平臺的JavaScript語言運行環境,採用Google開發的V8運行代碼,使用事件驅動、非阻塞和非同步輸入輸出模型等技術來提高性能,可優化應用程式的傳輸量和規模。這些技術通常用於數據密集的事實應用程式。——來自維基百科
最近花了差不多近一個月的時間去學習Node.js,由於它的代碼語言是 Javascript ,因此對於語法上就沒有過多的去研究,畢竟做過Web開發的程式員,很少有不會Javascript的。而寫這篇文章,也只是為了
如有不正確的地方,希望大家指正。
二、準備工作
在正式開始碼代碼之前,我們需要準備以下東西:
- 搭建 Node 環境。Node的安裝過程太過簡單,網上也有太多的教程,大家可以自行百度;
- 申請微信公眾號,同樣這裡也不做介紹,大家自行百度。
- 伺服器和功能變數名稱。
- 打開Node.js中文網文檔
- 打開 微信開發者文檔
三、接入微信公眾平臺
1.創建Node.js 項目
首先我們在電腦的任意磁碟上創建文件夾,命名隨意,我這命名為 wechat;
隨後在文件夾中創建兩個文件,一個是config.json,另一個為app.js。如下圖所示:
PS:這裡我的 IDE 是 VSCode,各位可隨意使用自己喜歡的 IDE。
為了後續功能的擴展,我加入了Express框架,具體操作如下:
電腦打開運行界面,快捷鍵為:win+R,輸入cmd後回車,進入dos界面,輸入命令
npm install -g express
進行全局安裝;由於 Express 自 4.x 版本中將命令工具分離出來,因此還需要輸入下一個命令
npm install -g express-generator@4
安裝成功後,在dos界面中輸入以下 命令
express -h
結果如下圖所示:
什麼?你的運行結果提示:express不是內部或外部命令。那你必須要檢查一下安裝 node.js 的時候有沒有添加環境變數。點擊<a href="http://jingyan.baidu.com/article/1876c8529c79e2890b1376dd.html?st=2&net_type=&bd_page_type=1&os=0&rst=&word=WWWDHZJS.ORG" target="_blank">解決express不是內部或外部命令問題
2.微信文檔步驟
如果在沒有考慮清楚之前,就開始碼代碼的話,這樣做是非常危險的。我們先打開微信文檔,點擊 開始開發 中的 接入指南,如圖:
跳過第一步,直接看第二步,如圖:
正如幫助文檔所說的那樣,我們總結以四個步驟:
- 獲取微信伺服器Get請求的參數 signature、timestamp、nonce、echostr
- 將token、timestamp、nonce三個參數進行字典序排序
- 將三個參數字元串拼接成一個字元串進行sha1加密
- 開發者獲得加密後的字元串可與signature對比,標識該請求來源於微信
3.接入功能的實現
整理好思路後我們就按照上一節的步驟去實現。首先我們在打開 config.json 文件,輸入以下內容:
{
"token":"wechat"
}
config.json 文件是我們程式的配置文件,在後面的文章中,我們會將程式名稱、微信定義的參數名稱、請求地址等配置內容存放在該文件中。
打開 app.js 文件,該文件屬於我們程式的入口,在文件啟動及以後路由配置都是再次實現的,首先我們導入重要的模塊:
const express = require('express'), //express 框架
crypto = require('crypto'), //引入加密模塊
config = require('./config');//引入配置文件
上面的代碼不難理解,require 就是導入模塊的意思。這裡主要針對我們自定義的config.json文件講解一下:
"./" 表示與 app.js 在同一及目錄下,為什麼要這麼寫呢?原因很簡單就是在我們通過 npm 命令安裝模塊時,如果我們指定了全局安裝,也就是 -g,安裝後的文件則會保存在我們 node.js 安裝路徑下的 node_modules 文件夾中;同理,我們不指定全局安裝,安裝後的文件則會保存在我們安裝命令輸入時所在的文件夾根目錄下的 node_modules 文件夾中,此時如果沒有該文件,系統會自動創建。
這裡我們都是使用 require 去導入模塊的,node.js 怎麼分辨系統模塊和我們自定義的模塊呢,聰明的你一定想到了,沒錯就是 "./" 這個,如果你不想用它的話,你也可以把自定義的模塊文件移到 node_modules 文件夾中。
require 是通過模塊名稱去導入模塊文件的,因此在引入的時候不需要寫入文件的尾碼名。如果兩個文件重名,但尾碼名不同, require 會按正序 導入排在最前面的文件。
實際上就是這麼簡單,我們也就不再糾結這個問題,繼續下麵的工作。
實例 express 以及 創建伺服器
//實例 express
var app = express();
//用於處理所有進入 3000 埠 get 的連接請求
app.get('/',function(req,res){
//對請求連接返回內容
res.send("Hello Node.js");
});
//監聽3000埠
app.listen(3000);
上面的代碼通過註釋,我們就能明白其意思,這裡我就不再做細緻的講解。再次進入 dos 界面,通過命令進入我們項目的文件的根目錄下,如圖:
輸入命令,啟動我們的Node.js項目
node app.js
啟動成功後,我們打開瀏覽器輸入地址:http://localhost:3000 訪問我們的node.js項目,如圖
小技巧 :
在每次更改完 node.js 項目後,我們都需要先將 node.js停止(快捷鍵: Ctrl+C),然後再通過命令再次運行,這樣特別麻煩。這裡我推薦使用 supervisor 工具,npm 安裝命令為:npm install -g supervisor。這樣我們啟動 node.js 項目命令改為 supervisor app.js,更改項目後只需要保存,刷新瀏覽器頁面就可以得到更改後的結果了。
完成上面的工作後,我們就可以正式開始寫接入微信公眾平臺的主要代碼,廢話不多說直接貼代碼
const express = require('express'), //express 框架
crypto = require('crypto'), //引入加密模塊
config = require('./config');//引入配置文件
var app = express();//實例express框架
//用於處理所有進入 3000 埠 get 的連接請求
app.get('/',function(req,res){
//1.獲取微信伺服器Get請求的參數 signature、timestamp、nonce、echostr
var signature = req.query.signature,//微信加密簽名
timestamp = req.query.timestamp,//時間戳
nonce = req.query.nonce,//隨機數
echostr = req.query.echostr;//隨機字元串
//2.將token、timestamp、nonce三個參數進行字典序排序
var array = [config.token,timestamp,nonce];
array.sort();
//3.將三個參數字元串拼接成一個字元串進行sha1加密
var tempStr = array.join('');
const hashCode = crypto.createHash('sha1'); //創建加密類型
var resultCode = hashCode.update(tempStr,'utf8').digest('hex'); //對傳入的字元串進行加密
//4.開發者獲得加密後的字元串可與signature對比,標識該請求來源於微信
if(resultCode === signature){
res.send(echostr);
}else{
res.send('mismatch');
}
});
//監聽3000埠
app.listen(3000);
4.部署項目
完成了代碼後我們就可以把項目發佈到外網上了,這裡我用的是花生殼內網映射外網的軟體,各位可以隨意使用其他工具。
1.打開花生殼的軟體,點擊內網穿透:
2.點擊添加映射
3.配置映射
由於微信只接受80埠,我們在映射類型選擇為 網站80埠;內網主機就是我們電腦的 IP 地址;內網埠號就是node.js的監聽埠;點擊確定後,就成功映射到外網了,可以通過花生殼提供的功能變數名稱進行訪問。
5.接入驗證
再次進入微信公眾平臺在左側菜單點擊基本配置,如圖:
點擊修改配置。其中伺服器地址,就是我們外網映射的地址;令牌(Token)就是我們在 config.json 文件中 定義的 token 值;消息加密可以點擊隨機生成按鈕,當然你也可以隨便定義;消息加解密方式這塊可以隨便選擇,這裡我就使用預設的,如圖:
點擊提交按鈕,提示 提交成功,那麼我就要祝賀你了
你已經成功的步入了Node.js開發微信的開發的第一步。
文章源代碼:https://github.com/SilenceHVK/wechatByNode 。對文章有不正確之處,請給予糾正。github源代碼請順手給個 Star,最後感謝您的閱讀。