ForHosting KIT · Entwickler-Tools

Dotenv-Dateiinhalt in Schlüssel-Wert-Paare parsen

Fügen Sie eine .env-Datei ein und erhalten Sie ihre Einstellungen als saubere Schlüssel-Wert-Paare: Im Beispiel kommen 7 Schlüssel heraus, PORT behält den späteren Wert 9090 und COLOR bleibt #336699, weil eine Raute erst nach einem Leerzeichen einen Kommentar beginnt. Kostenlos in Ihrem Browser.

  • Kostenlos
  • Läuft in Ihrem Browser
  • Ohne Anmeldung
  • Ihre Daten bleiben auf Ihrem Gerät
Nutzen Sie es über WebAPIE-MailTelegramApp bald

Dotenv-Dateien wirken einfach, bis Werte Leerzeichen, Kommentarzeichen, leere Zuweisungen oder Escape-Sequenzen enthalten. Dieser Parser wandelt den vollständigen Inhalt einer .env-Datei anhand klarer, vorhersehbarer Syntaxregeln in ein sauberes Objekt aus Schlüssel-Wert-Paaren um. Er ignoriert Leerzeilen und Kommentare, bewahrt Inhalte in Anführungszeichen, erkennt Kommentare hinter nicht zitierten Werten und meldet bei einer fehlerhaften Zuweisung die genaue Zeile. Das Ergebnis eignet sich für Konfigurationsvorschauen, Migrationen, Prüfungen und Entwicklungswerkzeuge, die strukturierte Daten benötigen, ohne Variablen in die Prozessumgebung zu laden.

Übergeben Sie den vollständigen dotenv-Text

Fügen Sie den Inhalt der .env-Datei in das Feld text ein oder senden Sie ihn darüber. Jede relevante Zeile muss einen Schlüssel, ein Gleichheitszeichen und einen Wert enthalten. Schlüssel beginnen mit einem ASCII-Buchstaben oder Unterstrich und dürfen danach Buchstaben, Ziffern oder Unterstriche enthalten.

Leerzeilen sind zulässig; eine Zeile, deren erstes Nicht-Leerzeichen eine Raute ist, gilt als Kommentar. Leere Zuweisungen wie CACHE_PREFIX= sind gültig und ergeben eine leere Zeichenfolge. Der Parser liefert ein values-Objekt mit den verarbeiteten Paaren sowie die Anzahl eindeutiger Schlüssel.

Kommt ein Schlüssel mehrfach vor, ersetzt die spätere Zuweisung die frühere. Dies entspricht dem üblichen Überschreibungsverhalten beim Zusammenführen von Konfigurationsfragmenten. Das Werkzeug schreibt nie in die Maschinenumgebung, erweitert keine Variablen, liest keine Dateien und kontaktiert keinen Dienst.

Es verarbeitet ausschließlich den übergebenen Text. Dadurch lässt sich sein Verhalten gefahrlos prüfen und in Build-Skripten, Editor-Erweiterungen, Konfigurationsprüfern oder Migrationen zuverlässig reproduzieren.

Verstehen Sie Anführungszeichen, Escapes und Kommentare

Bei Werten ohne Anführungszeichen werden äußere Leerzeichen entfernt. Eine Raute beginnt nur dann einen Inline-Kommentar, wenn unmittelbar davor ein Leerzeichen steht. URL-Fragmente und Tokens wie color=#fff bleiben deshalb unverändert.

Einfache Anführungszeichen bewahren den enthaltenen Text einschließlich Rauten und Leerzeichen wörtlich. Doppelte Anführungszeichen bewahren diese Zeichen ebenfalls, interpretieren jedoch bekannte Backslash-Escapes für Zeilenumbruch, Wagenrücklauf, Tabulator, doppeltes Anführungszeichen und Backslash. Nach dem schließenden Anführungszeichen sind nur Leerraum oder ein Kommentar zulässig.

Diese Regeln vermeiden Mehrdeutigkeit, ohne Shell-Ausdrücke auszuwerten. Der Parser ersetzt weder Verweise wie ${HOST} noch führt er Befehlsersetzungen aus oder wandelt Zeichenfolgen wie true und 8080 in boolesche Werte oder Zahlen um. Jeder Wert bleibt eine Zeichenfolge, da dotenv-Daten textuell sind und die jeweilige Anwendung über ihre Konvertierung entscheiden sollte.

