个人博客
专注IT梦想的地方

搭建微信小程序服务

本篇分享来自腾讯云的开发者实验室,移植过来是为了方便大家阅读,那么废话不多说,直接copy内容:

 

第一步:准备域名和证书

小程序后台服务需要通过 HTTPS 访问,所以在开发前,我们要准备域名和 SSL 证书。

这个你们可以在官网或者其他地方获取,只要你有就行了。

第二步:搭建小程序开发环境

在开始搭建我们的小程序服务器之前,需要先完成客户端小程序开发环境的搭建。
  • 注册开发者账号
    如果你还不是小程序开发者,请先在微信公众平台并注册:
    https://mp.weixin.qq.com
    具体注册流程可参考如下视频:
  • 若您已注册,请点击下一步。

可以设置一下你的域名

App({
    config: {
        host: '' // 这个地方填写你的域名
    },
    onLaunch () {
        console.log('App.onLaunch()');
    }
});

具体的可以在https://mp.weixin.qq.com里有文档看的。

 

第三步:搭建 HTTP 服务

下面的步骤,将带大家在服务器上使用 Node 和 Express 搭建一个 HTTP 服务器

安装 NodeJS 和 NPM

使用下面的命令安装 NodeJS 和 NPM
yum install nodejs npm -y
安装完成后,使用下面的命令测试安装结果
node -v

然后我们可以编写一个 HTTP Server 试试

mkdir -p /data/release/weapp    //创建一个目录
cd /data/release/weapp    //进入该目录

创建 package.json

{
 "name": "weapp",
 "version": "1.0.0"
}

然后创建一个app.js

// 引用 express 来支持 HTTP Server 的实现
const express = require('express');

// 创建一个 express 实例
const app = express();

// 实现唯一的一个中间件,对于所有请求,都输出 "Response from express"
app.use((request, response, next) => {
    response.write('Response from express');
    response.end();
});

// 监听端口,等待连接
const port = 8765;
app.listen(port);

// 输出服务器启动日志
console.log(`Server listening at http://127.0.0.1:${port}`);

然后通过node app.js就可以运行,但是为了能保持连接,我们使用pm2来管理,所以先按照pm2

npm install pm2 --global

接着安装Express

cd /data/release/weapp
npm install express --save

安装好后就可以启动了,启动代码如下:

cd /data/release/weapp
pm2 start app.js
要查看服务输出的日志,可以使用下面的命令:
pm2 logs
如果要重启服务,可以使用下面的命令:
pm2 restart app

 

第四步:搭建 HTTPS 服务

在 CentOS 上,可直接使用 yum 来安装 Nginx
yum install nginx -y
安装完成后,使用 nginx 命令启动 Nginx:
nginx

接下来在nginx的配置中加入如下代码:

server {
 listen 443;
 server_name www.example.com; # 改为绑定证书的域名
 # ssl 配置
 ssl on;
 ssl_certificate 1_www.example.com_bundle.crt; # 改为自己申请得到的 crt 文件的名称
 ssl_certificate_key 2_www.example.com.key; # 改为自己申请得到的 key 文件的名称
 ssl_session_timeout 5m;
 ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
 ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:HIGH:!aNULL:!MD5:!RC4:!DHE;
 ssl_prefer_server_ciphers on;

 location / {
 proxy_pass http://127.0.0.1:8765;
 }
 }

然后重启nginx

nginx -s reload

 

第五步:小程序会话

使用 Yum 在机器上安装

MongoDB

及其客户端命令行工具:

yum install mongodb-server mongodb -y
安装结束后,可以使用下面的命令查看安装的版本:
mongod --version
mongo --version
创建目录,用于 MongoDB 数据和日志存储:
mkdir -p /data/mongodb
mkdir -p /data/logs/mongodb

创建后,使用下面的命令来启动 MongoDB:

mongod --fork --dbpath /data/mongodb --logpath /data/logs/mongodb/weapp.log

可以使用下面的命令来检查是否启动成功

netstat -ltp | grep 27017
登录本地 MongoDB 服务:
mongo
登录后,创建一个用户 weapp
use weapp;
db.createUser({ user: 'weapp', pwd: 'weapp-dev', roles: ['dbAdmin', 'readWrite']});
创建完成后,使用 exit 退出命令行工具。

实现小程序的会话功能,我们需要安装

