.env'den JSON'a Dönüştürücü

.env Dosyası Nedir?

// 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"
// }

Temel Özellikler

Örnekler

# 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": ""
}

Nasıl Kullanılır

1. 1

   .env Dosyanızı Yapıştırın

   .env içeriğinizi yukarıdaki giriş alanına girin veya yapıştırın. Ayrıca bir Node/Vite .env, bir Docker Compose env dosyası veya bir CI sırları şablonu denemek için 'Örnek yükle'ye tıklayabilirsiniz.

2. 2

   Canlı JSON Çıktısını Görün

   JSON çıkış panelinde anında belirir. Dize yerine sayı ve boole değeri istiyorsanız 'Türleri çıkar' seçeneğini açın ve 2 veya 4 boşluklu girinti seçin.

3. 3

   Kopyalayın veya İndirin

   JSON'u panonuza almak için Kopyala'ya veya .json dosyası olarak kaydetmek için İndir'e tıklayın — bir yapılandırma yükleyici, bir sır yöneticisi veya JSON okuyan herhangi bir araç için hazırdır.

Yaygın .env Tuzakları

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

Yaygın Kullanım Alanları

Yapılandırmayı JSON Tabanlı Araçlara Besleyin

Ortam yapılandırmasını, ortam değişkenleri yerine JSON okuyan araçlara, betiklere ve SDK'lara yüklemek için bir .env dosyasını JSON'a dönüştürün — yapılandırma doğrulayıcılar, şema denetleyicileri ve kod üreticileri.

Sırları Bir Yöneticiye İçe Aktarın

Birçok sır yöneticisi (AWS Secrets Manager, Vault, Doppler) toplu içe aktarma için JSON kabul eder. Önce bir .env dosyasını JSON nesnesine dönüştürün, ardından her değişkeni teker teker değil, tüm seti tek bir işlemde gönderin.

Uzun Bir .env Dosyasını Bir Bakışta İnceleyin

Dağınık bir .env dosyasını yapılandırılmış, girintili JSON'a çevirin; böylece anahtarları tarayabilir, uyarı aracılığıyla yinelemeleri görebilir ve değişiklikleri işlemeden önce yapılandırmayı okunabilir bir biçimde gözden geçirebilirsiniz.

Türlü Yapılandırma Nesneleri Üretin

JSON'da sayılar, boole değerleri ve null almak için Türleri çıkar seçeneğini etkinleştirin, ardından onu türlü bir yapılandırma katmanına veya ortam değişkenleriniz için bir arayüz türetmek üzere bir JSON'dan TypeScript'e adımına besleyin.

Bir JSON Şemasına Göre Doğrulayın

.env dosyasını JSON'a dönüştürün ve gerekli anahtarları, değer biçimlerini ve izin verilen enum'ları CI'da uygulamak için bir JSON Şeması doğrulayıcıdan geçirin — yanlış yapılandırılmış ortamları dağıtımdan önce yakalayın.

Docker Compose env_file Yapılandırmasını Taşıyın

Compose yığınınızın okuduğu env_file dosyasını, gerçek kimlik bilgilerini herhangi bir harici hizmete maruz bırakmadan başka bir orkestrasyon aracında, bir yapılandırma sunucusunda veya belgelerde kullanmak üzere JSON'a çevirin.

Teknik Ayrıntılar

Satır Satır dotenv Uyumlu Ayrıştırma

Giriş satır satır ayrıştırılır. Boş satırlar ve yorum satırları (ilk boşluk olmayan karakter #) atlanır, isteğe bağlı bir export ön eki kaldırılır ve kalan her satır ilk = işaretinden anahtar ve değere bölünür. Anahtarların çevreleyen boşlukları kırpılır. Değerler dotenv kurallarını izler: çift tırnaklar \n \t \r \\ \" kaçışlarını işler ve çok satırlı yayılmalara izin verir, tek tırnaklar birebirdir ve tırnaksız değerler sondaki boşlukları ve satır içi yorumları kaldırır.

İsteğe Bağlı Tür Çıkarımı

Varsayılan olarak tüm değerler, process.env değerlerinin her zaman dize olduğu dotenv'in çalışma zamanı davranışıyla eşleşecek şekilde JSON dizeleri olarak yayılır. Türleri çıkar etkinleştirildiğinde, tırnaksız değerler yükseltilir: sayısal dizeler JSON sayıları olur, true/false boole değeri olur ve boş veya null değerler JSON null olur. Tırnaklı değerler asla çıkarsanmaz — tırnaklar onları açık dizeler olarak işaretler. Yinelenen anahtarlar bir uyarıyla son-kazanır olarak çözülür.

Tarayıcı Tabanlı — Yükleme Yok, Sunucu Yok

Tüm işleme tamamen tarayıcınızın JavaScript motorunda gerçekleşir; hiçbir noktada hiçbir .env verisi ağ üzerinden iletilmez. Ayrıştırıcı şirket içinde yazıldığından harici bağımlılık yoktur — Node dotenv kütüphanesi dosya sistemine dayanır ve tarayıcı için güvenli değildir. 200 KB'den büyük girişler, tarayıcıyı yanıt verir durumda tutmak için canlı moddan manuel moda (açık bir Dönüştür tıklaması) geçer.

En İyi Uygulamalar

dotenv ile Eşleşmesi İçin Varsayılan Dize Çıktısını Koruyun

dotenv her değeri bir dize olarak yükler, bu nedenle varsayılan dize çıktısı, uygulamanızın çalışma zamanında gördüğü şeyi tam olarak yansıtır. Türleri çıkar seçeneğini yalnızca alt akış tüketicisi gerçekten türlü JSON beklediğinde etkinleştirin — aksi takdirde '0' veya 'false' değerinin JSON'da çalışan uygulamanızdakinden farklı davrandığı bir uyumsuzluk riskine girersiniz.

# veya Boşluk İçeren Değerleri Tırnak İçine Alın

Tırnaksız değerlerde bir boşluğun ardından gelen # bir satır içi yorum başlatır ve sondaki boşluklar kırpılır. Bir değer meşru olarak bir # (onaltılık renkler, parça URL'leri) veya anlamlı boşluklar içeriyorsa, JSON'da birebir korunsun diye onu çift tırnak içine alın.

Yinelenen Anahtarları Kaynakta Çözün

Araç son değeri tutar ve bir anahtar yinelendiğinde sizi uyarır, ancak bir .env dosyasındaki yineleme neredeyse her zaman bir hatadır. Hangi sırrın etkin olduğu konusunda belirsizlik olmaması için gereksiz satırı kaldırın.

Üretim Sırlarını Asla Sunucu Tarafı Dönüştürücülere Yapıştırmayın

Bir .env dosyası fiilen bir kimlik bilgileri listesi olduğundan, onu yalnızca tamamen tarayıcıda çalışan bir araçta dönüştürün. Bu dönüştürücü çalışır — DevTools'ta sıfır ağ isteği doğrulayın — bu yüzden sunucu tarafı veya API destekli dönüştürücülerin aksine gerçek sırlar için güvenlidir.

JSON'u Alt Akışta Kullanmadan Önce Doğrulayın

Dönüştürdükten sonra, yapısal bir sürprizin erken ortaya çıkması için onu bir şema doğrulayıcıya, bir sır yöneticisi içe aktarmasına veya bir yapılandırma yükleyiciye beslemeden önce JSON'u JSON Biçimlendirici üzerinden çalıştırarak yapıyı onaylayın.

Sıkça Sorulan Sorular