Loading…

Hakkında Çevrimiçi .env Formatlayıcı

Dotenv dosyalarınızı okunabilir, tahmin edilebilir ve paylaşımı güvenli hale getirin. Bu .env formatlayıcısı, ANAHTAR=DEĞER satırlarını ayrıştırır, boşlukları temizler, yorumları korur ve kaydetmeden önce yapıyı standartlaştırmanıza veya ekip arkadaşları için gizlilik içermeyen bir `.env.example` oluşturmanıza yardımcı olur. Node `dotenv`, `python-dotenv`, Ruby `dotenv` ve diğer çoğu dotenv tarzı yükleyicilerle uyumludur.

Bu .env Formatlayıcı Size Ne Yapmanıza Yardımcı Olur

  • İnsan tarafından okunabilir gruplama için yorumları ve boş satırları korurken `ANAHTAR=DEĞER` satırlarını normalleştirir
  • Taramayı kolaylaştırmak ve incelemelerde daha kompakt farklar için `=` ve değerler etrafındaki boşlukları temizler
  • Hangi anahtarın çalışma zamanında gerçekten etkili olduğunu tahmin etmek yerine görebilmeniz için yinelenen anahtarları ortaya çıkarır
  • Son boşlukları kırpar ve **Son yeni satır ekle** seçeneği ile (isteğe bağlı) dosya sonunda son bir yeni satır sağlar
  • Yorum satırlarını (`# ...`) korur ve değerler içindeki tırnak içine alınmış `#` karakterlerini olduğu gibi bırakır
  • Yer tutucuları (`${VAR}` gibi) ve kaçış dizilerini genişletme yapmadan tam olarak yazıldığı gibi korur
  • LF/CRLF için düzeni normalleştirerek ve BOM sürprizlerinden kaçınarak çapraz platform projeleriyle uyumlu çalışır
  • Gizlilik içermeyen bir `.env.example` türetmeyi kolaylaştırır (anahtarları ve yapıyı kopyalayın, üretim değerlerini atın)
  • Kullanıcı dostu düzenleyici: `.env` tarzı dosyaları yapıştırın veya yükleyin, sonucu önizleyin, ardından temizlenmiş çıktıyı kopyalayın veya indirin

🔧 .env Dosyanızı Nasıl Temizler ve Biçimlendirirsiniz for env-formatter

1

1. .env Dosyanızı Yapıştırın veya Yükleyin

`.env` dosyanızı düzenleyiciye sürükleyin veya içeriği doğrudan yapıştırın. Araç, `.env`, `.env.local`, `.env.production`, `.env.test`, `.env.staging`, `.env.example` vb. tipik dotenv biçimleri için tasarlanmıştır.

2

2. Biçimlendirme Seçeneklerini İnceleyin ve Düzenleyin

Mevcut seçenekleri (örneğin **Son satır sonu ekle**) etkinleştirin veya devre dışı bırakın ve anahtarları ile yorumları nasıl düzenlemek istediğinize karar verin. Birçok ekip bu adımı tutarlı gruplama uygulamak için kullanır—örneğin `APP_`, `DB_`, `NEXT_PUBLIC_` bölümleri.

3

3. Önizleme, Kopyalama veya İndirme

Temizlenmiş çıktıyı inceleyin, yinelenenlerin ve yorumların doğru göründüğünü kontrol edin, ardından editörünüze geri kopyalayın veya biçimlendirilmiş `.env` dosyasını indirin. Normalleştirilmiş yapıyı `.env.example` veya diğer ortam varyantları için temel olarak kullanın.

Teknik Özellikler

Desteklenen Dosyalar ve Türler

Biçimlendirici, standart dotenv tarzı yapılandırma dosyalarını işler, yaygın çerçeve kurallarını da içerir.

Uzantı / DesenTürTipik Kullanım
.envTemel yapılandırmaTüm ortamlar için varsayılanlar
.env.localYerel geçersiz kılmalarMakineye özel (genellikle git-ignored)
.env.developmentOrtam varyantıGeliştirme ayarları
.env.productionOrtam varyantıDağıtım ayarları
.env.testOrtam varyantıCI / birim testleri
.env.stagingOrtam varyantıStaging veya önizleme yapılandırmaları
.env.example / .env.sampleŞablonGerçek gizli bilgiler içermeyen paylaşılan örnek dosya
MIME türleritext/plain, text/x-dotenv, application/x-envEditörler ve araçlar tarafından kullanılan yaygın içerik türleri

Ayrıştırma Kuralları (dotenv tarzı)

Biçimlendirici, diller arasında popüler dotenv ayrıştırıcılarıyla uyumlu olacak şekilde tasarlanmıştır.

