ما هو ملف .env؟

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

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

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

وصف الأداة

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

الميزات

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

حالات الاستخدام

  • التحقق قبل النشر: فحص ملفات .env قبل نشر التطبيقات لضمان عدم وجود أخطاء في التكوين
  • التعاون الجماعي: التحقق من ملفات .env.example المشتركة للحفاظ على التناسق بين أعضاء الفريق
  • مشاريع الهجرة: التحقق من ملفات المتغيرات البيئية عند الانتقال بين منصات النشر المختلفة
  • تدقيق التكوين: مراجعة والتحقق من تكوينات البيئة لعدة خدمات
  • تكامل CI/CD: التحقق من ملفات البيئة كجزء من عمليات البناء الآلية
  • التعلم والتعليم: مساعدة المطورين على تعلم الصيغة الصحيحة لملف .env وقواعد الصياغة
  • استكشاف الأخطاء وإصلاحها: تحديد سريع لمشكلات الصياغة التي تسبب مشاكل تكوين التطبيق

قواعد التحقق

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