.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.