NestJS hutoa kifurushi cha @nestjs/config kwa kusimamia configuration na environment variables kwa njia iliyopangwa, salama kwa aina (type-safe), na inayoweza kuingizwa. Hupakia faili za .env, huthibitisha config, na hufanya thamani zipatikane katika programu nzima kupitia ConfigService inayoweza kuingizwa.
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() hupakia environment variables (kutoka .env + mazingira ya process) na — muhimu zaidi — inaweza kuzithibitisha kwa schema (Joi), hivyo config inayokosekana au isiyo halali huangusha programu wakati wa kuanza kwa kosa wazi badala ya kushindwa kwa njia ya kushangaza wakati wa 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
}
}
Badala ya kusoma process.env moja kwa moja kila mahali, unaingiza ConfigService na kuita get() — salama kwa aina, inayoweza kupimwa, na ya kati.
// 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")
Namespacing huweka pamoja settings zinazohusiana na huweka config ikiwa imepangwa inapokua.
✗ 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
Usimamizi sahihi wa configuration ni muhimu kwa programu yoyote halisi — kushughulikia database URLs, API keys, ports, secrets, na feature flags kwa usalama na unyumbufu katika mazingira mbalimbali (dev, staging, production).
@nestjs/config ya NestJS hutoa njia iliyopangwa, ya kawaida ya kufanya hili, na kuelewa ni maarifa muhimu ya kila siku.
Faida kuu zaidi ya kusoma process.env moja kwa moja ni kubwa: ConfigService inayoweza kuingizwa huifanya config kuwa inayoweza kupimwa (mockable katika tests) na ya kati; validation wakati wa kuanza (kwa schema ya Joi) hunasa configuration inayokosekana au yenye makosa mara moja kwa kosa wazi badala ya kuwa shida ya runtime ya kuchanganya ndani ya request; na namespacing huweka config inayokua ikiwa imepangwa.
Ikiunganishwa na mazoezi bora ya usalama ya kuweka secrets katika faili za .env zilizo gitignored (na .env.example iliyo committed), hii hukupa configuration salama, inayohamishika, na iliyothibitishwa.
Kujua jinsi ya kuanzisha ConfigModule, kuingiza na kutumia ConfigService, na kuthibitisha config ni msingi kwa kujenga programu za NestJS zilizo tayari kwa production na huonyesha mazoezi ya kitaalamu ya back-end.