Cos'è un file .env?

Un file .env (dotenv) è un file di configurazione in testo semplice utilizzato per memorizzare variabili d'ambiente per le applicazioni. Contiene coppie chiave-valore che definiscono impostazioni come URL di database, chiavi API, numeri di porta e altri valori di configurazione che dovrebbero rimanere separati dal codice. Il formato deriva dalla metodologia Twelve-Factor App, che raccomanda di memorizzare la configurazione in variabili d'ambiente per mantenere i dati sensibili fuori dal codice sorgente e rendere le applicazioni facilmente portabili tra diversi ambienti (sviluppo, staging, produzione).

Perché validare i file .env?

I file delle variabili d'ambiente seguono regole di sintassi rigorose: i nomi delle variabili devono utilizzare lettere maiuscole, numeri e trattini bassi (iniziando con una lettera o un trattino basso), e ogni assegnazione deve seguire il formato KEY=value. Una sintassi non valida, variabili duplicate o errori di formattazione possono causare il fallimento silenzioso delle applicazioni o comportamenti imprevedibili. La validazione dei file .env prima della distribuzione aiuta a individuare questi problemi in anticipo, previene errori di runtime e garantisce che la configurazione sia formattata correttamente.

Descrizione dello strumento

Il Validatore Dotenv è uno strumento specializzato per verificare la sintassi e la struttura dei file .env. Valida che il file delle variabili d'ambiente segua il formato corretto, identifica errori di sintassi con numeri di riga specifici, rileva dichiarazioni di variabili duplicate e fornisce statistiche sul file di configurazione. Il validatore aiuta gli sviluppatori a garantire che i loro file .env siano formattati correttamente prima di utilizzarli nelle applicazioni.

Funzionalità

  • Validazione della sintassi: Verifica che tutte le dichiarazioni di variabili seguano il formato KEY=value
  • Controllo dei nomi delle variabili: Garantisce che i nomi delle variabili utilizzino solo lettere maiuscole, numeri e trattini bassi
  • Rilevamento dei duplicati: Identifica i nomi delle variabili duplicate e mostra la loro posizione

Regole di validazione

Il validatore applica questi standard per i file .env:

  • I nomi delle variabili devono iniziare con una lettera (A-Z) o un trattino basso (_)
  • I nomi delle variabili possono contenere solo lettere maiuscole, numeri e trattini bassi
  • Ogni variabile deve seguire il formato KEY=value
  • Non sono ammessi nomi di variabili duplicati
  • I commenti (righe che iniziano con #) e le righe vuote vengono ignorati
  • Ogni assegnazione di variabile dovrebbe trovarsi su una propria riga