Какво е .env файл?

A .env файл (dotenv) е обикновен текстов конфигурационен файл, използван за съхранение на променливи на околната среда за приложения. Той съдържа двойки ключ-стойност, които определят настройки като URL адреси на база данни, API ключове, номера на портове и други конфигурационни стойности, които трябва да останат отделени от вашия код. Форматът произхожда от методологията Twelve-Factor App, която препоръчва съхранение на конфигурацията в променливи на околната среда, за да се запазят чувствителни данни извън изходния код и да се направят приложенията лесно преносими между различни среди (разработка, staging, производство).

Защо да валидирам .env файлове?

Файловете с променливи на околната среда следват строги правила за синтаксис: имената на променливите трябва да използват главни букви, цифри и подчертавки (започвайки с буква или подчертавка), и всяко присвояване трябва да следва формата KEY=value. Невалиден синтаксис, дублирани променливи или грешки във форматирането могат да причинят приложенията да се провалят мълчаливо или да се държат непредсказуемо. Валидирането на .env файлове преди разгръщане помага да се хванат тези проблеми рано, предотвратява грешки по време на изпълнение и гарантира, че вашата конфигурация е правилно форматирана.

Описание на инструмента

Dotenv Validator е специализиран инструмент за проверка на синтаксиса и структурата на .env файлове. Той валидира, че вашият файл с променливи на околната среда следва правилния формат, идентифицира грешки в синтаксиса с конкретни номера на редове, открива дублирани декларации на променливи и предоставя статистика за вашия конфигурационен файл. Валидаторът помага на разработчиците да гарантират, че техните .env файлове са правилно форматирани преди да ги използват в приложения.

Функции

  • Валидация на синтаксиса: Проверява, че всички декларации на променливи следват формата KEY=value
  • Проверка на имена на променливи: Гарантира, че имената на променливи използват само главни букви, цифри и подчертавки
  • Открояване на дубликати: Идентифицира дублирани имена на променливи и показва тяхното местоположение

Правила за валидация

Валидаторът налага тези стандарти за .env файлове:

  • Имената на променливите трябва да започват с буква (A-Z) или подчертавка (_)
  • Имената на променливи могат да съдържат само главни букви, цифри и подчертавки
  • Всяка променлива трябва да следва формата KEY=value
  • Не са разрешени дублирани имена на променливи
  • Коментарите (редове, които започват с #) и празни редове се игнорират
  • Всяко присвояване на променлива трябва да бъде на собствен ред