Validador de archivos .env

Pequeños errores en un .env, grandes problemas en producción

Un archivo .env guarda la configuración, como direcciones de bases de datos, claves e interruptores de funciones, en sencillas líneas NOMBRE=valor que una aplicación lee al arrancar. El formato parece trivial, pero no hay un estándar oficial y cada herramienta lo lee un poco distinto. Un nombre repetido, una comilla que falta o un espacio donde no debe pueden darte un valor erróneo sin avisar, y el resultado es un fallo que solo aparece en el servidor. Revisar el archivo lleva segundos.

Qué se comprueba

• Líneas que no son NOMBRE=valor, que la mayoría de lectores se saltan sin decir nada.
• Nombres no válidos. Los nombres deben usar letras, cifras y guiones bajos, y no empezar con una cifra.
• Nombres duplicados. Si una variable se define dos veces, uno de los valores se ignora, normalmente el primero.
• Comillas. Una comilla que no se cierra se traga las líneas siguientes, y el texto después de la comilla de cierre es un error.
• Espacios. Los espacios alrededor del signo igual o los valores sin comillas con espacios los leen distinto las diferentes herramientas.
• Valores vacíos, nombres en minúsculas y el prefijo export. Se indican como avisos, porque no siempre son errores.
• Caracteres invisibles como un BOM al principio, que puede estropear el nombre de la primera variable.

Secretos y .env.example

Un archivo .env suele guardar secretos y no debe subirse al control de versiones. La herramienta enumera las variables que parecen sensibles por su nombre, como las que llevan PASSWORD, SECRET, TOKEN o KEY. Su truco más útil es la opción .env.example, que convierte tu archivo en una lista de nombres con valores vacíos, segura para subir y que los demás sepan qué variables necesita el proyecto. También puedes obtener una copia con los valores sustituidos por asteriscos para compartirla al pedir soporte.

Límites

La revisión sigue las convenciones más extendidas de las bibliotecas tipo dotenv. Algunas herramientas tienen funciones extra, como la expansión de variables con ${OTRA}, que aquí no se comprueban. Como un archivo .env guarda secretos, nada de lo que pegas se envía a ningún sitio: se revisa en tu navegador y desaparece al cerrar la página.