JSON'dan .env'e Dönüştürücü

.env Dosyası Nedir?

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

Temel Özellikler

Örnekler

{
  "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\"]"

Nasıl Kullanılır

1. 1

   JSON Nesnenizi Yapıştırın

   Yukarıdaki giriş alanına düz bir JSON nesnesi girin veya yapıştırın. Ayrıca bir yapılandırma nesnesi, tırnak gerektiren değerler veya iç içe bir nesne denemek için 'Örnek yükle'ye tıklayabilirsiniz.

2. 2

   Canlı .env Çıktısını Görün

   .env dosyası çıkış panelinde anında belirir. UPPER_SNAKE_CASE adları için 'Anahtarları normalleştir' seçeneğini veya dosya bir kabukta source edilecekse 'export ön eki ekle' seçeneğini açın.

3. 3

   Kopyalayın veya İndirin

   .env'i panonuza almak için Kopyala'ya veya .env dosyası olarak kaydetmek için İndir'e tıklayın — projenize bırakıp dotenv ile yüklemeye hazırdır.

Yaygın JSON Tuzakları

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

Yaygın Kullanım Alanları

Bir Yapılandırma Dışa Aktarımından .env Üretin

Bir API'den, bir ayarlar panosundan veya bir sır yöneticisinden gelen bir JSON yapılandırma dışa aktarımını alın ve onu yerel geliştirme ya da bir konteyner için kullanıma hazır bir .env dosyasına çevirin.

.env Şablonları İskelesi Kurun

Yeni bir hizmetin ihtiyaç duyduğu değişkenleri tanımlayan bir JSON nesnesi oluşturun, onu bir .env'e dönüştürün ve takım arkadaşlarınızın hangi anahtarları dolduracağını tam olarak bilmesi için bir .env.example işleyin.

JSON Yapılandırmalı Araçları dotenv'e Köprüleyin

Bazı araçlar yapılandırmayı JSON olarak yayarken çalışma zamanınız bir .env bekler. JSON çıktısını dotenv biçimine dönüştürün, böylece işlem hattının her iki yarısı da aynı değişkenler üzerinde uzlaşır.

Source Edilebilir Kabuk env Dosyaları Üretin

Bir kabukta veya CI adımında doğrudan source edebileceğiniz bir dosya üretmek için export ön ekini etkinleştirin; bir JSON yapılandırma bloğunu tek bir yapıştırmada dışa aktarılmış ortam değişkenlerine çevirin.

Yapılandırmayı Gidiş-Dönüş Yapın

Yapılandırmayı yapılandırılmış JSON olarak düzenlemek ve onu .env'e geri yazmak için bunu .env'den JSON'a Dönüştürücü ile eşleştirin — gidiş-dönüş güvenli tırnaklama, değerlerin her iki yönde de sağ çıkmasını garanti eder.

Karışık Harfli Anahtarları Normalleştirin

Anahtarları normalleştir seçeneğini kullanarak camelCase veya kebab-case anahtarlara sahip bir JSON nesnesini, ortam değişkeni kurallarıyla eşleşen tutarlı UPPER_SNAKE_CASE değişken adlarına sahip bir .env'e dönüştürün.

Teknik Ayrıntılar

Tip Bazlı Serileştirme ile Yalnızca Nesne Girişi

Giriş, tarayıcının yerel JSON.parse() ile ayrıştırılır ve üst düzey bir nesne olmalıdır; diziler ve skalerler net bir hatayla reddedilir. Her üst düzey özellik türe göre serileştirilir: sayılar ve boole değerleri çıplak yazılır, null boş bir değer olur (KEY=) ve dizeler, bir boşluk, satır sonu, # veya tırnak içermedikleri sürece doğrudan yazılır; içeriyorlarsa gidiş-dönüş güvenliği için çift tırnaklanır ve kaçış işlenir.

İç İçe Değerler ve Anahtar Normalleştirme

İç içe nesneler ve diziler kompakt bir JSON.stringify ile serileştirilir, çift tırnaklanır ve kaçış işlenir; düzleştirilen anahtarları adlandıran bir uyarı ile. İsteğe bağlı Anahtarları normalleştir adımı, anahtarları UPPER_SNAKE_CASE'e dönüştürerek çoğu geçersiz adı çözer; anahtarlar birebir tutulduğunda, [A-Za-z_][A-Za-z0-9_]* ile eşleşmeyen herhangi bir anahtar geçersiz-ad uyarısını tetikler. Her satıra isteğe bağlı bir export ön eki eklenebilir.

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 JSON verisi ağ üzerinden iletilmez. Node dotenv kütüphanesi tarayıcı için güvenli olmadığından, serileştirici harici bağımlılık olmadan şirket içinde yazılmıştır. 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

env Kurallarına İhtiyacınız Yoksa Anahtarları Birebir Koruyun

Tüketen uygulama, JSON'unuzdaki tam anahtar adlarını zaten bekliyorsa, hiçbir şeyin beklenmedik şekilde yeniden adlandırılmaması için Anahtarları normalleştir seçeneğini kapalı bırakın. Yalnızca özellikle ortam değişkenlerinin geleneksel olarak kullandığı UPPER_SNAKE_CASE kuralını istediğinizde açın.

İç İçe Geçmeyi Kazara Değil, Bilinçli Düzleştirin

İç içe bir değer, .env'de çoğu uygulamanın otomatik olarak geri ayrıştıramayacağı opak bir JSON dizesi olur. Düzleştirme uyarısını gördüğünüzde, dönüştürmeden önce JSON'u düz, ön ekli anahtarlara (DB_HOST, DB_PORT) yeniden şekillendirmeyi tercih edin veya YAML gibi yapılandırılmış bir biçim seçin.

Gidiş-Dönüşler İçin Otomatik Tırnaklamaya Güvenin

Tırnaklamaya ne zaman gerek olduğuna aracın karar vermesine izin verin — yalnızca buna ihtiyaç duyan değerleri çift tırnaklar ve kaçış işler. Bu, .env'i okunabilir tutarken boşluk, satır sonu veya # içeren değerlerin .env'den JSON'a Dönüştürücü üzerinden geri bir gidiş-dönüşten değişmeden sağ çıkmasını garanti eder.

Sırları Yalnızca Tarayıcı İçi Bir Araçta Üretin

Burada dönüştürdüğünüz JSON fiilen bir kimlik bilgileri kümesidir. Bir .env'i yalnızca tamamen tarayıcıda çalışan bir araçta üretin; DevTools'ta sıfır ağ isteği doğrulayın. Bu dönüştürücü, sunucu tarafı veya API destekli üreteçlerin aksine bu koşulu sağlar.

Önce JSON Girişini Doğrulayın

JSON elle yazıldıysa veya bir betikle bir araya getirildiyse, kafa karıştırıcı bir ayrıştırma hatası yerine temiz bir .env almanız için, sondaki virgülleri veya tırnaksız anahtarları yakalamak üzere önce onu JSON Biçimlendirici ile doğrulayın.

Sıkça Sorulan Sorular