.env-zu-JSON-Konverter

So arbeitet es

• Ein # ohne Anführungszeichen beginnt einen Kommentar, selbst mitten in einem Wert – das ist die Regel von dotenv und eine häufige Ursache für abgeschnittene URLs.
• Werte in einfachen Anführungszeichen und Backticks werden wörtlich genommen; nur doppelte Anführungszeichen machen aus \n einen echten Zeilenumbruch.
• export KEY=value und KEY: value werden beide akzeptiert, und ein doppelt definierter Schlüssel behält seinen letzten Wert – die Statistik listet auf, welche Schlüssel sich wiederholen.
• Nicht leere Zeilen, die weder Kommentare noch Variablen sind, werden mit Zeilennummer aufgeführt, damit ein Tippfehler nicht stillschweigend verschwindet.
• Docker-Flags werden für die Shell gequotet, und die Compose-Ausgabe setzt jeden Wert in Anführungszeichen, den YAML sonst als etwas anderes lesen würde; so bleiben true, null oder 5432 Strings, statt zu einem Boolean, einem null oder einer Zahl zu werden.

Häufige Fragen

Warum wurde meine URL beim # abgeschnitten?

dotenv behandelt # überall in einem Wert ohne Anführungszeichen als Beginn eines Kommentars, also endet URL=https://example.com/#section beim Schrägstrich. Setzen Sie den Wert in Anführungszeichen – URL="https://example.com/#section" –, dann bleibt das # erhalten.

Wie speichere ich einen mehrzeiligen Wert, etwa einen privaten Schlüssel?

Entweder mit doppelten Anführungszeichen und \n-Escapes in einer Zeile oder mit doppelten Anführungszeichen über mehrere echte Zeilen; dotenv liest beides. Die Richtung JSON zu .env schreibt die einzeilige Form mit Escapes, denn sie übersteht das Einfügen in die Secret-Einstellungen einer CI; nur ein Wert, der sowohl einen Zeilenumbruch als auch ein doppeltes Anführungszeichen enthält, wird in Backticks über mehrere Zeilen geschrieben, weil dotenv ihn sonst nicht zurücklesen kann.

Werden ${VARIABLE}-Referenzen aufgelöst?

Nein, und dotenv selbst tut das auch nicht. Die Auflösung ist Aufgabe des separaten Pakets dotenv-expand, und Docker Compose wendet eigene Interpolationsregeln an. Die hier gezeigten Werte sind genau das, was parse von dotenv zurückgibt, Referenzen eingeschlossen als wörtlicher Text.

Ist es klug, hier Produktions-Secrets einzufügen?

Nichts verlässt die Seite – beim Konvertieren wird keine Anfrage gesendet –, aber eine .env voller Produktionszugangsdaten sollte man überall so wenig wie möglich anfassen. Die Werte vorher durch Platzhalter zu ersetzen ist eine gute Gewohnheit; die Struktur wird genauso konvertiert.

Auch bekannt als

• .env zu JSON
• env Datei in JSON umwandeln
• JSON zu .env
• dotenv Parser online
• env Datei zu Docker env
• env zu Docker Compose