.env ⇄ JSON — Konwerter

Co robi .env ⇄ JSON

.env ⇄ JSON konwertuje między formatem klucz-wartość dotenv a płaskim obiektem JSON. Kierunek .env na JSON analizuje każdy wiersz jako właściwość, pomija puste wiersze i komentarze zaczynające się od #, przycina otaczające spacje i usuwa opcjonalny prefiks export. Wartości ujęte w pojedyncze lub podwójne cudzysłowy są „rozpakowywane”, a wewnątrz podwójnych cudzysłowów rozwijane są typowe sekwencje ucieczki, takie jak \n i \t, dzięki czemu wielowierszowe sekrety i sformatowane wartości przetrwają konwersję w obie strony. Kierunek JSON na .env przechodzi przez obiekt JSON i zapisuje jeden wiersz KEY=value na właściwość, ujmując w cudzysłowy każdą wartość zawierającą spacje, łamania wierszy lub znaki, które parser dotenv mógłby zinterpretować niejednoznacznie.

To przydatne przy przenoszeniu konfiguracji między narzędziami oczekującymi różnych formatów: importowaniu środowiska współpracownika do interfejsu ustawień, generowaniu startowego pliku .env z bloku konfiguracji JSON, porównywaniu zmiennych między środowiskami czy przygotowywaniu przykładowego pliku do dokumentacji. Konwerter opiera się na powszechnie stosowanych konwencjach dotenv, a nie na rozszerzonej składni jednej biblioteki, dzięki czemu wynik pozostaje przewidywalny i łatwy do sprawdzenia.

Prywatny przepływ pracy w przeglądarce

Cała analiza i serializacja odbywa się w Twojej przeglądarce za pomocą JavaScriptu po stronie klienta. Narzędzie nie wysyła na serwer Twojego pliku środowiskowego, JSON-a, nazw hostów, tokenów ani poświadczeń i nie wymaga konta. To wyłącznie lokalne działanie jest tu szczególnie ważne, ponieważ pliki .env zwykle zawierają hasła do baz danych, klucze API i sekrety podpisywania. Konwersja na Twoim urządzeniu oznacza, że te wartości nigdy nie opuszczają strony, a między wklejeniem a wynikiem nie ma żadnej komunikacji sieciowej.

Interfejs pokazuje źródło i wynik obok siebie, abyś mógł sprawdzić konwersję przed skopiowaniem. Mimo że praca odbywa się lokalnie, usuń prawdziwe sekrety, zanim udostępnisz wynik w zgłoszeniu, na czacie lub w dokumentacji, i nigdy nie zatwierdzaj wypełnionego pliku .env w systemie kontroli wersji.

Praktyczne wskazówki

Przy konwersji JSON na .env pozostaw wartości jako ciągi znaków, jeśli aplikacja docelowa oczekuje ciągów, ponieważ dotenv traktuje każdą wartość jako tekst. Wartości logiczne, liczby i obiekty zagnieżdżone są zamieniane na ciągi, a obiekty zagnieżdżone zapisywane jako JSON, aby przetrwały konwersję w obie strony; spłaszcz je wcześniej, jeśli Twój loader nie potrafi odczytać wartości JSON. Przy konwersji .env na JSON zduplikowane klucze przyjmują ostatnie przypisanie, tak jak w większości loaderów dotenv. Zawsze sprawdzaj końcową konfigurację we frameworku, który będzie ją wczytywał, ponieważ subtelne reguły cudzysłowów i interpolacji różnią się między implementacjami dotenv.