NestJS ofron paketën @nestjs/config për menaxhimin e konfigurimit dhe variablave të mjedisit në një mënyrë të strukturuar, e sigurt në lloj dhe të injektueshem. Ajo ngarkon skedarë .env, validizon config-un dhe bën vlerat të disponueshme në të gjithë aplikacionin përmes ConfigService injektueshem.
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() ngarkon variablat e mjedisit (nga .env + mjedisi i procesit) dhe — në mënyrë kritike — mund të validojë ato me një skemë (Joi), pra një config që mungon ose është i pavlefshëm bën që aplikacioni të rrëzohej në startup me një gabim të qartë në vend që të dështojë në mënyrë misteriozë në 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ë vend të leximit të process.env direktërisht kudo, ju injektoni ConfigService dhe thirrni get() — i sigurt në lloj, i testueshem dhe i centralizuar.
// 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")
Emërndarja grumullon cilësimet e ndërlidhura dhe mban config-un të organizuar ndërsa rritet.
✗ 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
Menaxhimi i duhur i konfigurimit është thelbësor për çdo aplikacion të vërtetë — trajtimi i URL-ve të bazës së të dhënave, çelësave API, portave, sekreteve dhe flamurave të veçorive në mënyrë të sigurt dhe fleksibël në të gjithë mjedisët (dev, staging, production).
NestJS's @nestjs/config ofron mënyrën e strukturuar dhe idiomatike për ta bërë këtë, dhe kuptimi i tij është njohuri e rëndësishme të përditshme.
Avantazhet kryesore ndaj leximit të process.env direkt janë të rëndësishme: ConfigService injektueshem e bën config-un të testueshem (simulueshem në teste) dhe të centralizuar; validimi në startup (me një skemë Joi) kap mungesën ose config-un të keqformuar menjëherë me një gabim të qartë në vend të një dështimi të hutueshem në runtime të thellë në një kërkesë; dhe emërndarja mban config-un në rritje të organizuar.
E kombinuar me praktikën më të mirë të sigurisë të mbajtjes së sekreteve në skedarë .env të injektuar (dhe një .env.example të dorëzuar), kjo ju jep konfigurimin e sigurt, të mbajtshëm dhe të validuar.
Dija se si të vendoset ConfigModule, si të injektohet dhe të përdoret ConfigService, dhe si të validizohet config-u është themelore për ndërtimin e aplikacioneve NestJS të gatshme për prodhim dhe pasqyron praktikën profesionale të back-end.