共计 9981 个字符,预计需要花费 25 分钟才能阅读完成。
express+mongodb 搭建具有用户注册、登录、验证等功能的后端
- 安装 node
安装 node 的教程上网一大把,这里就不细说了,建议使用 nvm 安装,可以随时切换 node 版本。
- 安装 mongodb
在这里使用 Homebrew 安装 mongodb, 首先更新 Homebrew:
brew update
mongodb 提供 3 种版本供安装:普通版、支持 TLS/SSL 版本和开发版,具体请参见 mongodb 官网。普通版本安装执行以下指令:
brew install mongodb
从终端信息得知,不管安装的是哪种版本,都会安装依赖 openssl。
各个部分默认的安装路径是:
The databases are stored in the /usr/local/var/mongodb/ directory
The mongod.conf file is here: /usr/local/etc/mongod.conf
The mongo logs can be found at /usr/local/var/log/mongodb/
The mongo binaries are here: /usr/local/Cellar/mongodb/[version]/bin
1、配置数据库:
首先创建保存数据的文件夹:
sudo mkdir -p /data/db
然后给刚创建的文件夹写入数据权限:
sudo chown -R $USER /data/db
R 是 recursive 递归的意思
如果想直接配置 mongod.conf:
nano /usr/local/etc/mongod.conf
可以看到 mongod.conf 内容如下:
systemLog:
destination: file
path: /usr/local/var/log/mongodb/mongo.log
logAppend: true
storage:
dbPath: /usr/local/var/mongodb
net:
bindIp: 127.0.0.1
注意:如果准备连接非本机环境的 mongodb 数据库,bind_ip = 0.0.0.0,并且通过 homebrew 安装的 mongodb 不需要配置环境变量了,直接运行命令就行!
2、启动 mongod 服务:
mongod
使用此命令启动 mongod 会发现输出信息如下:
2016-06-13T10:25:09.929+0800 I CONTROL [initandlisten] MongoDB starting : pid=5693 port=27017 dbpath=/data/db 64-bit host=MacBookPro
......
可以看到,会使用默认的数据保存路径 /data/db。可是 /usr/local/etc/mongod.conf 这个配置文件中的默认 dbpath 不是 /usr/local/var/mongodb 吗?难道说配置文件没有生效?
没错,以上启动命令并不会读取 /usr/local/etc/mongod.conf。这是因为不通过 $ mongod –config xxx.conf 这种形式指定配置文件 xxx.conf 时 mongodb 会使用程序内置的默认配置,该配置对应的数据保存路径为 /data/db。建议启动 mongod 时通过 –config 参数指定配置文件,更多参考官网 Configuration File Options。
所以,如果我们配置了 /usr/local/etc/mongod.conf 并希望 mongdb 使用我们的配置,可选的命令有 2 种:(1)$ mongod –config /usr/local/etc/mongod.conf 和 (2)$ mongod –config /usr/local/etc/mongod.conf –fork. 使用命令 1 启动的 mongod 服务在前台运行,可以通过 Ctrl+ C 关闭服务。命令 2 启动的 mongod 服务以守护线程的形式在后台运行
使用命令 2 启动服务端成功输出以下信息:
about to fork child process, waiting until server is ready for connections.
forked process: 6775
child process started successfully, parent exiting
如果使用命令 2 启动失败输出信息如下:
about to fork child process, waiting until server is ready for connections.
forked process: 6611
ERROR: child process failed, exited with error number 48
谷歌之后在 stackoverflow 上找到解决方案。这是因为已经有 mongodb 进程在运行,必须先找到该进程的 pid, 然后使用 kill 命令杀死该进程。
3、启动 mongo shell:
mongodb 自带 Javascript Shell, 可以运行 Javascript 程序,并可以和 mongodb 服务实例交互,启动 mongo shell 命令是:
mongo
客户端启动后会自动连接到 mongodb 服务端的 test 数据库:
MongoDB shell version: 3.2.7
connecting to: test
Welcome to the MongoDB shell.
For interactive help, type "help".
For more comprehensive documentation, see
http://docs.mongodb.org/
Questions? Try the support group
http://groups.google.com/group/mongodb-user
Server has startup warnings:
2016-06-13T10:25:10.288+0800 I CONTROL [initandlisten]
2016-06-13T10:25:10.288+0800 I CONTROL [initandlisten] ** WARNING: soft rlimits too low. Number of files is 256, should be at least 1000
>
关闭 mongo shell:
mongo shell 有 2 种关闭方式:
1. 运行 mongo shell 的终端输入 control+c
2. 从运行 mongo shell 的终端输入 > exit
至此,mongodb 已经完全安装完毕!
- 构建后端项目
1、新建一个文件夹,打开该文件夹,在终端输入以下命令初始化项目:
npm init
2、安装 express 生成器,通过应用生成器工具 express-generator 可以快速创建一个应用的骨架。express-generator 包含了 express 命令行工具。通过如下命令即可安装:
npm install express-generator -g
3、如下命令创建了一个名称为 myapp 的 Express 应用。此应用将在当前目录下的 myapp 目录中创建,并且设置为使用 Pug 模板引擎:
express --view=pug myapp
4、然后安装所有依赖包:
cd myapp
npm install
5、安装 nodemon。nodemon 将监视启动目录中的文件,如果有任何文件更改,nodemon 将自动重新启动 node 应用程序。
全局安装:
npm install -g nodemon
本地安装:
npm install --save-dev nodemon
6、启动项目
nodemon
出现如下:
~/code/lp-node-test/myapp » nodemon
[nodemon] 1.19.1
[nodemon] to restart at any time, enter `rs`
[nodemon] watching: *.*
[nodemon] starting `node ./bin/www`
在浏览器输入:http://localhost:3000,express 项目初步建立成功。
7、安装插件 babel-register、babel-preset-env,以便在项目中使用 es6 语法
npm install --save babel-register babel-preset-env
在根目录下新建.babelrc 文件,并输入一下内容:
.babelrc
{"presets": ["env"]
}
8、安装 mongoose、mongoose-auto-increment、consola,连接 mongodb 数据库
npm install --save mongoose mongoose-auto-increment consola
9、安装 session,用于用户登录认证
npm install --save express-session
10、在根目录下创建 config.js 全局配置文件,并输入如下:
config.js
const {argv} = require('yargs');
exports.MONGODB = {uri: `mongodb://127.0.0.1:${argv.dbport || '27017'}/node`,
username: argv.db_username || 'DB_username',
password: argv.db_password || 'DB_password',
};
11、在根目录下创建 core 文件夹,新建 mongodb.js 文件,并输入如下:
core/mongodb.js
const consola = require('consola')
const CONFIG = require('../app.config.js')
const mongoose = require('mongoose')
const autoIncrement = require('mongoose-auto-increment')
// remove DeprecationWarning
mongoose.set('useFindAndModify', false)
// mongoose Promise
mongoose.Promise = global.Promise
// mongoose
exports.mongoose = mongoose
// connect
exports.connect = () => {// console.log('CONFIG.MONGODB.uri :', CONFIG.MONGODB.uri)
// 连接数据库
mongoose.connect(CONFIG.MONGODB.uri, {
useCreateIndex: true,
useNewUrlParser: true,
promiseLibrary: global.Promise
})
// 连接错误
mongoose.connection.on('error', error => {consola.warn('数据库连接失败!', error)
})
// 连接成功
mongoose.connection.once('open', () => {consola.ready('数据库连接成功!')
})
// 自增 ID 初始化
autoIncrement.initialize(mongoose.connection)
// 返回实例
return mongoose
}
12、在根目录下创建 util 文件夹,新建 util.js 文件,用于放置公共方法,并输入如下:
util/util.js
import crypto from 'crypto';
module.exports = {md5: function(pwd) {let md5 = crypto.createHash('md5');
return md5.update(pwd).digest('hex');
},
// 响应客户端
responseClient(res, httpCode = 500, status = 3, message = '服务端异常', data = {}) {let responseData = {};
responseData.status = status;
responseData.message = message;
responseData.data = data;
res.status(httpCode).json(responseData);
},
// 时间 格式化成 2018-12-12 12:12:00
timestampToTime(timestamp) {const date = new Date(timestamp);
const Y = date.getFullYear() + '-';
const M = (date.getMonth() + 1 < 10 ? '0' + (date.getMonth() + 1) : date.getMonth() + 1) + '-';
const D = date.getDate() < 10 ? '0' + date.getDate() + '' : date.getDate() +' ';
const h = date.getHours() < 10 ? '0' + date.getHours() + ':' : date.getHours() + ':';
const m = date.getMinutes() < 10 ? '0' + date.getMinutes() + ':' : date.getMinutes() + ':';
const s = date.getSeconds() < 10 ? '0' + date.getSeconds() : date.getSeconds();
return Y + M + D + h + m + s;
},
};
13、在根目录下创建 models 文件夹,新建建 user.js,用于构建数据库的数据模型,并输入如下:
models/user.js
const crypto = require('crypto');
const {argv} = require('yargs');
const {mongoose} = require('../core/mongodb.js');
const autoIncrement = require('mongoose-auto-increment');
const adminSchema = new mongoose.Schema({
// 名字
name: {type: String, required: true, default: ''},
// 用户类型 0:管理者,1:其他用户
type: {type: Number, required: true, default: 1},
// 手机
phone: {type: Number, required: true, default: ''},
// 邮箱
email: {type: String, required: true, default: ''},
// 密码
password: {
type: String,
required: true,
default: crypto
.createHash('md5')
.update(argv.auth_default_password || 'root')
.digest('hex'),
},
// 创建日期
create_time: {type: Date, default: Date.now},
// 最后修改日期
update_time: {type: Date, default: Date.now},
});
module.exports = mongoose.model('User', adminSchema);
14、把 app.js 修改成如下:
app.js
// modules
const createError = require('http-errors');
const express = require('express');
const path = require('path');
const cookieParser = require('cookie-parser');
const logger = require('morgan');
const session = require('express-session');
// import 等语法要用到 babel 支持
require('babel-register');
const app = express();
// view engine setup
app.set('views', path.join(__dirname, 'views'));
app.set('view engine', 'ejs');
app.use(logger('dev'));
app.use(express.json());
app.use(express.urlencoded({ extended: false}));
app.use(express.static(path.join(__dirname, 'public')));
app.use(cookieParser('blog_node_cookie'));
app.use(
session({
secret: 'blog_node_cookie',
name: 'session_id', //# 在浏览器中生成 cookie 的名称 key,默认是 connect.sid
resave: true,
saveUninitialized: true,
cookie: {maxAge: 60 * 1000 * 30, httpOnly: true}, // 过期时间
}),
);
const mongodb = require('./core/mongodb');
// data server
mongodb.connect();
// 将路由文件引入
const route = require('./routes/index');
// 初始化所有路由
route(app);
// catch 404 and forward to error handler
app.use(function(req, res, next) {next(createError(404));
});
// error handler
app.use(function(err, req, res, next) {
// set locals, only providing error in development
res.locals.message = err.message;
res.locals.error = req.app.get('env') === 'development' ? err : {};
// render the error page
res.status(err.status || 500);
res.render('error');
});
module.exports = app;
15、把 routes/index.js 修改如下:
routes/index.js
/*
* 所有的路由接口
*/
const users = require('./users');
module.exports = app => {app.post('/login', users.login);
app.post('/logout', users.logout);
app.post('/register', users.register);
app.post('/userInfo', users.userInfo);
app.get('/currentUser', users.currentUser);
};
16、把 routes/users.js 修改如下:
routes/users.js
const User = require('../models/user');
import {responseClient, md5} from '../util/util.js';
exports.login = (req, res) => {const { phone, password} = req.body;
const reg =/^1[34578]\d{9}$/
if (!phone) {responseClient(res, 200, 400, '用户邮箱不可为空');
return;
}else if(!reg.test(phone)){responseClient(res, 200, 400, '请输入格式正确的手机号码');
return;
}
if (!password) {responseClient(res, 200, 400, '密码不可为空');
return;
}
User.findOne({
phone,
password: md5(password),
})
.then(userInfo => {console.log(userInfo._id)
if (userInfo) {
// 登录成功后设置 session
req.session.userInfo = userInfo;
responseClient(res, 200, 200, '登录成功', null);
} else {responseClient(res, 200, 402, '用户名或者密码错误');
}
})
.catch(err => {responseClient(res);
});
};
// 用户验证(获取用户信息)
exports.userInfo = (req, res) => {if (req.session.userInfo) {responseClient(res, 200, 200, '', req.session.userInfo);
} else {responseClient(res, 200, 403, '请重新登录', req.session.userInfo);
}
};
exports.logout = (req, res) => {console.log(req.session)
if (req.session.userInfo) {
req.session.userInfo = null; // 删除 session
responseClient(res, 200, 200, '登出成功!!');
} else {responseClient(res, 200, 402, '您还没登录!!!');
}
};
exports.register = (req, res) => {const { name, password, phone, type,email} = req.body;
const regPhone =/^1[34578]\d{9}$/
const regEmail = /^[a-z0-9]+([._\\-]*[a-z0-9])*@([a-z0-9]+[-a-z0-9]*[a-z0-9]+.){1,63}[a-z0-9]+$/
if (!phone) {responseClient(res, 200, 400, '用户手机号码不能为空');
return;
}else if(!regPhone.test(phone)){responseClient(res, 200, 400, '请输入格式正确的手机号码');
return;
}
if (!name) {responseClient(res, 200, 400, '用户名不可为空');
return;
}
if (!email) {responseClient(res, 200, 400, '用户邮箱不可为空');
return;
}else if(!regEmail.test(email)){responseClient(res, 200, 400, '请输入格式正确的邮箱');
return;
}
if (!password) {responseClient(res, 200, 400, '用户密码不可为空');
return;
}
// 验证用户是否已经在数据库中
User.findOne({phone})
.then(data => {if (data) {responseClient(res, 200, 402, '用户手机号码已存在!');
return;
}
// 保存到数据库
let user = new User({
name,
password: md5(password),
phone,
type,
email
});
user.save().then(data => {responseClient(res, 200, 200, '注册成功', data);
});
})
.catch(err => {responseClient(res);
return;
});
};
exports.delUser = (req, res) => {let { id} = req.body;
User.deleteMany({_id: id})
.then(result => {if (result.n === 1) {responseClient(res, 200, 0, '用户删除成功!');
} else {responseClient(res, 200, 1, '用户不存在');
}
})
.catch(err => {responseClient(res);
});
};
好了,现在用户注册、登录、登出、用户信息、删除用户接口都有了,使用 postman 请求接口试试
注册:
登录:
其他接口可自行补充,git 地址:https://github.com/SuperMrBea…