أداة مقارنة مفتاحية بين .env و .env.example

أداة مقارنة مفتاحية بين .env و .env.example

الانحراف بين ما هو واقعي .env ملف و .env.example الملف هو أحد أضعف مصادر الأخطاء في الإطلاق. تُضاف المفاتيح أثناء التطوير، وتُنسخ إلى الإنتاج، ثم تُنسى في الملف النموذجي. تبقى القيم المُستخدمة كمُستعارات في .env حيث كان يجب أن تُوضع الأسرار الحقيقية. يُمكن لهذا الأداة ترتيب الملفين بجانب بعضهما البعض ويُعطي تقريرًا مصنفًا يوضح ما هو مفقود، مُضاف، أو غير مطابق، بحيث يمكنك تسوية انحرافات التكوين قبل أن يُطلق.

تتم جميع عمليات التحليل بالكامل في المتصفح. لا يغادر أي شيء الذي تلصقه جهازك، ويمكنك اختيار إخفاء كل قيمة في تقرير الشاشة أو الملف المُصدر بحيث لا تتسرب الأسرار في الصور أو التقارير المُشاركة.

كيفية استخدام

1. لصق محتوى الملف .env.example في المدخل الأيسر.
2. لصق محتوى الملف الحقيقي .env في المدخل الأيمن.
3. قم بتعديل الخيارات إذا لزم الأمر. احتفظ إخفاء القيم مُفعّل عند العمل مع أسرار حقيقية.
4. راجع الأحجار المجمعة في الأعلى: المطابقة، المفقودة، المُضاف، وانحراف القيم.
5. قم بفحص كل قسم مصنف لرؤية أي مفتاح يقع في كل مربع.
6. انقر ينسخ أو تحميل الوصول إلى تقرير القابل للتصدير لمشاركة النتيجة مع فريقك أو إضافتها إلى قائمة الإطلاق.

خصائص

• مُقارنة مصنفة – مُستندات مفقودة، مُضاف، غير مطابقة، ومطابقة منفصلة.
• مُقارنة القيم – يُحدد المفاتيح التي تُستخدم فيها قيمة المثال ولكن تختلف عن القيمة الحقيقية.
• مفتاح الحساسية للحالة – إيقاف التبديل لاعتبار DB_HOST و db_host مفتاحًا واحدًا.
• إخفاء القيم – إخفاء الأسرار الحقيقية في التقرير بحيث تبقى الصور والتصاميم آمنة.
• مُحلل مُدرك للحالات الطرفية – يتعامل مع التعليقات، السطور الفارغة، القيم المُقتطعة، و export السلاسل المُقدمة.
• نسخ / تحميل التقرير – تقرير نصي جاهز للاستخدام في تعليق في الطلب، أو دليل الإطلاق، أو ملخص الحادث.
• من جانب العميل فقط – لا يتم إرسال القيم إلى أي مكان.

متى يجب استخدام هذه الأداة؟

• عند تدريب مطوّر جديد وتأكيد أن ما هو موجود محليًا .env يُطابق الملف النموذجي الحالي.
• عند إعداد الإطلاق وتأكيد أن التكوين في الإنتاج يغطي كل المتغيرات المطلوبة.
• عند تشغيل ميزة تفشل بشكل سكين لأن المفتاح المطلوب لم يُضاف إلى البيئة.
• عند مراجعة خدمة قديمة حيث .env.example أصبحت غير متوافقة مع الواقع.