connect-mongo  和 wafer-node-session
cd /data/release/weapp
npm install connect-mongo wafer-node-session --save

在工作目录创建配置文件 config.js,用于保存我们服务所用的配置,可参考下面的实现(注:请将参考配置文件中的 YORU_APP_ID 和 YOUR_APP_SECRET 替换为你申请的小程序对应的 AppID 和 AppSecret):

module.exports = { 
 serverPort: '8765', 

 // 小程序 appId 和 appSecret 
 // 请到 https://mp.weixin.qq.com 获取 AppID 和 AppSecret
 appId: 'YORU_APP_ID', 
 appSecret: 'YOUR_APP_SECRET', 

 // mongodb 连接配置,生产环境请使用更复杂的用户名密码
 mongoHost: '127.0.0.1', 
 mongoPort: '27017', 
 mongoUser: 'weapp', 
 mongoPass: 'weapp-dev', 
 mongoDb: 'weapp'
};

编辑 app.js,添加会话实现逻辑,可参考下面的代码:

// 引用 express 来支持 HTTP Server 的实现
const express = require('express');
// 引用 wafer-session 支持小程序会话
const waferSession = require('wafer-node-session'); 
// 使用 MongoDB 作为会话的存储
const MongoStore = require('connect-mongo')(waferSession); 
// 引入配置文件
const config = require('./config'); 

// 创建一个 express 实例
const app = express();

// 添加会话中间件,登录地址是 /login
app.use(waferSession({ 
 appId: config.appId, 
 appSecret: config.appSecret, 
 loginPath: '/login',
 store: new MongoStore({ 
 url: `mongodb://${config.mongoUser}:${config.mongoPass}@${config.mongoHost}:${config.mongoPort}/${config.mongoDb}` 
 }) 
})); 

// 在路由 /me 下,输出会话里包含的用户信息
app.use('/me', (request, response, next) => { 
 response.json(request.session ? request.session.userInfo : { noBody: true }); 
 if (request.session) {
 console.log(`Wafer session success with openId=${request.session.userInfo.openId}`);
 }
}); 

// 实现一个中间件,对于未处理的请求,都输出 "Response from express"
app.use((request, response, next) => {
 response.write('Response from express');
 response.end();
});

// 监听端口,等待连接
app.listen(config.serverPort);

// 输出服务器启动日志
console.log(`Server listening at http://127.0.0.1:${config.serverPort}`);
源码编写完成后,重启服务:
pm2 restart app

重启后,使用配套的小程序完成会话测试:打开配套小程序 – 点击 实验二:会话 – 获取会话,如果您能看到您的微信头像,那就表示会话已经成功获取了。

第六步:WebSocket 服务

我们使用wx模块,先安装一下:

cd /data/release/weapp
npm install ws --save

然后创建 websocket.js,实现 WebSocket 服务,可参考下面的代码:

// 引入 ws 支持 WebSocket 的实现
const ws = require('ws');

// 导出处理方法
exports.listen = listen;

/**
 * 在 HTTP Server 上处理 WebSocket 请求
 * @param {http.Server} server
 * @param {wafer.SessionMiddleware} sessionMiddleware
 */
function listen(server, sessionMiddleware) {
 // 使用 HTTP Server 创建 WebSocket 服务,使用 path 参数指定需要升级为 WebSocket 的路径
 const wss = new ws.Server({ server, path: '/ws' });

 // 监听 WebSocket 连接建立
 wss.on('connection', (ws,request) => {// 要升级到 WebSocket 协议的 HTTP 连接

 // 被升级到 WebSocket 的请求不会被 express 处理,
 // 需要使用会话中间节获取会话
 sessionMiddleware(request, null, () => {
 const session = request.session;
 if (!session) {
 // 没有获取到会话,强制断开 WebSocket 连接
 ws.send(JSON.stringify(request.sessionError) || "No session avaliable");
 ws.close();
 return;
 }
 // 保留这个日志的输出可让实验室能检查到当前步骤是否完成
 console.log(`WebSocket client connected with openId=${session.userInfo.openId}`);
 serveMessage(ws, session.userInfo);
 });
 });

 // 监听 WebSocket 服务的错误
 wss.on('error', (err) => {
 console.log(err);
 });
}

