Nasıl Çalışır

.env dosyaları “basit” görünür ama parser implementasyonları arasında anlamlı farklar vardır. Bu araç yaygın kuralları (php-dotenv, node-dotenv, godotenv) ana hatlarıyla takip eden bir parser çalıştırır; üç noktada onlardan daha katıdır: anahtarlar [A-Za-z_][A-Za-z0-9_]* kalıbına uymalıdır, yani APP.NAME ve MY-VAR reddedilir; ${VAR} enterpolasyonu uygulanmaz; girdi satır satır ayrıştırıldığı için bir değer gerçek satır sonlarına yayılamaz.

Desteklenen kalıplar

KEY=value — temel form.
KEY="value with spaces" — çift tırnaklı; \n, \r, \t, \\, \" escape’lerini çözer.
KEY='value' — tek tırnaklı; ham, escape yok.
export KEY=value — bash uyumluluğu için export prefix’i atlanır.
# yorum satırı veya KEY=value # inline yorum (sadece tırnaksız değerler için ve yalnızca # işaretinden önce boşluk varsa).
KEY= — boş değer.

Yaygın hatalar

= etrafında boşluk: KEY = value — php-dotenv, node-dotenv, godotenv ve bu araç bunu sorunsuz ayrıştırır; boşluklar kırpılır. Yine de yaygın yazım KEY=value, güvenli tarafta kalın: = etrafında boşluk olmasın.
Tırnaksız boşluk: KEY=hello world — değerin tamamı mı alınır, satır hata mı sayılır? Parser’a göre değişir: node-dotenv ve godotenv hello world okur, php-dotenv satırı “unexpected whitespace” hatasıyla reddeder. Her zaman tırnak kullanın.
Multi-line değerler: php-dotenv, node-dotenv ve godotenv çift tırnak içinde gerçek satır sonlarını kabul eder; bu araç etmez — girdiyi satır satır ayrıştırır, bu yüzden burada multi-line değerleri \n escape’i ile yazın.

Hassas değerlerin maskelenmesi

Araç, key, secret, token, password, pwd, auth, credential kelimelerinden birini içeren anahtarların değerlerini maskeler. Bu sadece görünüm için — gerçek koruma değil. Bir .env içeriğini bir tarayıcıya yapıştırmak, hassas değerleri:

Tarayıcı history’sine,
Clipboard’una,
Ekran paylaşımına,
Tarayıcı uzantılarına,

açar. Bu araç hassas değerleri dışarı göndermez, ama yine de üretim secrets’ınızı buraya yapıştırmayın. Dummy/test verisi ile çalışın.

Gizlilik

Tüm parsing tarayıcınızda yapılır. Veriler dışarı çıkmaz.