Führende Nullen, Groß- und Kleinschreibung sowie absichtlich leere Werte bleiben so erhalten.

Behandeln Sie ungültige Eingaben ausdrücklich

Eine Zeile, die weder leer noch ein Kommentar ist und kein Gleichheitszeichen enthält, wird abgelehnt und nicht stillschweigend übersprungen. Gleiches gilt für einen ungültigen Schlüssel, einen nicht geschlossenen zitierten Wert oder unerwartete Zeichen nach dem schließenden Anführungszeichen. Fehlermeldungen enthalten die ab eins gezählte Zeilennummer, damit Sie oder ein automatisierter Editor die Ursache schnell finden können.

Dieses strenge Verhalten ist besonders vor einer Bereitstellung hilfreich: Wird nur ein Teil einer beschädigten Konfiguration akzeptiert, kann eine fehlende Einstellung verborgen bleiben, bis die Anwendung mit überraschenden Standardwerten startet.

Konfiguration vor der Bereitstellung prüfen

Lehnen Sie fehlerhaften dotenv-Inhalt früh ab und nennen Sie der verantwortlichen Person die genau zu korrigierende Zeile.

Eine Konfigurationsmigration vorbereiten

Wandeln Sie älteren .env-Text in ein strukturiertes Objekt um, bevor Sie seine Schlüssel einem anderen System zuordnen.

Ein Entwicklungswerkzeug erstellen

Nutzen Sie vorhersehbare Schlüssel-Wert-Ausgaben in Editor-Erweiterungen, Assistenten, Build-Werkzeugen oder Vergleichen.

Werden Werte in Zahlen oder boolesche Werte umgewandelt?

Nein. Alle Werte bleiben Zeichenfolgen, darunter 8080, true, false und leere Zuweisungen.

Wie werden doppelte Schlüssel behandelt?

Die letzte Zuweisung gewinnt; count nennt die Zahl eindeutiger Schlüssel im endgültigen Ergebnis.

Darf ein zitierter Wert eine Raute enthalten?

Ja. Rauten in einfachen oder doppelten Anführungszeichen gehören zum Wert und beginnen keinen Kommentar.

Erweitert der Parser Variablenverweise?

Nein. Verweise wie ${HOST} werden wörtlich zurückgegeben; Shell- oder Umgebungsersetzungen finden nicht statt.

Was passiert, wenn eine Zeile der Datei fehlerhaft ist?

Das Einlesen bricht ab, und die Meldung nennt die Zeilennummer, gezählt ab 1. Eine Zeile ohne Gleichheitszeichen, ein Schlüssel mit falschem Anfangszeichen oder ein nie geschlossenes Anführungszeichen wird abgelehnt und nie stillschweigend übersprungen.

Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.

POSThttps://api.kit.forhosting.com/dev2/env-file-parse

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

curl -X POST https://api.kit.forhosting.com/dev2/env-file-parse \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"APP_NAME=\"Example service\"\nDEBUG=true\nPORT=8080\n# Optional local override\nEMPTY="}'
{
  "text": "APP_NAME=\"Example service\"\nDEBUG=true\nPORT=8080\n# Optional local override\nEMPTY="
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "dev2.env_file_parse",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.

pro Anfrage$0.002

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

HTTPCodeBedeutung
401unauthorizedDer API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
402insufficient_balanceIhr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
404unknown_typeUnbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
429rate_limitedZu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Behandeln Sie ungültige Eingaben ausdrücklich

Verwenden Sie das Ergebnis nur nach einer erfolgreichen Anfrage und verstehen Sie invalid_input als Aufforderung, den Quelltext zu korrigieren. Das Parsen ist deterministisch; derselbe Inhalt erzeugt stets dasselbe Objekt und denselben Fehler. Eine API-Anfrage kostet $0.002.

Was kostet eine Anfrage?

Eine API-Anfrage kostet $0.002. Der Browser-Runner kann denselben Inhalt lokal parsen.

Vollständige KIT-Dokumentation lesen →