محول .env إلى JSON

حول محول .env إلى JSON

ملفات البيئة (.env) عبارة عن نص عادي بصيغة KEY=VALUE، ما يجعل كتابتها سهلة لكنه يجعل تمريرها إلى كود يتوقّع إعدادات بنية منظمة أمرًا مرهقًا. تحلّل هذه الأداة صيغة .env — بما في ذلك تعليقات # والقيم الموضوعة بين علامتي اقتباس والفاصلين = و : — وتنتج كائن JSON يمكنك استخدامه مباشرة في محمّل إعدادات، أو fixture اختبار، أو جلسة تصحيح أخطاء. ثلاثة خيارات تتحكم في الناتج: استنتاج الأنواع يحوّل السلاسل النصية التي تبدو أرقامًا أو قيمًا منطقية إلى أنواع JSON حقيقية، وتداخل المفاتيح المنقطة يحوّل FEATURE.CACHE.TTL إلى { "FEATURE": { "CACHE": { "TTL": ... } } }، ومعالجة التعليقات تتيح الإبقاء على أسطر # التي توثّق الملف الأصلي أو حذفها.

كيفية تحويل .env إلى JSON

1. 1

   الصق محتوى ملف .env

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

2. 2

   اضبط الخيارات المتقدمة عند الحاجة

   افتح الخيارات المتقدمة لتفعيل أو إيقاف استنتاج الأنواع، وتداخل المفاتيح المنقطة (وفاصلها)، وما إذا كانت التعليقات تُحفظ كحقول $comments أو تُتجاهل. الإعدادات الافتراضية تطابق الاصطلاح الشائع: استنتاج الأنواع مفعّل، والمفاتيح متداخلة، والتعليقات محفوظة.

3. 3

   اضغط على تحويل

   يقرأ المحلّل كل سطر، ويزيل التعليقات وعلامات الاقتباس، وينتج كائن JSON في لوحة الإخراج. عند تغيير أي خيار لاحقًا، تُعاد عملية التحويل فورًا دون الحاجة إلى الضغط على تحويل مجددًا.

4. 4

   انسخ أو نزّل JSON

   استخدم أيقونة النسخ لأخذ JSON ولصقه في مكان آخر، أو نزّله كملف .json. تحتاج إلى الاتجاه المعاكس؟ استخدم أيقونة تبديل الاتجاه للانتقال إلى JSON إلى Env.

المراجع

• The Twelve-Factor App — الإعدادات (Config)

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

• dotenv (motdotla) — README

  التطبيق المرجعي والمواصفة الفعلية لصيغة ملفات .env: أسطر KEY=VALUE، وتعليقات #، والقيم بين علامتي اقتباس.

• RFC 8259 — تنسيق تبادل بيانات JSON

  مواصفة IETF لتنسيق JSON الذي تنتجه هذه الأداة.

أدوات مطورين ذات صلة

أسئلة شائعة حول Env إلى JSON

كيف أحوّل ملف .env إلى JSON أونلاين؟

الصق محتوى ملف .env في لوحة الإدخال ثم اضغط على تحويل. تحلّل الأداة كل سطر بصيغة KEY=VALUE وتعرض كائن JSON منسّقًا في لوحة الإخراج، يمكنك نسخه أو تنزيله كملف .json.

هل ترفع هذه الأداة ملف .env الخاص بي إلى خادم؟

لا. يتم التحليل بالكامل داخل متصفحك باستخدام JavaScript — لا تُرسل أي طلبات شبكة تحمل محتوى ملفك، وهذا مهم لأن ملفات .env غالبًا ما تحتوي على أسرار مثل مفاتيح API وبيانات اعتماد قواعد البيانات.

هل يحافظ تحويل .env إلى JSON على التعليقات؟

نعم، افتراضيًا. تُحفظ أسطر التعليقات (التي تبدأ بـ #) كحقل $comments في JSON الناتج، بحيث يرتبط كل مفتاح بالتعليق الذي سبقه. غيّر خيار التعليقات إلى "تجاهل" في الخيارات المتقدمة لحذفها بدلاً من ذلك.

كيف تُعالَج القيم المنطقية والأرقام عند تحويل .env إلى JSON؟

مع تفعيل استنتاج الأنواع (الخيار الافتراضي)، تتحول قيم مثل true وfalse و5432 إلى أنواع boolean/number حقيقية في JSON بدلاً من نصوص. عطّل استنتاج الأنواع في الخيارات المتقدمة للإبقاء على كل قيمة كنص عادي، مطابقًا تمامًا لنص .env الأصلي.

هل يمكنني تحويل مفاتيح .env المنقطة إلى كائنات JSON متداخلة؟

نعم. مع تفعيل "مفاتيح منقطة ← متداخلة" (الفاصل الافتراضي هو ".")، يتحول مفتاح مثل APP.CACHE.TTL=60 إلى { "APP": { "CACHE": { "TTL": 60 } } }. عطّل هذا الخيار للإبقاء على المفتاح المنقط المسطّح كما هو.

ما الفرق بين .env وJSON في الإعدادات؟

ملف .env هو قائمة مسطّحة من أزواج KEY=VALUE مخصصة لمتغيرات بيئة العملية (راجع إرشادات الإعدادات في The Twelve-Factor App)، بينما يدعم JSON البنى المتداخلة والأنواع الأصلية. يتيح لك التحويل فحص قيم .env أو مقارنتها كبيانات منظمة، أو تمريرها إلى أدوات لا تقبل سوى JSON.

هل تدعم الأداة القيم الموضوعة بين علامتي اقتباس في ملفات .env؟

نعم. القيم الموضوعة بين علامتي اقتباس مفردة أو مزدوجة، مثل NAME="My App"، تُزال عنها علامات الاقتباس تلقائيًا قبل تطبيق استنتاج الأنواع.