NestJS menyediakan pakej @nestjs/config untuk menguruskan configuration dan environment variables secara berstruktur, selamat-jenis, dan boleh disuntik. Ia memuatkan fail .env, mengesahkan config, dan menjadikan nilai tersedia di seluruh aplikasi melalui ConfigService yang boleh disuntik.
import { ConfigModule } from "@nestjs/config";
({
imports: [
ConfigModule.forRoot({
isGlobal: true, // available app-wide without re-importing
envFilePath: ".env",
validationSchema: Joi.object({ // validate env vars at startup (fail fast)
DATABASE_URL: Joi.string().required(),
PORT: Joi.number().default(3000),
JWT_SECRET: Joi.string().required(),
}),
}),
],
})
export class AppModule {}
ConfigModule.forRoot() memuatkan environment variables (daripada .env + persekitaran proses) dan — yang terpenting — boleh mengesahkan-nya dengan satu schema (Joi), supaya config yang hilang atau tidak sah merosakkan aplikasi pada masa permulaan dengan ralat yang jelas dan bukannya gagal secara misteri pada masa runtime.
@Injectable()
export class DatabaseService {
constructor(private configService: ConfigService) {} // inject ConfigService
connect() {
const url = this.configService.get<string>("DATABASE_URL");
const port = this.configService.get<number>("PORT", 3000); // with a default
}
}
Daripada membaca process.env secara langsung di merata tempat, anda menyuntik ConfigService dan memanggil get() — selamat-jenis, boleh diuji, dan terpusat.
// config/database.config.ts — group related config with registerAs
export default registerAs("database", () => ({
host: process.env.DB_HOST,
port: parseInt(process.env.DB_PORT, 10),
}));
// load it: ConfigModule.forRoot({ load: [databaseConfig] })
// access it: configService.get("database.host")
Namespace mengumpulkan tetapan berkaitan dan mengekalkan config tersusun apabila ia membesar.
✗ process.env scattered everywhere → hard to test, no validation, stringly-typed
✓ ConfigService → injectable (mockable in tests), validated at startup, typed,
centralized — the structured NestJS way
✓ Keep secrets in .env (GITIGNORED) — commit a .env.example documenting required vars
✓ In production, inject config via the platform's env vars / secret manager
✓ Validate at startup so misconfiguration fails immediately with a clear message
Pengurusan configuration yang betul adalah penting untuk mana-mana aplikasi sebenar — mengendalikan database URL, API key, port, rahsia, dan feature flag dengan selamat dan fleksibel merentas persekitaran (dev, staging, production).
@nestjs/config NestJS menyediakan cara berstruktur dan idiomatik untuk melakukan ini, dan memahaminya ialah pengetahuan sehari-hari yang penting.
Kelebihan utama berbanding membaca process.env secara langsung adalah ketara: ConfigService yang boleh disuntik menjadikan config boleh diuji (boleh dimock dalam tests) dan terpusat; validation pada masa permulaan (dengan satu schema Joi) menangkap configuration yang hilang atau cacat dengan serta-merta dengan ralat yang jelas dan bukannya sebagai kegagalan runtime yang mengelirukan jauh di dalam sesuatu request; dan namespace mengekalkan config yang membesar tersusun.
Digabungkan dengan amalan terbaik keselamatan iaitu menyimpan rahsia dalam fail .env yang digitignore (dan satu .env.example yang dikomit), ini memberi anda configuration yang selamat, mudah alih, dan disahkan.
Mengetahui cara menyediakan ConfigModule, menyuntik dan menggunakan ConfigService, serta mengesahkan config adalah asas untuk membina aplikasi NestJS yang sedia untuk production dan mencerminkan amalan back-end yang profesional.