O que é um arquivo .env?

Um arquivo .env (dotenv) é um arquivo de configuração em texto simples usado para armazenar variáveis de ambiente para aplicações. Ele contém pares chave-valor que definem configurações como URLs de banco de dados, chaves de API, números de porta e outros valores de configuração que devem permanecer separados do seu código. O formato originou-se da metodologia Twelve-Factor App, que recomenda armazenar configuração em variáveis de ambiente para manter dados sensíveis fora do código-fonte e tornar aplicações facilmente portáveis entre diferentes ambientes (desenvolvimento, staging, produção).

Por que validar arquivos .env?

Arquivos de variáveis de ambiente seguem regras de sintaxe rigorosas: nomes de variáveis devem usar letras maiúsculas, números e sublinhados (começando com uma letra ou sublinhado), e cada atribuição deve seguir o formato KEY=value. Sintaxe inválida, variáveis duplicadas ou erros de formatação podem causar falhas silenciosas nas aplicações ou comportamentos imprevisíveis. Validar arquivos .env antes da implantação ajuda a capturar esses problemas precocemente, previne erros de execução e garante que sua configuração esteja corretamente formatada.

Descrição da ferramenta

O Validador Dotenv é uma ferramenta especializada para verificar a sintaxe e estrutura de arquivos .env. Ele valida que seu arquivo de variáveis de ambiente segue o formato correto, identifica erros de sintaxe com números de linha específicos, detecta declarações de variáveis duplicadas e fornece estatísticas sobre seu arquivo de configuração. O validador ajuda desenvolvedores a garantir que seus arquivos .env estejam formatados corretamente antes de usá-los em aplicações.

Recursos

  • Validação de sintaxe: Verifica se todas as declarações de variáveis seguem o formato KEY=value
  • Verificação de nomes de variáveis: Garante que nomes de variáveis usem apenas letras maiúsculas, números e sublinhados
  • Detecção de duplicatas: Identifica nomes de variáveis duplicados e mostra sua localização

Regras de validação

O validador aplica estes padrões de arquivos .env:

  • Nomes de variáveis devem começar com uma letra (A-Z) ou sublinhado (_)
  • Nomes de variáveis podem conter apenas letras maiúsculas, números e sublinhados
  • Cada variável deve seguir o formato KEY=value
  • Nomes de variáveis duplicados não são permitidos
  • Comentários (linhas começando com #) e linhas vazias são ignorados
  • Cada atribuição de variável deve estar em sua própria linha