Cum gestionezi configurația în NestJS?

Question

Accepted Answer

NestJS oferă pachetul **`@nestjs/config`** pentru gestionarea configurației și variabilelor de mediu într-un mod structurat, type-safe și injectabil. Aceasta încarcă fișiere `.env`, validează configurația și face valorile disponibile în întreaga aplicație prin intermediul `ConfigService` injectabil. ## Configurarea 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()` încarcă variabilele de mediu (din `.env` + mediul procesului) și — crucijal — poate **valida** configurația cu un schema (Joi), deci o configurație lipsă sau invalidă oprește aplicația la startup cu o eroare clară, mai degrabă decât să eșueze în mod misterios la runtime. ## Citirea configurației prin ConfigService (injectabil) ```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 } } ``` În loc să citești `process.env` direct peste tot, injectezi `ConfigService` și apelez `get()` — type-safe, testabil și centralizat. ## Configurație cu namespace/tipizată ```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-ul grupează setări conexe și ține configurația organizată pe măsură ce crește. ## De ce să nu folosești direct 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 ``` ## Secrete și medii ```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 ``` ## De ce conteaza Gestiunea corectă a configurației este esențială pentru orice aplicație reală — manipularea URL-urilor de baze de date, cheilor API, porturi, secrete și feature flags sigur și flexibil în diferitele medii (dev, staging, production). `@nestjs/config` din NestJS oferă modul structurat și idiomativ pentru a face acest lucru, și înțelegerea acestuia este cunoaștere importantă de zi cu zi. Avantajele cheie față de citirea directă a `process.env` sunt semnificative: **`ConfigService`** injectabil face configurația testabilă (mockabilă în teste) și centralizată; **validarea la startup** (cu un schema Joi) detectează configurația lipsă sau malformată imediat cu o eroare clară mai degrabă decât ca o eșec runtime confuz adânc într-o cerere; și namespace-ul ține configurația în creștere organizată. Combinată cu practica de securitate de a păstra secretele în fișiere `.env` ignorate de git (și un `.env.example` comis), aceasta îți oferă o configurație sigură, portabilă și validată. Știu cum să configurezi `ConfigModule`, să injectez și să folosesc `ConfigService` și să validez configurația este fundamental pentru construirea aplicațiilor NestJS gata de producție și reflectă practica profesională de back-end.