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.
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() î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.
@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
}
}
În loc să citești process.env direct peste tot, injectezi ConfigService și apelez get() — type-safe, testabil și centralizat.
// 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.
✗ 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
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.
O bibliotecă de întrebări de interviu IT cu răspunsuri detaliate — de la Junior la Senior.
Donează