https://github.com/nestjsx/nestjs-config
https://www.jianshu.com/p/01c9db1f462e
在NestJS
项目中推荐使用nestjs-config
模块来获取配置。nestjs-config
提供了 config.get() 函数,可通过config.get(‘app.host’)的方式来读取配置。nestjs-config
地址:github.com/nestjs-comm…
最佳实践
获取配置
一般来说,在程序中有以下方式可以获取配置:
- 硬代码,直接写死。- ❌ 可维护性低
- 写死在ts文件,例如config/app.ts中。 - ❌ 无法区分环境进行配置
- 直接读取.env文件。 - ❌ 虽然解决了环境变量问题但是不推荐
环境变量存储在 .env中,配置信息保存在ts文件中,然后使用 config.get() 函数来读取。- ✅ 最佳实践
编码规范
在此统一规定:所有程序配置信息 必须 通过 config.get() 来读取,绝不在配置文件以外的范围读取环境变量。
设计理念
这样做主要有以下几个优势:
定义分明,config.get() 是配置信息,.env 文件只是用来区分不同环境;
代码健壮性, config.get() 在 .env 文件之上多出来一个抽象层,会使代码更加健壮,更加灵活。
nestjs-config
引入方式
// app.module.ts 加载config文件夹中的配置文件
ConfigModule.load(path.resolve(__dirname, '..', 'config', '**/!(*.d).{ts,js}')),
复制代码
使用示例
.env文件
用于配置各种线上敏感数据和服务器定制化数据,例如数据库密码,秘钥,服务器ip等通过dotenv库读取env文件中的环境变量并进行格式化,封装成通用的方法
// env-unit.ts
import * as dotenv from 'dotenv'
dotenv.config()
/**
* 格式化环境变量
* @param key 环境变量的键值
* @param defaultValue 默认值
* @param callback 格式化函数
*/
const fromatValue = <T>(key: string, defaultValue: T, callback: (value: string) => T): T => {
const value: string | undefined = process.env[key]
if (typeof value === 'undefined') {
return defaultValue
}
return callback(value)
}
export const env = (key: string, defaultValue: string = '') => fromatValue(key, defaultValue, value => value)
export const envNumber = (key: string, defaultValue: number = 0) => fromatValue(key, defaultValue, value => Number(value))
export const envBoolean = (key: string, defaultValue: boolean = false) => fromatValue(key, defaultValue, value => value === 'true')
复制代码
在config文件夹下新建app.ts, 通过使用env(), envNumber(),envBoolean()方法来读取.env并格式化配置,同时第二个参数可设置默认值
// config/app.ts
export {
host: envNumber('DB_HOST', 3306)
}
复制代码
在service中通过依赖注入的方式使用config
import {InjectConfig} from 'nestjs-config';
@Injectable()
class SomeService {
constructor(@InjectConfig() private readonly config) {
}
getAppHost() {
// 使用字符串加.的格式获取配置
return this.config.get('app.host')
}
}
复制代码