NestJS, konfigürasyon ve ortam değişkenlerini yapılandırılmış, tipe güvenli, enjekte edilebilir bir şekilde yönetmek için @nestjs/config paketini sağlar. .env dosyalarını yükler, konfigürasyonu doğrular ve değerleri uygulama genelinde enjekte edilebilir ConfigService aracılığıyla erişilebilir hale getirir.
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() ortam değişkenlerini (.env + process ortamından) yükler ve — kritik olarak — bunları bir şema (Joi) ile doğrulayabilir, böylece eksik veya geçersiz konfigürasyon uygulamayı başlangıçta net bir hatayla çökerterek, çalışma zamanında gizemli şekilde başarısız olmak yerine.
@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
}
}
process.env'i doğrudan her yerde okumak yerine, ConfigService'i enjekte eder ve get() çağırırsınız — tipe güvenli, test edilebilir ve merkezi.
// 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")
Ad alanlandırması ilgili ayarları gruplandırır ve konfigürasyon büyüdüğünde organize tutar.
✗ 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
Doğru konfigürasyon yönetimi herhangi bir gerçek uygulama için gereklidir — veritabanı URL'leri, API anahtarları, portlar, sırlar ve özellik bayraklarını ortamlar (dev, staging, production) arasında güvenli ve esnek bir şekilde işlemek.
NestJS'in @nestjs/config'i bunu yapmanın yapılandırılmış, idiyomatik yolunu sağlar ve bunu anlamak önemli günlük bilgisidir.
Doğrudan process.env'i okumaya karşı temel avantajlar önemlidir: enjekte edilebilir ConfigService konfigürasyonu test edilebilir (testlerde mocklanabilir) ve merkezi hale getirir; başlangıçta doğrulama (Joi şeması ile) eksik veya yanlış biçimlendirilmiş konfigürasyonu hemen net bir hatayla yakalar, bir istekte derin bir noktada kafa karıştırıcı çalışma zamanı başarısızlığı yerine; ve ad alanlandırması büyüyen konfigürasyonu organize tutar.
Gitignore .env dosyalarında sırları tutma ve taahhüt edilmiş .env.example güvenlik en iyi uygulamasıyla birleştirildiğinde, bu size güvenli, taşınabilir, doğrulanmış konfigürasyon verir.
ConfigModule kurulumunu bilmek, ConfigService'i enjekte etmek ve kullanmak ve konfigürasyonu doğrulamak, üretime hazır NestJS uygulamaları oluşturmak için temeldir ve profesyonel arka uç uygulamasını yansıtır.