.env dosyası nedir?

Bir .env dosyası (dotenv), uygulamalar için ortam değişkenlerini depolamak amacıyla kullanılan düz metin bir yapılandırma dosyasıdır. Veritabanı URL'leri, API anahtarları, port numaraları ve kodunuzdan ayrı tutulması gereken diğer yapılandırma değerlerini tanımlayan anahtar-değer çiftlerini içerir. Bu format, Twelve-Factor App metodolojisinden gelmekte olup, yapılandırmanın ortam değişkenlerinde saklanmasını önerir; böylece hassas veriler kaynak koddan uzak tutulur ve uygulamalar farklı ortamlar (geliştirme, test, üretim) arasında kolayca taşınabilir hale gelir.

Neden .env dosyalarını doğrulamalıyız?

Ortam değişkeni dosyaları katı sözdizimi kurallarına uymalıdır: değişken adları yalnızca büyük harf, rakam ve alt çizgi içermeli (bir harf veya alt çizgi ile başlamalı) ve her atama KEY=value biçiminde olmalıdır. Geçersiz sözdizimi, yinelenen değişkenler veya format hataları, uygulamaların sessizce başarısız olmasına veya beklenmedik davranışlar sergilemesine yol açabilir. .env dosyalarını dağıtımdan önce doğrulamak, bu sorunları erken yakalamayı, çalışma zamanı hatalarını önlemeyi ve yapılandırmanızın doğru biçimlendirildiğinden emin olmayı sağlar.

Araç Açıklaması

Dotenv Validator, .env dosyası sözdizimini ve yapısını kontrol etmek için özelleştirilmiş bir araçtır. Ortam değişkeni dosyanızın doğru biçimde olup olmadığını doğrular, belirli satır numaralarıyla sözdizimi hatalarını gösterir, yinelenen değişken bildirimlerini tespit eder ve yapılandırma dosyanız hakkında istatistikler sunar. Bu doğrulayıcı, geliştiricilerin .env dosyalarını uygulamalara dahil etmeden önce doğru biçimlendirilmiş olmasını sağlamalarına yardımcı olur.

Özellikler

  • Sözdizimi Doğrulama: Tüm değişken bildirimlerinin KEY=value biçimini izlediğini kontrol eder
  • Değişken Adı Kontrolü: Değişken adlarının yalnızca büyük harf, rakam ve alt çizgi içerdiğinden emin olur
  • Çift Kayıt Tespiti: Aynı değişken adlarını tespit eder ve konumlarını gösterir
  • Satır Satır Analiz: Bulunan sözdizimi hataları için belirli satır numaralarını raporlar
  • İstatistikler: Toplam satır sayısını ve geçerli ortam değişkeni sayısını gösterir
  • Yorum Desteği: # ile başlayan yorum satırlarını doğru şekilde işler
  • Boş Satır İşleme: Doğrulama sürecinde boş satırları yok sayar

Kullanım Senaryoları

  • Dağıtıma Öncesi Doğrulama: Uygulamaları dağıtmadan önce .env dosyalarını kontrol eder ve yapılandırma hatası olmadığından emin olur
  • Takım İşbirliği: Paylaşılan .env.example dosyalarını doğrular ve ekip üyeleri arasında tutarlılığı sağlar
  • Göç Projeleri: Farklı dağıtım platformları arasında geçiş yaparken ortam değişkeni dosyalarını doğrular
  • Yapılandırma Denetimleri: Birden fazla hizmetin ortam yapılandırmalarını gözden geçirir ve doğrular
  • CI/CD Entegrasyonu: Otomatik derleme süreçlerinin bir parçası olarak ortam dosyalarını doğrular
  • Öğrenme ve Öğretme: Geliştiricilerin doğru .env dosya formatını ve sözdizimi kurallarını öğrenmelerine yardımcı olur
  • Sorun Giderme: Uygulama yapılandırma problemlerine yol açan sözdizimi sorunlarını hızlıca tespit eder

Doğrulama Kuralları

  • Değişken adları bir harf (A-Z) veya alt çizgi (_) ile başlamalıdır
  • Değişken adları yalnızca büyük harf, rakam ve alt çizgi içerebilir
  • Her değişken KEY=value biçimini izlemelidir
  • Aynı değişken adları tekrarlanamaz
  • Yorumlar ( # ile başlayan satırlar) ve boş satırlar yok sayılır
  • Her değişken ataması kendi satırında olmalıdır