.env ⇄ JSON — Konverter

Was .env ⇄ JSON macht

.env ⇄ JSON wandelt zwischen dem dotenv-Schlüssel-Wert-Format und einem flachen JSON-Objekt um. Die Richtung .env zu JSON liest jede Zeile als Eigenschaft ein, ignoriert Leerzeilen und Kommentare, die mit # beginnen, entfernt umgebende Leerzeichen und streift ein optionales export-Präfix ab. Werte in einfachen oder doppelten Anführungszeichen werden entpackt, und innerhalb doppelter Anführungszeichen werden gängige Escape-Sequenzen wie \n und \t aufgelöst, sodass mehrzeilige Geheimnisse und formatierte Werte die Hin-und-zurück-Konvertierung unbeschadet überstehen. Die Richtung JSON zu .env durchläuft ein JSON-Objekt und schreibt pro Eigenschaft eine Zeile KEY=value; Werte mit Leerzeichen, Zeilenumbrüchen oder für einen dotenv-Parser mehrdeutigen Zeichen werden in Anführungszeichen gesetzt.

Das ist praktisch, wenn Konfigurationen zwischen Tools mit unterschiedlichen Formaten verschoben werden: die Umgebung eines Kollegen in eine Einstellungsoberfläche importieren, aus einem JSON-Konfigurationsblock eine erste .env erzeugen, Variablen zwischen Umgebungen vergleichen oder eine Beispieldatei für die Dokumentation vorbereiten. Der Konverter orientiert sich an den weit verbreiteten dotenv-Konventionen und nicht an der erweiterten Syntax einer einzelnen Bibliothek, sodass die Ausgabe vorhersehbar und leicht zu prüfen bleibt.

Privater Workflow im Browser

Das gesamte Parsen und Serialisieren findet in Ihrem Browser mit clientseitigem JavaScript statt. Das Tool lädt Ihre Umgebungsdatei, Ihr JSON, Hostnamen, Tokens oder Zugangsdaten nicht auf einen Server hoch und erfordert kein Konto. Dieses rein lokale Verhalten ist hier besonders wichtig, denn .env-Dateien enthalten häufig Datenbankpasswörter, API-Schlüssel und Signaturgeheimnisse. Wird die Konvertierung auf Ihrem Rechner ausgeführt, verlassen diese Werte die Seite nie, und es gibt keinen Netzwerkweg zwischen Einfügen und Ergebnis.

Die Oberfläche zeigt Quelle und Ergebnis nebeneinander, damit Sie die Konvertierung vor dem Kopieren prüfen können. Auch wenn alles lokal abläuft: Entfernen Sie echte Geheimnisse, bevor Sie Ergebnisse in einem Issue, Chat oder in der Dokumentation teilen, und committen Sie niemals eine ausgefüllte .env-Datei in die Versionsverwaltung.

Praktische Tipps

Belassen Sie Werte bei der Konvertierung von JSON zu .env als Strings, wenn die empfangende Anwendung Strings erwartet, denn dotenv behandelt jeden Wert als Text. Boolesche Werte, Zahlen und verschachtelte Objekte werden in Strings umgewandelt, verschachtelte Objekte als JSON geschrieben, damit sie die Hin-und-zurück-Konvertierung überstehen; flachen Sie sie vorher ab, falls Ihr Loader keine JSON-Werte parsen kann. Bei der Konvertierung von .env zu JSON gilt bei doppelten Schlüsseln die letzte Zuweisung, wie bei den meisten dotenv-Loadern. Prüfen Sie die endgültige Konfiguration immer mit dem Framework, das sie einliest, denn feine Regeln für Anführungszeichen und Interpolation unterscheiden sich zwischen dotenv-Implementierungen.