Von JSON zu Umgebungsvariablen: Einführung des JSON-zu-Env-Konverters

Hallo! Dies ist mein allererster Artikel (also seien Sie vorsichtig mit mir in den Kommentaren?). Ich freue mich, Ihnen ein kleines Projekt vorzustellen, an dem ich gearbeitet habe und das aus einem persönlichen Bedürfnis heraus entstanden ist. Wenn Sie sich jemals mit der Verwaltung von Konfigurationen in Ihrer Node.js-Anwendung herumgeschlagen haben, könnte dieses kleine Null-Abhängigkeits-Paket für Sie interessant sein. Es heißt JSON-zu-Env-Konverter.

Was ist ein JSON-zu-Env-Konverter?

json-to-env-converter ist ein npm-Paket, das JSON-Objekte in Umgebungsvariablen konvertiert. Es handelt sich um ein leichtgewichtiges Tool, das Ihnen bei der Handhabung JSON-basierter Konfigurationen helfen soll, indem es diese in Umgebungsvariablen umwandelt und in „process.env“ einfügt. Es ist für Szenarien gedacht, in denen Konfigurationen dynamisch oder verschachtelt sein oder von APIs oder externen Systemen stammen können.

Hier ist die Idee: Anstatt Umgebungsvariablen für komplexe oder dynamische Konfigurationen manuell festzulegen, können Sie sie programmgesteuert aus einem JSON-Objekt laden und wie jede andere Umgebungsvariable darauf zugreifen.

Warum habe ich es gebaut?

Ich habe kürzlich eine Secrets-API erstellt und zwar für jedes Projekt, an dem ich persönlich arbeite; Ich rufe meine Secrets-API auf, um meine Konfiguration zur Laufzeit abzurufen, die im JSON-Format bereitgestellt wird. Ganz zu schweigen davon, dass sich die Konfiguration in modernen und großen Apps je nach Standort des Benutzers oder anderen dynamischen Faktoren ändern kann. Während sich .env-Dateien hervorragend für statische Setups eignen, sind sie nicht einfach zu handhaben:

• Verschachtelte Strukturen: Das Reduzieren von verschachteltem JSON in Umgebungsvariablen kann mühsam sein.
• Dynamische Quellen: Das Laden von Konfigurationen zur Laufzeit ohne Neustart der App ist nicht einfach.

Ich habe den json-to-env-converter entwickelt, um einen Weg zu finden, diese Probleme anzugehen. Auch hier handelte es sich eher um ein Projekt für den persönlichen Gebrauch und es ist definitiv nicht dazu gedacht, Tools wie dotenv zu ersetzen, sondern vielmehr einen etwas anderen Anwendungsfall abzuwickeln ; und ich dachte, was wäre der Schaden daran, es als Open Source zu veröffentlichen und öffentlich auf npm zu veröffentlichen, und ich würde mich so freuen, wenn irgendjemand davon Gebrauch machen würde.

Wie es funktioniert

Installieren Sie das Paket von npm:

npm i json-to-env-converter

Hier ist ein einfaches Beispiel, um zu zeigen, was es bewirkt:

Grundlegendes Beispiel

import { jsonToEnv } from 'json-to-env-converter';

const config = {
  database: {
    host: 'localhost',
    port: 5432,
  },
};

jsonToEnv(config);

console.log(process.env.DATABASE_HOST); //Output: 'localhost'
console.log(process.env.DATABASE_PORT); //Output: '5432'

Dies nimmt ein JSON-Objekt und wandelt es in Umgebungsvariablen um. Außerdem werden verschachtelte Schlüssel abgeflacht, sodass „database.host“ zu „DATABASE_HOST.

“ wird

Hinzufügen eines Präfixes

Um Kollisionen zu vermeiden, können Sie ein Präfix hinzufügen:

jsonToEnv(config, { prefix: 'MYAPP_' });

console.log(process.env.MYAPP_DATABASE_HOST); //Output: 'localhost'

Ein Anwendungsfall: Dynamische Konfigurationen

Ein möglicher Anwendungsfall für dieses Paket ist die Handhabung dynamischer Konfigurationen. Stellen Sie sich beispielsweise vor, Sie verfügen über eine globale Anwendung, die zur Laufzeit regionsspezifische Einstellungen abruft. Anstatt die .env-Dateien für jede Region manuell zu verwalten, können Sie die richtigen Einstellungen basierend auf dem Standort des Benutzers dynamisch laden:

npm i json-to-env-converter

Dadurch kann Ihre App ihre Konfiguration anpassen, ohne dass ein Neustart oder fest codierte Werte erforderlich sind.

Sollten Sie es verwenden?

Ehrlich gesagt überlege ich immer noch, wie umfassend dieses Paket nützlich sein könnte. Wenn Sie bereits mit .env-Dateien und statischen Konfigurationen vertraut sind, benötigen Sie dieses Tool möglicherweise nicht. Aber wenn Sie arbeiten mit:

• Dynamische Umgebungen, in denen sich Konfigurationen zur Laufzeit ändern
• Verschachtelte JSON-Objekte, die in flache Umgebungsvariablen konvertiert werden müssen
• Programmatische Konfigurationseinstellungen, die von APIs oder externen Diensten stammen

und Sie mit Ihrem aktuellen Setup nicht zufrieden sind, kann Ihnen der JSON-zu-Env-Konverter möglicherweise etwas Zeit sparen und ist einen Versuch wert.

Installation und Feedback

Wenn Sie neugierig sind, es auszuprobieren, können Sie es über npm installieren:

import { jsonToEnv } from 'json-to-env-converter';

const config = {
  database: {
    host: 'localhost',
    port: 5432,
  },
};

jsonToEnv(config);

console.log(process.env.DATABASE_HOST); //Output: 'localhost'
console.log(process.env.DATABASE_PORT); //Output: '5432'

Ich würde gerne Ihre Gedanken, Rückmeldungen oder vor allem Verbesserungsvorschläge hören. Erwähnen Sie sie also gerne hier in den Kommentaren oder senden Sie Pull-Anfragen auf meinem Github-Repo https://github.com/neenus/json-to -env. Für mich ist das eine Lernerfahrung und ich bin gespannt, wohin es führt.

Oh und noch etwas... Danke, dass du meinen ersten Artikel gelesen hast!

Das obige ist der detaillierte Inhalt vonVon JSON zu Umgebungsvariablen: Einführung des JSON-zu-Env-Konverters. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!