Node零基础入门到服务端程序 -- 第六章

第六章 使用环境变量

一个项目在使用的过程中，一般来说会有三个环境：开发环境、测试环境和线上环境。开发环境顾名思义就是当前开发使用的电脑的环境，通常会在本地创建一个数据库（也有可能会连接测试数据库），测试环境则为发布上线之前的一个中间环境，拥有单独的测试数据库，使得测试人员可以在上线之前验证开发的功能是否正确。生产环境就是实际网友们打开的网站。

在我们的项目中，使用了一些配置，比如说连接数据库时使用到的host、port、之类的，这些配置显然在不同的环境中应该有不同的内容，比如说本地的host可以是localhost，那么在测试环境和线上环境显然会有对应的数据库地址。

图片

那么，接下来，我们就把这些环境变量统一规整。创建文件夹environments，在其下创建dev.env, qa.env, prod.env三个文件，分别对应开发环境，测试环境，线上环境。

tips：environments这个环境变量文件写在这里，是为了以后部署的时候可以用于在不同的环境中直接复制给相应的环境。

使用键值对的方式写环境变量，键名大写使用下划线连接

environments/dev.env

MONGO_HOST=localhost
MONGO_PORT=27017
MONGO_DATABASE=library

environments/qa.env

MONGO_HOST=qa.env.com
MONGO_PORT=27017
MONGO_DATABASE=library
MONGO_USERNAME=qa_readwrite
MONGO_PASSWORD=123456

tips：本地我们没有为数据库设定用户名和密码，所以不需要MONGO_USERNAME，MONGO_PASSWORD这两个环境变量，但是测试和线上环境的数据库显然是需要密码的。

environments/prod.env

MONGO_HOST=localhost
MONGO_PORT=27017
MONGO_DATABASE=library
MONGO_USERNAME=prod_readwrite
MONGO_PASSWORD=123456

然后创建文件src/config.js

src/config.js

// dotenv这个包可以方便当前文件获取一个名为".env" 的文件键值对文件为环境变量，只用 npm install dotenv 安装这个包
require('dotenv').config();
// 将相应的数据库环境变量组织成一个mongoConfig并export出去
exports.mongoCofig = {
    host: process.env.MONGO_HOST,
    port: process.env.MONGO_PORT,
    database: process.env.MONGO_DATABASE,
    username: process.env.MONGO_USERNAME,
    password: process.env.MONGO_PASSWORD,
};

上面的config文件是从哪里获取到的环境变量呢，就是接下来我们要创建的这个".env"文件，由于我们现在是开发环境，直接复制environments/dev.env为.env文件即可

cp environments/dev.env .env

tips: cp为shell的复制命令，第一个参数为源文件，第二个参数为目标文件

然后修改连接数据库的文件

src/server.js

const Koa = require('koa');
const app = new Koa();
const bodyParser = require('koa-bodyparser');
const router = require('./router');
// 引入config文件
const { mongoConfig } = require('./config');
const mongoose = require('mongoose');
// 连接数据库的写法也全部变为变量，我们原本的写法 mongoose.connect(`mongodb://localhost:27017/library`, { useNewUrlParser: true }); 是不包括用户名和密码的，这时候我们需要把这两项也添加上去，如果有用户名的时候就添加，没有的时候就不添加
// mongo连接的写法为 mongodb://:@:/
mongoose.connect(`mongodb://${mongoConfig.username? mongoConfig.username + ':' + mongoConfig.password + '@': ''}${mongoConfig.host}:${mongoConfig.port}/${mongoConfig.database}`, { useNewUrlParser: true });
app
    .use(bodyParser())
    .use(router.routes())
    .use(router.allowedMethods())
app.listen(3000);
console.log('Web server run on port 3000');

再次启动

node src/server.js

打开浏览器用搜索api验证一下是不是跟原来一样

图片

完全没有问题

本文已完成电子书《Node零基础入门到服务端程序》电子书（含教程内项目代码）/ 10元，购买链接：https://mianbaoduo.com/o/bread/mbd-Z5WZk5o=
ps：前九章（本书共计十三章）内容会在这里陆续更新。