يوفر NestJS حزمة @nestjs/config لإدارة المتغيرات البيئية والإعدادات بطريقة منظمة وآمنة من حيث الأنواع وقابلة للحقن. تحمّل ملفات .env، تتحقق من صحة الإعدادات، وتجعل القيم متاحة في جميع أنحاء التطبيق عبر خدمة ConfigService القابلة للحقن.
{ } ;
({
: [
.({
: ,
: ,
: .({
: .().(),
: .().(),
: .().(),
}),
}),
],
})
{}
ConfigModule.forRoot() تحمّل متغيرات البيئة (من .env + بيئة العملية) ويمكنها — بشكل حاسم — التحقق منها باستخدام مخطط (Joi)، لذا فإن الإعداد الناقص أو غير الصحيح يتسبب في تعطل التطبيق عند بدء التشغيل برسالة خطأ واضحة بدلاً من الفشل الغامض في وقت التشغيل.
@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 مباشرة في كل مكان، تحقن ConfigService وتستدعي get() — آمن من حيث الأنواع، قابل للاختبار، ومركزي.
// 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")
تجميع الفضاء الاسمي الإعدادات ذات الصلة ويحافظ على تنظيم الإعدادات مع نموها.
✗ 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
إدارة الإعدادات الصحيحة ضرورية لأي تطبيق حقيقي — للتعامل مع عناوين URL لقواعد البيانات ومفاتيح API والمنافذ والأسرار وأعلام الميزات بأمان ومرونة عبر البيئات المختلفة (التطوير والتجريب والإنتاج).
@nestjs/config الخاص بـ NestJS توفر الطريقة المنظمة والاصطلاحية للقيام بذلك، وفهمها معرفة مهمة يومية.
المزايا الرئيسية مقابل قراءة process.env مباشرة كبيرة: خدمة ConfigService القابلة للحقن تجعل الإعدادات قابلة للاختبار (قابلة للمحاكاة في الاختبارات) ومركزية؛ التحقق عند بدء التشغيل (باستخدام مخطط Joi) يكتشف الإعدادات الناقصة أو المشوهة فوراً برسالة خطأ واضحة بدلاً من فشل التشغيل المربك العميق في الطلب؛ والفضاء الاسمي يحافظ على الإعدادات المتنامية منظمة.
بالاقتران مع أفضل ممارسة الأمان المتمثلة في الاحتفاظ بالأسرار في ملفات .env المتجاهلة من قبل git (ومثال .env.example مرتكب)، يوفر لك هذا إعدادات آمنة وقابلة للنقل والتحقق منها.
معرفة كيفية إعداد ConfigModule وحقن واستخدام ConfigService والتحقق من الإعدادات أمر أساسي لبناء تطبيقات NestJS جاهزة للإنتاج ويعكس ممارسة احترافية للطرف الخلفي.