¿Qué es un archivo .env?

Un archivo .env (dotenv) es un archivo de configuración en texto plano utilizado para almacenar variables de entorno para aplicaciones. Contiene pares clave-valor que definen configuraciones como URLs de bases de datos, claves API, números de puerto y otros valores de configuración que deben permanecer separados de tu código. El formato se originó en la metodología Twelve-Factor App, que recomienda almacenar la configuración en variables de entorno para mantener los datos sensibles fuera del código fuente y hacer que las aplicaciones sean fácilmente portables entre diferentes entornos (desarrollo, staging, producción).

¿Por qué validar archivos .env?

Los archivos de variables de entorno siguen reglas de sintaxis estrictas: los nombres de variables deben usar letras mayúsculas, números y guiones bajos (comenzando con una letra o guion bajo), y cada asignación debe seguir el formato KEY=value. Una sintaxis inválida, variables duplicadas o errores de formato pueden causar que las aplicaciones fallen silenciosamente o se comporten de manera impredecible. Validar archivos .env antes del despliegue ayuda a detectar estos problemas temprano, previene errores de ejecución y garantiza que tu configuración esté correctamente formateada.

Descripción de la herramienta

El Validador Dotenv es una herramienta especializada para verificar la sintaxis y estructura de archivos .env. Valida que tu archivo de variables de entorno siga el formato correcto, identifica errores de sintaxis con números de línea específicos, detecta declaraciones de variables duplicadas y proporciona estadísticas sobre tu archivo de configuración. El validador ayuda a los desarrolladores a asegurar que sus archivos .env estén correctamente formateados antes de usarlos en aplicaciones.

Características

  • Validación de sintaxis: Verifica que todas las declaraciones de variables sigan el formato KEY=value
  • Verificación de nombres de variables: Garantiza que los nombres de variables usen solo letras mayúsculas, números y guiones bajos
  • Detección de duplicados: Identifica nombres de variables duplicados y muestra su ubicación

Reglas de validación

El validador aplica estos estándares de archivos .env:

  • Los nombres de variables deben comenzar con una letra (A-Z) o guion bajo (_)
  • Los nombres de variables solo pueden contener letras mayúsculas, números y guiones bajos
  • Cada variable debe seguir el formato KEY=value
  • No se permiten nombres de variables duplicados
  • Los comentarios (líneas que comienzan con #) y líneas vacías son ignoradas
  • Cada asignación de variable debe estar en su propia línea