تحويل إعدادات البيئة
الصق ملف .env واختر JSON أو YAML، أو حوّل كائن JSON/YAML مسطحًا إلى .env. استورد الملفات المحلية وبدّل المدخلات والمخرجات وانسخ النتيجة أو نزّلها. يعمل كل شيء في متصفحك؛ ولا تُرفع الإعدادات ولا تُخزن في سجل التصفح أو التخزين المحلي.
القيم وعلامات الاقتباس
متغيرات البيئة نصوص: تبقى PORT=3000 وDEBUG=false وCODE=0012 بالقيم "3000" و"false" و"0012". تُحوّل الأرقام والقيم المنطقية في JSON/YAML إلى نصوص. تحتاج Null والمصفوفات والكائنات المتداخلة إلى قيمة نصية صريحة. ضع قيم YAML مثل 0012 بين علامتي اقتباس عندما تكون كتابتها الدقيقة مهمة.
يدعم المحلل الأسطر الفارغة وتعليقات # وبادئة export، والاقتباس بعلامات مفردة أو مزدوجة أو خلفية مع قيم متعددة الأسطر. تُفسّر تسلسلات \n و\r فقط داخل علامات الاقتباس المزدوجة. وتبقى علامات الاقتباس والشرطات المائلة العكسية كما كُتبت في الحالات الأخرى، وفقًا للسلوك الشائع في dotenv. تستخدم المفاتيح الأحرف والأرقام والشرطات السفلية ولا يمكن أن تبدأ برقم. تختار المخرجات نمط اقتباس يحافظ على القيمة.
فحوصات الإعدادات
تظهر مفاتيح .env المكررة مع أرقام أسطرها؛ ويُستخدم التعريف الأخير. تظهر أخطاء لعلامات الاقتباس الختامية المفقودة، والنص بعد علامات الاقتباس الختامية، وعمليات الإسناد غير الصالحة، مع روابط إلى السطر المعني. تُصدر علامات الاقتباس المنحنية تحذيرًا. وتُعد المفاتيح المكررة في JSON/YAML أخطاء.
لا تُحفظ التعليقات أو نمط الاقتباس الأصلي أو التنسيق. تبقى المراجع مثل ${NAME} وأوامر الصدفة كما كُتبت ولا تُنفّذ مطلقًا. تختلف قواعد أدوات تحميل .env؛ وتتبع هذه الأداة مجموعة القواعد الموثّقة بدلًا من تفسير نصوص الصدفة البرمجية.