·vincent
Dotenv源码学习
dotenv 源码学习
源码学习
项目开发者 .env 的作用
.env文件是用来自定义配置的一个简单方法，可以将一些不能在代码中存储的敏感/账号数据从代码中剥离出来，作为环境变量存储在环境中。
.env 的使用方法
介绍
.env 文件通常不包含在版本控制内，它可能包含敏感的 API Key 或者 密码。
所有需要环境变量定义(不敏感的定义)的项目都需要创建一个.env.example 文件，这个环境变量包含他们自己定义的环境变量或者联合开发包含的环境变量。
项目合作开发者可以独立的复制 .env.example并且重命名为.env，并且修改为正确的本地环境配置，存储密码key或者提供他们必要的值。
在这个使用方法中 .env 文件应该添加到.gitignore文件中并且永远不会被项目的合作者签入/签出。
这个方法确保里边没有敏感的 API Key 或者 密码在版本控制中出现从而减少了安全风险，并且开发环境中的配置永远不会告知合作开发者。
配置规则
text
1
2DB_HOST=127.0.0.1
3DB_NAME=timerDabase"
4DB_PORT=4442
5DB_USER=vincent
6DB_UNSECURE=true
7引入 dotenv
js
1
2let dotenv = require('dotenv');
3const env = process.env.ENV
4dotenv.config(`./env.${env}`);
5console.log(process.env);Dotenv
dotenv 是一个npm包， 作用是将.env的文件解析成json对象。并且把这个json对象解析到process.env的环境变量上。 之后就可以在代码中通过process.env[key]来获取环境变量。
源码
js
1const fs = require('fs')
2const path = require('path')
3const os = require('os')
4
5function log (message) {
6 console.log(`[dotenv][DEBUG] ${message}`)
7}
8
9const NEWLINE = '\n'
10const RE_INI_KEY_VAL = /^\s*([\w.-]+)\s*=\s*("[^"]*"|'[^']*'|[^#]*)?(\s*|\s*#.*)?$/
11const RE_NEWLINES = /\\n/g
12const NEWLINES_MATCH = /\r\n|\n|\r/
13
14// 把读取的字符串解析成对象
15function parse (src, options) {
16 const debug = Boolean(options && options.debug)
17 const obj = {}
18
19 // 在分割成行和处理之前转换缓冲区
20 src.toString().split(NEWLINES_MATCH).forEach(function (line, idx) {
21 // 在“KEY=VAL”中匹配“KEY”和“VAL”
22 const keyValueArr = line.match(RE_INI_KEY_VAL)
23 // 匹配到了?
24 if (keyValueArr != null) {
25 const key = keyValueArr[1]
26 // 默认值为空字符串，未定义或缺少值
27 let val = (keyValueArr[2] || '')
28 const end = val.length - 1
29 const isDoubleQuoted = val[0] === '"' && val[end] === '"'
30 const isSingleQuoted = val[0] === "'" && val[end] === "'"
31
32 // 如果是单引号或双引号，删除引号
33 if (isSingleQuoted || isDoubleQuoted) {
34 val = val.substring(1, end)
35
36 // 如果双引号，展开换行
37 if (isDoubleQuoted) {
38 val = val.replace(RE_NEWLINES, NEWLINE)
39 }
40 } else {
41 // 清除周围的空格
42 val = val.trim()
43 }
44
45 obj[key] = val
46 } else if (debug) {
47 const trimmedLine = line.trim()
48
49 // 忽略空行和注释行
50 if (trimmedLine.length && trimmedLine[0] !== '#') {
51 log(`failed to match key and value when parsing line ${idx + 1}: ${line}`)
52 }
53 }
54 })
55
56 return obj
57}
58
59function resolveHome (envPath) {
60 return envPath[0] === '~' ? path.join(os.homedir(), envPath.slice(1)) : envPath
61}
62
63// Populates process.env from .env file
64function config (options) {
65 let dotenvPath = path.resolve(process.cwd(), '.env')
66 let encoding = 'utf8'
67 const debug = Boolean(options && options.debug)
68
69 if (options) {
70 if (options.path != null) {
71 dotenvPath = resolveHome(options.path)
72 }
73 if (options.encoding != null) {
74 encoding = options.encoding
75 }
76 }
77
78 try {
79 // 指定编码将返回字符串而不是缓冲区
80 const parsed = parse(fs.readFileSync(dotenvPath, { encoding }), { debug })
81
82 Object.keys(parsed).forEach(function (key) {
83 if (!Object.prototype.hasOwnProperty.call(process.env, key)) {
84 process.env[key] = parsed[key]
85 } else if (debug) {
86 log(`"${key}" is already defined in \`process.env\` and will not be overwritten`)
87 }
88 })
89
90 return { parsed }
91 } catch (e) {
92 console.error(e);
93 return { error: e }
94 }
95}
96
97module.exports.config = config
98module.exports.parse = parse
99parse
parse把传入的字符串转成对象并输出
js
1// Parses src into an Object
2function parse (src, options) {
3 const debug = Boolean(options && options.debug)
4 const obj = {}
5
6 // convert Buffers before splitting into lines and processing
7 src.toString().split(NEWLINES_MATCH).forEach(function (line, idx) {
8 // matching "KEY' and 'VAL' in 'KEY=VAL'
9 const keyValueArr = line.match(RE_INI_KEY_VAL)
10 // matched?
11 if (keyValueArr != null) {
12 const key = keyValueArr[1]
13 // default undefined or missing values to empty string
14 let val = (keyValueArr[2] || '')
15 const end = val.length - 1
16 const isDoubleQuoted = val[0] === '"' && val[end] === '"'
17 const isSingleQuoted = val[0] === "'" && val[end] === "'"
18
19 // if single or double quoted, remove quotes
20 if (isSingleQuoted || isDoubleQuoted) {
21 val = val.substring(1, end)
22
23 // if double quoted, expand newlines
24 if (isDoubleQuoted) {
25 val = val.replace(RE_NEWLINES, NEWLINE)
26 }
27 } else {
28 // remove surrounding whitespace
29 val = val.trim()
30 }
31
32 obj[key] = val
33 } else if (debug) {
34 const trimmedLine = line.trim()
35
36 // ignore empty and commented lines
37 if (trimmedLine.length && trimmedLine[0] !== '#') {
38 log(`failed to match key and value when parsing line ${idx + 1}: ${line}`)
39 }
40 }
41 })
42
43 return obj
44}
45