محوّل .env إلى JSON

ما هو ملف .env؟

// Parse a .env file to a JSON object in Node.js using dotenv
import { parse } from 'dotenv';

const envText = `# Database
DATABASE_URL=postgres://user:pass@localhost:5432/mydb
DEBUG=true`;

// dotenv.parse returns a plain object of string values
const parsed = parse(envText);

// Every value is a string, just like process.env
const json = JSON.stringify(parsed, null, 2);

console.log(json);
// {
//   "DATABASE_URL": "postgres://user:pass@localhost:5432/mydb",
//   "DEBUG": "true"
// }

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

أمثلة

# Database
DATABASE_URL=postgres://user:pass@localhost:5432/mydb
DATABASE_POOL_SIZE=10

# Auth
JWT_SECRET="super secret value"
SESSION_TIMEOUT=3600

# Feature flags
ENABLE_SIGNUP=true
VITE_API_BASE=https://api.example.com

{
  "DATABASE_URL": "postgres://user:pass@localhost:5432/mydb",
  "DATABASE_POOL_SIZE": "10",
  "JWT_SECRET": "super secret value",
  "SESSION_TIMEOUT": "3600",
  "ENABLE_SIGNUP": "true",
  "VITE_API_BASE": "https://api.example.com"
}

POSTGRES_DB=mydb
POSTGRES_USER=admin
POSTGRES_PASSWORD=s3cr3t!
PGDATA=/var/lib/postgresql/data
TZ=UTC
NGINX_HOST=example.com
NGINX_PORT=80

{
  "POSTGRES_DB": "mydb",
  "POSTGRES_USER": "admin",
  "POSTGRES_PASSWORD": "s3cr3t!",
  "PGDATA": "/var/lib/postgresql/data",
  "TZ": "UTC",
  "NGINX_HOST": "example.com",
  "NGINX_PORT": "80"
}

export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
export AWS_REGION=us-east-1
export DEPLOY_ENV=production

{
  "AWS_ACCESS_KEY_ID": "AKIAIOSFODNN7EXAMPLE",
  "AWS_SECRET_ACCESS_KEY": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
  "AWS_REGION": "us-east-1",
  "DEPLOY_ENV": "production"
}

APP_NAME=My App                 # unquoted value, inline comment stripped
GREETING="Hello,\nWorld"        # double quotes: \n becomes a real newline
LITERAL='no \n escapes here'    # single quotes: kept literally
PRIVATE_KEY="-----BEGIN KEY-----
line two
line three
-----END KEY-----"
EMPTY=

{
  "APP_NAME": "My App",
  "GREETING": "Hello,\nWorld",
  "LITERAL": "no \\n escapes here",
  "PRIVATE_KEY": "-----BEGIN KEY-----\nline two\nline three\n-----END KEY-----",
  "EMPTY": ""
}

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

1. 1

   الصق ملف .env

   أدخل أو الصق محتوى .env في حقل الإدخال أعلاه. يمكنك أيضًا النقر على 'تحميل مثال' لتجربة ملف .env لـ Node/Vite، أو ملف بيئة Docker Compose، أو قالب أسرار CI.

2. 2

   شاهد ناتج JSON الحيّ

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

3. 3

   انسخ أو نزّل

   انقر نسخ لأخذ الـ JSON إلى حافظتك، أو تنزيل لحفظه كملف .json — جاهز لمحمّل إعدادات أو مدير أسرار أو أي أداة تقرأ JSON.

مزالق .env الشائعة

DATABASE_URL
DEBUG true

DATABASE_URL=
DEBUG=true

API_KEY = abc123

API_KEY=abc123

COLOR=#ff0000

COLOR="#ff0000"

GREETING='Hello\nWorld'

GREETING="Hello\nWorld"

KEY="-----BEGIN-----
line two

KEY="-----BEGIN-----
line two
-----END-----"

PORT=3000
PORT=8080

PORT=8080

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

تغذية التهيئة في أدوات قائمة على JSON

حوّل ملف .env إلى JSON لتحميل تهيئة البيئة في الأدوات والسكربتات وحزم SDK التي تقرأ JSON بدل متغيّرات البيئة — مدقّقات الإعدادات وفاحصات المخطّطات ومولّدات الكود.

استيراد الأسرار إلى مدير

