محلّل ENV / Properties — حوّل ملفات .env و.properties إلى JSON

ما هي محلّل ENV / Properties — حوّل ملفات .env و.properties إلى JSON؟

محلّل ENV / Properties هو محوّل مجاني يعمل داخل المتصفح لصيغ الإعداد البسيطة من نوع KEY=VALUE المستخدمة في مشاريع البرمجيات: ملفات .env التي تقرؤها dotenv وDocker وNode.js، وملفات .properties المستخدمة في تطبيقات Java وSpring. يستخدمه المطورون ومهندسو DevOps لفحص ملف إعداد على هيئة JSON منظَّم، أو لتسليم ملف .env إلى سكربت يتوقع JSON، أو لإعادة تحويل إعدادات JSON إلى ملف .env يمكن لصقه في عملية نشر. اختر الاتجاه بمفتاح التبديل .env→JSON وJSON→.env؛ وعند إخراج النص يمكنك اختيار فاصل المساواة أو النقطتين ليطابق أعراف dotenv أو Java. يتجاهل المحلّل الأسطر الفارغة وتعليقات # أو !، ويزيل بادئة export الاختيارية، ويقسم عند أول = أو :، ويفك علامات الاقتباس المفردة أو المزدوجة عن القيم، ويحلّ \n و\t و\r و\" و\\ داخل علامات الاقتباس المزدوجة. الإخراج للقراءة فقط وهو JSON خالص أو نص إعداد خالص يمكنك نسخه، ويخبرك عدّ المفاتيح وعدّ الأحرف الفوري بمقدار ما جرى تحليله.

كيفية استخدام محلّل ENV / Properties — حوّل ملفات .env و.properties إلى JSON

1. اختر الاتجاه بمفتاح التبديل: ‎.env→JSON لتحليل ملف إعداد، أو JSON→.env لإنشاء واحد.
2. الصق نص .env / .properties أو كائن JSON مسطّحًا في مربع Input.
3. اقرأ النتيجة المحوّلة فورًا في مربع Output للقراءة فقط — يتحدّث أثناء الكتابة.
4. افتح Settings (الإعدادات) واختر فاصل المساواة (=) أو النقطتين (:) لنص الإعداد المُنشَأ.
5. استخدم زر Swap (تبديل) لقلب الاتجاه ونقل النتيجة إلى المُدخل لإجراء تحويل ذهابًا وإيابًا.
6. انقر على Copy لأخذ JSON أو نص الإعداد، وراقب عدد المفاتيح وعدد الأحرف.

أمثلة

# database
DB_HOST=localhost
DB_PORT=5432
APP_NAME="My App"

{
  "DB_HOST": "localhost",
  "DB_PORT": "5432",
  "APP_NAME": "My App"
}

{ "TOKEN": "abc123", "GREETING": "hello world" }

TOKEN=abc123
GREETING="hello world"

server.port : 8080
log.level : INFO

{
  "server.port": "8080",
  "log.level": "INFO"
}

الأسئلة الشائعة

ما الفرق بين ملفات .env و.properties؟

تخزّن ملفات .env (المستخدمة في dotenv وDocker وNode.js) وملفات Java .properties معًا أزواج KEY=VALUE بسيطة، زوجًا في كل سطر، مع # للتعليقات. الفروق الرئيسية أن .properties تسمح أيضًا بالنقطتين (:) كفاصل وبـ ! للتعليقات، وأن .env كثيرًا ما تستخدم بادئة export. تقرأ هذه الأداة كليهما: تقسم عند أول = أو :، وتزيل export والتعليقات، وتفك علامات الاقتباس.

كيف تُعالَج القيم المقتبسة وتسلسلات الهروب؟

عند التحليل إلى JSON، تُفَك القيمة المحاطة بعلامات اقتباس مفردة أو مزدوجة متطابقة. وداخل علامات الاقتباس المزدوجة تُحوَّل تسلسلات الهروب \n و\t و\r و\" و\\ إلى أحرف حقيقية. وعند إنشاء النص، تُحاط تلقائيًا أي قيمة تحتوي على سطر جديد أو مسافة في البداية/النهاية أو الفاصل أو # أو علامة اقتباس بعلامات اقتباس مزدوجة ويُعاد هروبها كي يجتاز السطر التحويل ذهابًا وإيابًا بأمان.

لماذا يقول JSON→.env إن إدخالي يجب أن يكون كائنًا؟

ملفات الإعداد خرائط مفتاح-قيمة مسطّحة، لذا لا يقبل اتجاه JSON→.env إلا كائن JSON مثل { "KEY": "value" }. لا يمكن للمصفوفات أو الأرقام المجردة أو السلاسل أو null أن تصبح ملف .env. أما الكائنات أو المصفوفات المتداخلة داخل قيمة فتُسلسَل كسلسلة JSON على السطر فلا يضيع شيء.

ماذا يحدث للتعليقات والمفاتيح المكررة؟

تُتخطّى الأسطر الفارغة والأسطر التي تبدأ بـ # أو ! أثناء التحليل. وإذا ظهر المفتاح نفسه أكثر من مرة، تفوز القيمة الأخيرة، تماشيًا مع سلوك dotenv ومعظم المُحمِّلات. ويحافظ الإخراج على الترتيب الذي تظهر فيه المفاتيح أول مرة في الإدخال.

هل تُرفع أسراري وإعداداتي إلى أي مكان؟

لا. تُنفَّذ عملية التحويل بأكملها 100% على جانب العميل داخل متصفحك باستخدام JavaScript المدمج — فلا شيء مما تلصقه يُرفع أو يُسجَّل أو يُرسَل إلى أي خادم. هذا يجعل تحويل ملفات .env المليئة بمفاتيح API وكلمات مرور قواعد البيانات والرموز آمنًا.