محوّل JSON إلى ENV على الإنترنت

ما هو تحويل JSON إلى ENV؟

تحويل JSON إلى ENV يحوّل JSON المنظم إلى ملف .env، وهو نوع قائمة KEY=VALUE المسطّحة التي تقرأها تقريبًا كل تطبيقات الحديثة لتحميل متغيرات البيئة. JSON جيد في التداخل؛ أما .env فبسيط للغاية بتصميمه. يُسطّح محوّل JSON إلى ENV مفاتيح JSON ويحوّلها لأحرف كبيرة وينتج ملفًا يمكنك إسقاطه مباشرةً في جذر مشروعك. إذا استخدمت Node.js مع dotenv أو Python مع python-dotenv أو Docker أو Vercel أو Netlify أو أي منصة سحابية تقريبًا، فأنت استخدمت ملفات .env. إنها المكان القياسي للاحتفاظ بالأسرار والإعدادات الخاصة بكل بيئة.

لماذا تحويل JSON إلى ENV؟

متغيرات البيئة هي الطريقة التي تفصل بها التطبيقات الحديثة الإعداد عن الكود. ملف .env هو ما تُضيفه لمشروعك المحلي (أو في الغالب ما لا تضيفه لكنك تستخدمه أثناء التطوير). عندما يكون لديك إعداد JSON وتحتاج تحويله إلى متغيرات env لنشر جديد أو حاوية Docker أو خط أنابيب CI، فإن تحويل JSON إلى ENV هو أسرع طريقة. أسباب تحويل JSON إلى ملف .env: إعداد بيئة تطوير محلية جديدة، إنشاء متغيرات env لحاوية Docker أو سر Kubernetes، الانتقال من إعداد JSON إلى إعداد يعتمد env بأسلوب 12-factor، ومشاركة الإعدادات الآمنة للمشاركة مع الزملاء دون محلل JSON في المنتصف.

كيف يعمل محوّل JSON إلى ENV

عند النقر على تحويل، تقرأ الأداة JSON وتُسطّح أي مفاتيح متداخلة وتحوّلها إلى أحرف كبيرة مع شرطات سفلية (اصطلاح متغيرات env) وتكتبها كأسطر KEY=value. الأحرف الخاصة في القيم تُهرّب أو تُحاط بعلامات اقتباس حتى يُحلَّل ملف .env بشكل صحيح. يحدث التحويل بالكامل في متصفحك، وهذا أكثر أهمية هنا من المعتاد نظرًا لأن ملفات .env كثيرًا ما تحتوي على أسرار. لا شيء يغادر جهازك.

المميزات

• تسطيح تلقائي للمفاتيح: تصبح المفاتيح المتداخلة أسماء بأسلوب PARENT_CHILD.
• تطبيع الأحرف الكبيرة: تُحوَّل المفاتيح إلى حالة متغيرات ENV القياسية.
• إفلات آمن للقيم: تُحاط القيم التي تحتوي على مسافات أو أحرف خاصة بعلامات اقتباس.
• الخصوصية أولًا: تحويل خالص في المتصفح دون جولة عبر الخادم.
• دعم الرفع: حمّل ملف .json من جهازك أو اسحبه وأفلته في حقل الإدخال.
• نسخ بنقرة واحدة: احصل على ناتج .env بزر النسخ والصقه في مشروعك.

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

1. الصق إعداد JSON في لوحة الإدخال، أو استخدم زر رفع الملف لتحميل ملف .json.
2. انقر على زر تحويل لإنشاء ناتج .env.
3. راجع وتأكد من أن أسماء المفاتيح تبدو بالشكل الذي يتوقعه تطبيقك.
4. انقر على زر النسخ والصق محتوى .env في مشروعك.

حالات الاستخدام الشائعة

• التطوير المحلي: تحويل إعداد JSON مشترك إلى ملف .env شخصي.
• Docker: إنشاء متغيرات env لتغذية الحاويات عبر --env-file.
• خطوط أنابيب CI/CD: تحضير الأسرار والإعدادات لخطوات البناء.
• نشر السحابة: استيراد المتغيرات بالجملة إلى Vercel أو Netlify أو Render أو Heroku.

مثال على التحويل

{
  "database": {
    "host": "localhost",
    "port": 5432
  },
  "api_key": "secret123"
}

DATABASE_HOST=localhost
DATABASE_PORT=5432
API_KEY=secret123

الأسئلة المتكررة

المحوّلات ذات الصلة