ما هو ملف .env؟

ملف .env (dotenv) هو ملف تكوين نصي بسيط يُستخدم لتخزين المتغيرات البيئية للتطبيقات. يحتوي على أزواج مفتاح‑قيمة تُعرِّف إعدادات مثل عناوين قواعد البيانات، مفاتيح API، أرقام المنافذ، وغيرها من القيم التي يجب أن تظل منفصلة عن الشيفرة المصدرية. نشأت الصيغة من منهجية Twelve‑Factor App، التي توصي بتخزين التكوين في المتغيرات البيئية لإبقاء البيانات الحساسة خارج الشيفرة وجعل التطبيقات قابلة للنقل بسهولة بين بيئات مختلفة (التطوير، الاختبار، الإنتاج).

لماذا يتم التحقق من صحة ملفات .env؟

تتبع ملفات المتغيرات البيئية قواعد صرامة في الصياغة: يجب أن تستخدم أسماء المتغيرات أحرفًا كبيرة، أرقامًا، وشرطات سفلية (وتبدأ بحرف أو شرطة سفلية)، ويجب أن يتبع كل تعيين الصيغة KEY=value. يمكن أن يتسبب الصياغ غير الصحيح، أو المتغيرات المكررة، أو أخطاء التنسيق في فشل التطبيقات بصمت أو سلوك غير متوقع. يساعد التحقق من صحة ملفات .env قبل النشر على اكتشاف هذه المشكلات مبكرًا، ويمنع الأخطاء أثناء التشغيل، ويضمن أن تكوينك مُنسَّق بشكل صحيح.

وصف الأداة

Dotenv Validator هي أداة متخصصة لفحص صيغ وبنية ملفات .env. تتحقق من أن ملف المتغيرات البيئية يتبع الصيغة الصحيحة، وتحدد أخطاء الصياغ مع أرقام الأسطر المحددة، وتكشف عن المتغيرات المكررة، وتوفر إحصائيات حول ملف التكوين. تساعد الأداة المطورين على ضمان تنسيق ملفات .env بشكل سليم قبل استخدامها في التطبيقات.

الميزات

  • التحقق من الصياغة: يتحقق من أن جميع إعلانات المتغيرات تتبع الصيغة KEY=value
  • فحص اسم المتغير: يضمن أن أسماء المتغيرات تستخدم أحرفًا كبيرة فقط، أرقامًا، وشرطات سفلية
  • الكشف عن التكرارات: يحدد أسماء المتغيرات المكررة ويظهر موقعها

قواعد التحقق

  • يجب أن تبدأ أسماء المتغيرات بحرف (A‑Z) أو بشرطة سفلية (_)
  • يمكن لأسماء المتغيرات أن تحتوي فقط على أحرف كبيرة، أرقام، وشرطات سفلية
  • يجب أن يتبع كل متغير الصيغة KEY=value
  • لا يُسمح بأسماء متغيرات مكررة
  • يتم تجاهل التعليقات (الأسطر التي تبدأ بـ #) والأسطر الفارغة
  • يجب أن يكون كل تعيين متغير في سطر منفصل