คุณจัดการ configuration ใน NestJS อย่างไร?

Question

Accepted Answer

NestJS มีแพ็กเกจ **`@nestjs/config`** สำหรับจัดการ configuration และ environment variable ในแบบที่มีโครงสร้าง, type-safe และ injectable มันโหลดไฟล์ `.env`, validate config และทำให้ค่าต่าง ๆ ใช้ได้ทั่วทั้งแอปผ่าน `ConfigService` ที่ injectable ## การตั้งค่า ConfigModule ```ts import { ConfigModule } from "@nestjs/config"; @Module({ 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()` โหลด environment variable (จาก `.env` + environment ของ process) และ — ที่สำคัญ — สามารถ **validate** พวกมันด้วย schema (Joi) ได้ ดังนั้น config ที่ขาดหายหรือไม่ถูกต้องจะทำให้แอป crash ตอน startup พร้อม error ที่ชัดเจน แทนที่จะล้มเหลวอย่างลึกลับตอน runtime ## การอ่าน config ผ่าน ConfigService (injectable) ```ts @Injectable() export class DatabaseService { constructor(private configService: ConfigService) {} // inject ConfigService connect() { const url = this.configService.get("DATABASE_URL"); const port = this.configService.get("PORT", 3000); // with a default } } ``` แทนการอ่าน `process.env` ตรง ๆ ทุกที่ คุณ inject `ConfigService` และเรียก `get()` — type-safe, ทดสอบได้ และรวมศูนย์ ## Configuration แบบ namespace/typed ```ts // 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 จัดกลุ่มการตั้งค่าที่เกี่ยวข้องและทำให้ config เป็นระเบียบเมื่อมันเติบโตขึ้น ## ทำไมไม่ใช้ process.env ตรง ๆ? ```text ✗ 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 ``` ## ความลับและ environment ```text ✓ 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 ``` ## ทำไมจึงสำคัญ การจัดการ configuration อย่างเหมาะสมเป็นสิ่งจำเป็นสำหรับแอปพลิเคชันจริงใด ๆ — จัดการ database URL, API key, port, ความลับ และ feature flag อย่างปลอดภัยและยืดหยุ่นข้าม environment (dev, staging, production) `@nestjs/config` ของ NestJS ให้วิธีที่มีโครงสร้างและตามแบบฉบับในการทำสิ่งนี้ และการเข้าใจมันเป็นความรู้สำคัญที่ใช้ทุกวัน ข้อได้เปรียบหลักเหนือการอ่าน `process.env` ตรง ๆ นั้นสำคัญ: **`ConfigService`** ที่ injectable ทำให้ config ทดสอบได้ (mock ได้ในการทดสอบ) และรวมศูนย์; **การ validate ตอน startup** (ด้วย Joi schema) ดักจับ configuration ที่ขาดหายหรือผิดรูปแบบได้ทันทีพร้อม error ที่ชัดเจน แทนที่จะเป็นความล้มเหลวตอน runtime ที่น่าสับสนลึกอยู่ใน request; และการทำ namespace ทำให้ config ที่เติบโตขึ้นเป็นระเบียบ เมื่อรวมกับแนวปฏิบัติด้านความปลอดภัยของการเก็บความลับในไฟล์ `.env` ที่ gitignore (และ `.env.example` ที่ commit ไว้) สิ่งนี้ให้ configuration ที่ปลอดภัย, พกพาได้ และผ่านการ validate การรู้วิธีตั้งค่า `ConfigModule`, inject และใช้ `ConfigService` และ validate config เป็นพื้นฐานของการสร้างแอปพลิเคชัน NestJS ที่พร้อมใช้งานจริงและสะท้อนแนวปฏิบัติ back-end ระดับมืออาชีพ