.env ⇄ JSON — Конвертер

Что делает .env ⇄ JSON

.env ⇄ JSON преобразует данные между форматом «ключ-значение» dotenv и плоским объектом JSON. Направление .env в JSON разбирает каждую строку как свойство, пропуская пустые строки и комментарии, начинающиеся с #, обрезая лишние пробелы и убирая необязательный префикс export. Значения в одинарных или двойных кавычках освобождаются от кавычек, а внутри двойных кавычек раскрываются распространённые экранированные последовательности, такие как \n и \t, поэтому многострочные секреты и форматированные значения корректно проходят преобразование туда и обратно. Направление JSON в .env обходит объект JSON и записывает одну строку KEY=value на каждое свойство, заключая в кавычки любое значение, содержащее пробелы, переносы строк или символы, которые парсер dotenv мог бы истолковать неоднозначно.

Это удобно, когда нужно перенести конфигурацию между инструментами, ожидающими разные форматы: импортировать окружение коллеги в интерфейс настроек, сгенерировать начальный .env из блока конфигурации JSON, сравнить переменные между окружениями или подготовить пример файла для документации. Конвертер следует широко распространённым соглашениям dotenv, а не расширенному синтаксису отдельной библиотеки, поэтому результат остаётся предсказуемым и простым для проверки.

Приватный рабочий процесс в браузере

Весь разбор и сериализация выполняются в вашем браузере с помощью клиентского JavaScript. Инструмент не загружает на сервер ваш файл окружения, JSON, имена хостов, токены или учётные данные и не требует аккаунта. Такая исключительно локальная работа особенно важна, ведь файлы .env обычно содержат пароли баз данных, ключи API и секреты подписи. Преобразование на вашем устройстве означает, что эти значения никогда не покидают страницу, а между вставкой и результатом нет никакого сетевого обмена.

Интерфейс показывает исходные данные и результат рядом, чтобы вы могли проверить преобразование перед копированием. Даже при локальной обработке удаляйте настоящие секреты, прежде чем делиться результатом в задаче, чате или документации, и никогда не добавляйте заполненный файл .env в систему контроля версий.

Практические советы

При преобразовании JSON в .env оставляйте значения строками, если принимающее приложение ожидает строки, ведь dotenv воспринимает каждое значение как текст. Булевы значения, числа и вложенные объекты превращаются в строки, а вложенные объекты записываются как JSON, чтобы пережить преобразование туда и обратно; сначала «разверните» их в плоскую структуру, если ваш загрузчик не умеет читать значения JSON. При преобразовании .env в JSON для дублирующихся ключей берётся последнее присвоенное значение, как в большинстве загрузчиков dotenv. Всегда проверяйте итоговую конфигурацию во фреймворке, который будет её читать, так как тонкие правила кавычек и интерполяции различаются между реализациями dotenv.