YönDavranışNotlar
AnahtarlarBüyük/küçük harf duyarlı, genellikle `A–Z`, rakamlar ve `_`Okunabilirlik için UPPER_SNAKE_CASE önerilir
Atama`ANAHTAR=DEĞER` biçimindeki satırlar`=` çevresindeki ve değerlerdeki boşluklar biçimlendirici tarafından normalleştirilir
Yorumlar`#` ile başlayan satırlarTırnak içindeki değerlerdeki `#` değerin bir parçası olarak işlenir
TırnaklarTek `'…'` veya çift `"…"` tırnak`\n` ve `\t` gibi kaçış dizileri çift tırnak içinde korunur
Yerleştirme`${DEĞİŞKEN}` olduğu gibi korunurGenişletme veya kabuk benzeri değerlendirme yapılmaz
Boş SatırlarMantıksal bölümleri korumak için saklanırİstediğiniz gibi manuel olarak daraltabilir veya yeniden gruplayabilirsiniz
YinelenenlerAynı anahtara sahip birden fazla satır görüntülenirTipik dotenv davranışı: çalışma zamanında son değer geçerlidir

Normalleştirme & Satır Sonları

Biçimlendirici, farklardaki platforma özgü gürültüyü azaltmayı hedefler: `=` çevresindeki boşluklar, sarkan sondaki boşluklar ve son satır sonları normalleştirilebilir. **Son satır sonu ekle** seçeneği, Git ve farklı editörlerin LF/CRLF farklılıkları arasında bile senkronize kalmasını sağlamak için bir EOF satır sonu sağlar.

Gizlilik & Güvenlik

Biçimlendirme, bu araç için özel olarak ayrılmış güvenli bir arka uç tarafından işlenir ve yalnızca geçici işleme amaçlıdır—hiçbir üçüncü taraf API'sine bağlantı kurulmaz. Ancak, en güvenli uygulama yine de üretim sırlarını tarayıcı tabanlı araçlara yapıştırmaktan kaçınmaktır: temizlenmiş `.env.example` dosyalarını düzenlemeyi tercih edin ve gerçek sırları bir kasa veya CI gizli deposunda saklayın.

Komut Satırı Alternatifleri & Parçacıklar

Terminali mi tercih ediyorsunuz? İşte bu biçimlendiricinin bazı davranışlarını taklit etmek için yaygın CLI araçlarını kullanan birkaç yapı taşı.

Linux/macOS

Anahtarları sırala (temel, yorumları/boş satırları yoksayar)

grep -v '^\s*#' .env | grep -v '^\s*$' | sort > sorted.env

Yorum olmayan satırları alfabetik olarak sıralar, böylece yapılandırma anahtarlarını taramak ve karşılaştırmak daha kolay olur.

awk kullanarak `=` üzerinde hizala

awk -F '=' 'BEGIN{max=0} /^[[:space:]]*#/||NF<2{next} {gsub(/[[:space:]]+$/,"",$1); if(length($1)>max) max=length($1)} END{print max}' .env | xargs -I{} awk -F '=' -v w={} 'BEGIN{OFS="="} /^[[:space:]]*#/||NF<2{print; next} {k=$1; sub(/[[:space:]]+$/,"",k); v=substr($0,index($0,"=")+1); gsub(/^\s+|\s+$/,"",v); printf("% -" w "s = %s\n", k, v)}' .env > aligned.env

En geniş anahtarı ölçen ve ardından tüm `ANAHTAR = DEĞER` atamalarını bu genişliğe hizalayan iki aşamalı awk betiği.

Windows (PowerShell)

Anahtarları sırala ve tekilleştir (son değeri koru)

(Get-Content .env) | Where-Object {$_ -notmatch '^\s*#' -and $_ -notmatch '^\s*$'} | Group-Object { $_.Split('=')[0].Trim() } -AsHashTable -AsString | ForEach-Object { $_.Value[-1] } | Set-Content cleaned.env

Satırları anahtara göre gruplar ve yalnızca son oluşumu yazar, çoğu dotenv yükleyicisinin yinelenenleri nasıl çözdüğünü yansıtır.

Node.js (platformlar arası)

Minimal biçimlendirici: ayrıştır, sırala, hizala, yaz

node -e "const fs=require('fs');const s=fs.readFileSync('.env','utf8');const lines=s.split(/\r?\n/);const kv=[];const others=[];for(const l of lines){if(!l||/^\s*#/.test(l)||!l.includes('=')){others.push(l);continue;}const i=l.indexOf('=');kv.push([l.slice(0,i).trim(),l.slice(i+1).trim()]);}kv.sort((a,b)=>a[0].localeCompare(b[0]));const w=Math.max(...kv.map(([k])=>k.length),0);const out=[...kv.map(([k,v])=>k.padEnd(w)+" = "+v),...others];fs.writeFileSync('formatted.env',out.join('\n'));"

Yerel veya CI kullanımı için özel bir biçimlendiriciye uyarlayabileceğiniz kompakt bir Node betiği.

Yaygın .env Biçimlendirici Kullanım Senaryoları