/**
 * 进行简单的 WebSocket 服务,对于客户端发来的所有消息都回复回去
 */
function serveMessage(ws, userInfo) {
 // 监听客户端发来的消息
 ws.on('message', (message) => {
 console.log(`WebSocket received: ${message}`);
 ws.send(`Server: Received(${message})`);
 });

 // 监听关闭事件
 ws.on('close', (code, message) => {
 console.log(`WebSocket client closed (code: ${code}, message: ${message || 'none'})`);
 });

 // 连接后马上发送 hello 消息给会话对应的用户
 ws.send(`Server: 恭喜,${userInfo.nickName}`);
}

编辑 app.js,调用 WebSocket 服务,可参考下面代码:

// HTTP 模块同时支持 Express 和 WebSocket
const http = require('http'); 
// 引用 express 来支持 HTTP Server 的实现
const express = require('express');
// 引用 wafer-session 支持小程序会话
const waferSession = require('wafer-node-session'); 
// 使用 MongoDB 作为会话的存储
const MongoStore = require('connect-mongo')(waferSession); 
// 引入配置文件
const config = require('./config'); 
// 引入 WebSocket 服务实现
const websocket = require('./websocket');

// 创建一个 express 实例
const app = express();

// 独立出会话中间件给 express 和 ws 使用
const sessionMiddleware = waferSession({
 appId: config.appId,
 appSecret: config.appSecret,
 loginPath: '/login',
 store: new MongoStore({
 url: `mongodb://${config.mongoUser}:${config.mongoPass}@${config.mongoHost}:${config.mongoPort}/${config.mongoDb}`
 })
});
app.use(sessionMiddleware);

// 在路由 /me 下,输出会话里包含的用户信息
app.use('/me', (request, response, next) => { 
 response.json(request.session ? request.session.userInfo : { noBody: true }); 
 if (request.session) {
 console.log(`Wafer session success with openId=${request.session.userInfo.openId}`);
 }
}); 

// 实现一个中间件,对于未处理的请求,都输出 "Response from express"
app.use((request, response, next) => {
 response.write('Response from express');
 response.end();
});

// 创建 HTTP Server 而不是直接使用 express 监听
const server = http.createServer(app);

// 让 WebSocket 服务在创建的 HTTP 服务器上监听
websocket.listen(server, sessionMiddleware);

// 启动 HTTP 服务
server.listen(config.serverPort);

// 输出服务器启动日志
console.log(`Server listening at http://127.0.0.1:${config.serverPort}`);
修改完成后,按 Ctrl + S 保存文件,并重启服务:
pm2 restart app

然后更新一下Nginx配置,编辑 Nginx 配置 ssl.conf,添加 WebSocket 支持,可参考下面的配置(注:请将参考配置文件中的 www.example.com 替换为前面步骤申请的域名,将 1_www.example.com.crt 和 2_www.example.com.key 替换为前面步骤申请并上传的 SSL 证书的名称):

# WebSocket 配置
map $http_upgrade $connection_upgrade {
 default upgrade;
 '' close;
}

server {
 listen 443;
 server_name www.example.com; # 改为绑定证书的域名
 # ssl 配置
 ssl on;
 ssl_certificate 1_www.example.com.crt; # 改为自己申请得到的 crt 文件的名称
 ssl_certificate_key 2_www.example.com.key; # 改为自己申请得到的 key 文件的名称
 ssl_session_timeout 5m;
 ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
 ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:HIGH:!aNULL:!MD5:!RC4:!DHE;
 ssl_prefer_server_ciphers on;

 # WebSocket 配置
 proxy_set_header Upgrade $http_upgrade;
 proxy_set_header Connection $connection_upgrade;

 location / {
 proxy_pass http://127.0.0.1:8765;
 }
 }

配置完成后,按 Ctrl + S 保存,并且通知 Nginx 进程重新加载配置:

nginx -s reload

至此就是所有的配置了,当然,你有更多其他方面的配置分享,也可以留言哦。

赞(6) 打赏
未经允许,不得转载本站任何文章:智言个人博客 » 搭建微信小程序服务

评论 3

评论前必须登录!

 

  1. #0

    ceshi

    智言2年前 (2019-04-18)
  2. #0

    到创建config.js和app.js这一步就搞不成了。

    埃菲尔上的天空2年前 (2018-06-19)

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

微信扫一扫打赏