محوّل JSON إلى .env

ما هو ملف .env؟

// Generate .env lines from a JSON object in Node.js
const config = {
  DATABASE_URL: 'postgres://user:pass@localhost:5432/mydb',
  PORT: 8080,
  DEBUG: true,
  NOTE: 'value with spaces',
};

const needsQuotes = (s) => /[\s#"'\n]/.test(s);

const env = Object.entries(config)
  .map(([key, value]) => {
    if (typeof value === 'string') {
      return needsQuotes(value)
        ? `${key}=${JSON.stringify(value)}`
        : `${key}=${value}`;
    }
    return `${key}=${value ?? ''}`; // null -> empty value
  })
  .join('\n');

console.log(env);
// DATABASE_URL=postgres://user:pass@localhost:5432/mydb
// PORT=8080
// DEBUG=true
// NOTE="value with spaces"

الميزات الرئيسية

أمثلة

{
  "DATABASE_URL": "postgres://user:pass@localhost:5432/mydb",
  "PORT": 8080,
  "DEBUG": true,
  "LOG_LEVEL": "info",
  "API_KEY": "sk_live_abc123"
}

DATABASE_URL=postgres://user:pass@localhost:5432/mydb
PORT=8080
DEBUG=true
LOG_LEVEL=info
API_KEY=sk_live_abc123

{
  "GREETING": "Hello, World",
  "MOTD": "line one\nline two",
  "COLOR": "#ff0000",
  "NOTE": "value with # hash",
  "EMPTY": null
}

GREETING="Hello, World"
MOTD="line one\nline two"
COLOR="#ff0000"
NOTE="value with # hash"
EMPTY=

{
  "databaseUrl": "postgres://localhost/mydb",
  "poolSize": 10,
  "enable-signup": true
}

DATABASE_URL=postgres://localhost/mydb
POOL_SIZE=10
ENABLE_SIGNUP=true

{
  "APP_NAME": "my-app",
  "FEATURES": { "signup": true, "beta": false },
  "REGIONS": ["us-east-1", "eu-west-1"]
}

APP_NAME=my-app
FEATURES="{\"signup\":true,\"beta\":false}"
REGIONS="[\"us-east-1\",\"eu-west-1\"]"

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

1. 1

   الصق كائن JSON

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

2. 2

   شاهد ناتج .env الحيّ

   يظهر ملف .env فورًا في لوحة الناتج. فعّل 'توحيد المفاتيح' لأسماء UPPER_SNAKE_CASE، أو 'إضافة بادئة export' إن كان الملف سيُستدعى بـ source في الصدفة.

3. 3

   انسخ أو نزّل

   انقر نسخ لأخذ الـ .env إلى حافظتك، أو تنزيل لحفظه كملف .env — جاهز لإسقاطه في مشروعك وتحميله بـ dotenv.

مزالق JSON الشائعة

["a", "b", "c"]

{"ITEMS": "a,b,c"}

{'PORT': 8080,}

{"PORT": 8080}

{"DB": {"host": "localhost", "port": 5432}}

{"DB_HOST": "localhost", "DB_PORT": 5432}

{"2fa-enabled": true}

{"TWO_FA_ENABLED": true}

{"MSG": Hello World}

{"MSG": "Hello World"}

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

توليد .env من تصدير تهيئة

خذ تصدير تهيئة JSON من API، أو لوحة إعدادات، أو مدير أسرار وحوّله إلى ملف .env جاهز للاستخدام للتطوير المحلي أو لحاوية.

بناء قوالب .env

ابنِ كائن JSON يصف المتغيّرات التي تحتاجها خدمة جديدة، وحوّله إلى .env، وثبّت .env.example ليعرف زملاؤك بالضبط أي المفاتيح يملؤونها.

جسر بين أدوات مهيّأة بـ JSON وdotenv

تبعث بعض الأدوات التهيئة كـ JSON بينما يتوقّع وقت تشغيلك .env. حوّل ناتج JSON إلى صيغة dotenv ليتفق نصفا المسار على المتغيّرات نفسها.

إنتاج ملفات بيئة صدفة قابلة للاستدعاء

فعّل بادئة export لتوليد ملف يمكنك استدعاؤه مباشرة بـ source في الصدفة أو خطوة CI، محوّلًا كتلة تهيئة JSON إلى متغيّرات بيئة مُصدَّرة بلصقة واحدة.

تهيئة بذهاب وإياب

اقرنه بمحوّل .env إلى JSON لتحرير التهيئة كـ JSON منظّم وكتابتها عكسيًا إلى .env — يضمن الاقتباس الآمن للذهاب والإياب بقاء القيم في كلا الاتجاهين.

توحيد مفاتيح مختلطة الحالة

حوّل كائن JSON بمفاتيح camelCase أو kebab-case إلى .env بأسماء متغيّرات UPPER_SNAKE_CASE متّسقة باستخدام خيار توحيد المفاتيح، بما يطابق اصطلاحات متغيّرات البيئة.

تفاصيل تقنية

إدخال كائني فقط مع تسلسل حسب النوع

يُحلَّل الإدخال بدالة JSON.parse() الأصلية في المتصفح ويجب أن يكون كائنًا في المستوى الأعلى؛ تُرفَض المصفوفات والقيم القياسية بخطأ واضح. تُسلسَل كل خاصية في المستوى الأعلى حسب النوع: تُكتَب الأرقام والقيم المنطقية مجرّدة، وتصبح null قيمة فارغة (KEY=)، وتُكتَب السلاسل مباشرة ما لم تحتوِ مسافة أو سطرًا جديدًا أو # أو اقتباسًا، وعندها تُقتبَس مزدوجًا وتُهرَّب لأمان الذهاب والإياب.

القيم المتداخلة وتوحيد المفاتيح

تُسلسَل الكائنات والمصفوفات المتداخلة بـ JSON.stringify مدمج، وتُقتبَس مزدوجًا وتُهرَّب، مع تحذير يسمّي المفاتيح المسطَّحة. تحوّل خطوة توحيد المفاتيح الاختيارية المفاتيح إلى UPPER_SNAKE_CASE، محلّةً معظم الأسماء غير الصالحة؛ وعند إبقاء المفاتيح حرفيًا، يُطلِق أي مفتاح لا يطابق [A-Za-z_][A-Za-z0-9_]* تحذير اسم غير صالح. ويمكن إضافة بادئة export اختيارية لكل سطر.

في المتصفح — بلا رفع، بلا خادم

تجري كل المعالجة بالكامل في محرّك JavaScript بمتصفحك؛ ولا تُرسَل أي بيانات JSON عبر الشبكة في أي لحظة. المُسلسِل مكتوب داخليًا بلا اعتماديات خارجية، لأن مكتبة dotenv الخاصة بـ Node ليست آمنة للمتصفح. تنتقل المدخلات الأكبر من 200KB من الوضع الحيّ إلى الوضع اليدوي (نقرة تحويل صريحة) للحفاظ على استجابة المتصفح.

أفضل الممارسات

أبقِ المفاتيح حرفيًا ما لم تحتج اصطلاحات البيئة

اترك توحيد المفاتيح معطّلًا عندما يتوقّع التطبيق المستهلك فعلًا أسماء المفاتيح بالضبط كما في JSON لديك، كي لا يُعاد تسمية أي شيء بشكل غير متوقّع. فعّله فقط عندما تريد تحديدًا اصطلاح UPPER_SNAKE_CASE الذي تستخدمه متغيّرات البيئة عادةً.

سطّح التداخل عمدًا لا عرضًا

تصبح القيمة المتداخلة سلسلة JSON نصية مبهمة في .env، ولا تستطيع معظم التطبيقات تحليلها عكسيًا تلقائيًا. عندما ترى تحذير التسطيح، فضّل إعادة تشكيل الـ JSON إلى مفاتيح مسطّحة مسبوقة (DB_HOST، DB_PORT) قبل التحويل، أو اختر صيغة منظّمة مثل YAML بدلًا من ذلك.

ثق بالاقتباس التلقائي للذهاب والإياب

دع الأداة تقرّر متى تقتبس — فهي تقتبس مزدوجًا وتهرّب القيم التي تحتاج ذلك فقط. هذا يبقي الـ .env مقروءًا مع ضمان بقاء القيم التي تحتوي مسافات أو أسطرًا جديدة أو # دون تغيير في رحلة ذهاب وإياب خلال محوّل .env إلى JSON.

ولّد الأسرار فقط في أداة تعمل في المتصفح وحده

الـ JSON الذي تحوّله هنا هو فعليًا مجموعة بيانات اعتماد. ولّد .env فقط في أداة تعمل بالكامل داخل المتصفح؛ تحقق من صفر طلبات شبكة في أدوات المطوّر. هذا المحوّل مؤهَّل، بخلاف المولّدات التي تعمل على الخادم أو عبر API.

تحقق من إدخال JSON أولًا

إذا كان الـ JSON مكتوبًا يدويًا أو مجمّعًا بسكربت، تحقق منه عبر منسّق JSON أولًا لالتقاط الفواصل اللاحقة أو المفاتيح غير المقتبسة، كي تحصل على .env نظيف بدل خطأ تحليل محيّر.

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