Üretim Hazırlığı ve Hijyen

  • Kritik hizmetleri dağıtmadan önce yanlışlıkla yinelenen anahtarları yakala
  • Gürültülü diff'lerden kaçınmak için boşlukları ve dosya sonu yeni satırlarını normalleştir
  • `.env.example` veya gizli şablonları oluşturmadan önce yapıyı standartlaştır
# Üretim .env
NODE_ENV=production
API_URL=https://api.example.com
LOG_LEVEL=info

Ekip İşbirliği ve Onboarding

  • Tüm hizmetlerde kurallı .env düzeni uygulayarak PR gürültüsünü azalt
  • Onboarding'in daha güvenli olması için gerçek gizlilikler yerine temiz bir `.env.example` dosyasını işle
  • Yeni ekip üyelerinin tüm gerekli yapılandırma anahtarlarını hızla görmesine yardımcı ol
# .env.example
API_URL=
API_KEY=
DEBUG=false

CI ve Kalite Kapıları

  • Yinelenen anahtarların `main` veya `master` dallarına ulaşmadığından emin olmak için bir kontrol ekle
  • `.env` dosyaları temel biçimlendirme veya adlandırma kurallarını ihlal ederse derlemeleri başarısız yap
  • Yapılandırma incelemelerini değerler ve anlambilime odaklı tut, boşluk detaylarına değil

❓ Frequently Asked Questions

Yinelenen anahtarlar nasıl ele alınır?

Çoğu dotenv yükleyicisi, belirli bir anahtar için son değeri etkin olarak kabul eder. Bu biçimlendirici, çakışan yapılandırmayı sessizce göndermek yerine hangi girdileri tutacağınıza karar verebilmeniz için yinelenen anahtarları net bir şekilde gösterecek şekilde tasarlanmıştır.

Yorumlar ve boş satırlar korunacak mı?

Evet. Tam yorum satırları korunur ve boş satırlar, mantıksal gruplamanızın okunabilir kalması için saklanır. Daha yoğun veya kompakt bir düzeni tercih ederseniz bölüm aralıklarını manuel olarak ayarlayabilirsiniz.

${VAR} referanslarını genişletiyor musunuz?

Hayır. `${DB_HOST}` gibi yer tutucular düz metin olarak işlenir. Biçimlendirici, ortam referanslarını genişletmez, doğrulamaz veya çalıştırmaz, böylece çalışma zamanında enterpolasyonun nasıl ele alındığı üzerinde tam kontrole sahip olursunuz.

Gerçek gizlilikleri yapıştırmak güvenli mi?

Biçimlendirici, harici API'lerle iletişim kurmadan bu aracın arka ucunda verileri geçici olarak işlemek üzere oluşturulmuştur. Yine de, en güvenli uygulama, üretim gizliliklerini herhangi bir tarayıcı tabanlı araca yapıştırmaktan kaçınmaktır: yalnızca temizlenmiş `.env.example` dosyalarını işleyin ve gerçek değerler için özel bir gizlilik yöneticisine veya CI gizlilik deposuna güvenin.

CRLF vs LF ve BOM sorunlarına ne dersiniz?

Tutarsız satır sonları ve başıboş UTF-8 BOM'ları genellikle çirkin farklara ve ayrıştırma sürprizlerine neden olur. Bu biçimlendiriciyi düzenleyici ayarlarınızla (örneğin, her zaman LF ile ve BOM'suz kaydetmek gibi) eşleştirerek dotenv dosyalarının işletim sistemleri ve IDE'ler arasında tutarlı kalmasını sağlayın.

Bu, uygulamamın env dosyasını okuma şeklini değiştirir mi?

Hayır. Amaç, dosyayı okunması daha kolay hale getirirken anlamı bozmamaktır. Anahtarlar, değerler ve yorumlar, orijinal dotenv dosyasının yükleyiciniz için geçerli olduğu varsayılarak işlevsel olarak aynı kalır.

Pro Tips

Best Practice

Asla gerçek sırları Git'e işlemeyin. Anahtarlar ve güvenli ipuçları içeren bir `.env.example` dosyasını işleyin ve gerçek değerleri bir kasadan, CI gizli deposundan veya yerel geçersiz kılmalardan yükleyin.

Best Practice

Anahtarları etki alanına göre (`APP_`, `DB_`, `NEXT_PUBLIC_`, vb.) gruplayın ve her grubu tutarlı bir şekilde sıralayarak yeni okuyucular için bilişsel yükü azaltın.

Best Practice

Tek bir kanonik .env stilini ön-işleme kancaları veya CI kontrolleri ile zorunlu kılarak kod incelemelerinde boşluklar hakkında asla tartışmak zorunda kalmayın.

Best Practice

Boşluk, `#`, `=` veya kabuk ayrılmış karakterleri içeren değerleri, farklı dotenv uygulamaları arasında ince ayrıştırma sorunlarından kaçınmak için tırnak içine alın.

Additional Resources

Other Tools