تقبل كثير من مديري الأسرار (AWS Secrets Manager وVault وDoppler) صيغة JSON للاستيراد الجماعي. حوّل ملف .env إلى كائن JSON أولًا، ثم ادفع المجموعة كلها في عملية واحدة بدل متغيّر واحد في كل مرة.

معاينة ملف .env طويل بنظرة واحدة

حوّل ملف .env ممتدًا إلى JSON منظّم ومُزاح لتمسح المفاتيح، وترصد التكرارات عبر التحذير، وتراجع التهيئة بصيغة مقروءة قبل تثبيت التغييرات.

توليد كائنات تهيئة مكتوبة الأنواع

فعّل استنتاج الأنواع للحصول على أرقام وقيم منطقية وnull في الـ JSON، ثم غذّه في طبقة تهيئة مكتوبة الأنواع أو خطوة JSON-to-TypeScript لاشتقاق واجهة لمتغيّرات بيئتك.

التحقق مقابل JSON Schema

حوّل .env إلى JSON ومرّره عبر مدقّق JSON Schema لفرض المفاتيح المطلوبة وصيغ القيم والقيم المسموحة في CI — مع التقاط البيئات المهيّأة خطأً قبل النشر.

ترحيل تهيئة env_file لـ Docker Compose

حوّل ملف env_file الذي تقرأه حزمة Compose إلى JSON لاستخدامه في أداة تنسيق أخرى أو خادم تهيئة أو توثيق — دون كشف بيانات اعتماد حقيقية لأي خدمة خارجية.

تفاصيل تقنية

تحليل سطرًا بسطر متوافق مع dotenv

يُحلَّل الإدخال سطرًا بسطر. تُتجاهَل الأسطر الفارغة وأسطر التعليقات (أول محرف غير فراغي #)، وتُزال بادئة export الاختيارية، ويُقسَّم كل سطر متبقٍ عند أول علامة = إلى مفتاح وقيمة. تُشذَّب المفاتيح من المسافات المحيطة. وتتبع القيم قواعد dotenv: الاقتباس المزدوج يعالج أكواد الهروب \n \t \r \\ \" ويسمح بالامتداد متعدد الأسطر، والاقتباس المفرد حرفي، والقيم غير المقتبسة تزيل المسافات الزائدة والتعليقات الداخلية.

استنتاج أنواع اختياري

افتراضيًا تُخرَج كل القيم سلاسل نصية في JSON، مطابِقةً سلوك dotenv أثناء التشغيل حيث تكون قيم process.env دائمًا سلاسل نصية. مع تفعيل استنتاج الأنواع تُرقّى القيم غير المقتبسة: تصبح السلاسل الرقمية أرقامًا في JSON، وتصبح true/false قيمًا منطقية، وتصبح القيم الفارغة أو null قيمة null في JSON. ولا تُستنتَج أنواع القيم المقتبسة أبدًا — فالاقتباس يميّزها كسلاسل نصية صريحة. وتُحَل المفاتيح المكرّرة بفوز الأخير مع تحذير.

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

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

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

أبقِ الناتج النصي الافتراضي ليطابق dotenv

تحمّل dotenv كل قيمة كسلسلة نصية، فيعكس الناتج النصي الافتراضي بالضبط ما يراه تطبيقك أثناء التشغيل. فعّل استنتاج الأنواع فقط عندما يتوقّع المستهلك اللاحق فعلًا JSON مكتوب الأنواع — وإلا خاطرت بعدم تطابق يجعل '0' أو 'false' يتصرّفان في JSON خلافًا لتطبيقك العامل.

اقتبس القيم المحتوية على # أو مسافات

على القيم غير المقتبسة، مسافة متبوعة بـ # تبدأ تعليقًا داخليًا، وتُشذَّب المسافات الزائدة. إذا كانت قيمة تحتوي # بشكل مشروع (ألوان سداسية، روابط بشظايا) أو مسافات ذات معنى، فاقتبسها بعلامتين مزدوجتين لتُحفَظ حرفيًا في الـ JSON.

احسم المفاتيح المكرّرة عند المصدر

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

لا تلصق أسرار الإنتاج أبدًا في محوّلات تعمل على الخادم

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

تحقق من الـ JSON قبل استخدامه لاحقًا

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

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