JSON إلى ENV
حوّل كائنًا من JSON أو YAML إلى أسطر .env بصيغة KEY=value. تُجمع المفاتيح المتداخلة باستخدام فاصل مثل __، لذا يصبح {"db":{"host":"x"}} هو DB__HOST=x، وتستخدم المصفوفات فهرس كل عنصر. ولا تُقتبس القيم إلا عند الحاجة، ليُحمّل الملف على نحو صحيح باستخدام dotenv وأدوات التحميل المشابهة.
الأسئلة الشائعة
كيف تتحول الكائنات المتداخلة؟
تُجمع المفاتيح على طول المسار باستخدام الفاصل الذي تختاره، ويكون الفاصل الافتراضي شرطتين سفليتين. يتوافق هذا مع اصطلاح إعدادات ASP.NET Core والعديد من الأدوات الأخرى التي تقرأ الإعدادات المتداخلة من متغيرات البيئة.
كيف تُعالج المصفوفات؟
يحصل كل عنصر على فهرسه كجزء من المفتاح، لذا تصبح {"hosts":["a","b"]} هي HOSTS__0=a وHOSTS__1=b.
متى تُقتبس القيم؟
تُكتب القيم المؤلفة من حروف وأرقام وعلامات ترقيم بسيطة كما هي. وتُحاط القيم التي تحتوي على مسافات أو علامات اقتباس أو # أو $ أو شرطات مائلة عكسية بعلامات اقتباس مفردة، أما القيم التي تحتوي على علامة اقتباس مفردة أو فاصل سطر فتُحاط بعلامات اقتباس مزدوجة، مع استخدام رموز الهروب \n و\".
ماذا يحدث للمحارف غير المسموح بها في الأسماء؟
تُستبدل المحارف غير الحروف والأرقام والشرطات السفلية، وكذلك النقاط عند اختيار فاصل النقطة، بشرطة سفلية. ويُضاف خط سفلي في بداية الاسم إذا بدأ برقم.
ما وظيفة خياري الأحرف الكبيرة والبادئة؟
يكتب خيار الأحرف الكبيرة أسماء مثل DB__HOST، وهو الأسلوب الشائع لمتغيرات البيئة. وتُضاف بادئة مثل APP_ قبل كل اسم، ما يساعد على جمع متغيرات التطبيق الواحد معًا.
كيف تُكتب القيم الخالية والمنطقية؟
تُكتب القيم المنطقية والأرقام كنص، مثل true أو 5432. وتتحول القيمة null إلى قيمة فارغة، مثل KEY=.