JSONからENVへ
JSONまたはYAMLオブジェクトを、KEY=value形式の.env行に変換します。ネストされたキーは__などの区切り文字でつなぎます。そのため、{"db":{"host":"x"}}はDB__HOST=xになり、配列にはインデックスが使われます。値には必要な場合だけ引用符が付くため、dotenvなどのローダーで正しく読み込めます。
よくある質問
ネストされたオブジェクトはどのように変換されますか?
パス上のキーは、選択した区切り文字でつながれます。既定ではアンダースコア2つです。これはASP.NET Coreの設定や、環境変数からネストされた設定を読み込む多くのツールで使われる慣例です。
配列はどのように扱われますか?
各項目にはキーの一部としてインデックスが付くため、{"hosts":["a","b"]}はHOSTS__0=aおよびHOSTS__1=bになります。
値はどのような場合に引用符で囲まれますか?
英字、数字、単純な句読点だけで構成される値は、そのまま書き込まれます。スペース、引用符、#、$、バックスラッシュを含む値はシングルクォートで囲まれます。また、シングルクォートや改行を含む値は二重引用符で囲み、\nや\"でエスケープされます。
名前に使えない文字はどうなりますか?
英字、数字、アンダースコア、およびドット区切りを選んだ場合のドット以外の文字は、アンダースコアに置き換えられます。数字で始まる名前には、先頭にアンダースコアが追加されます。
大文字化オプションと接頭辞オプションは何をしますか?
大文字化すると、環境変数で一般的な形式に従って、DB__HOSTのような名前が書き込まれます。APP_などの接頭辞を指定すると、すべての名前の先頭に追加され、同じアプリケーションの変数をまとめやすくなります。
null値と真偽値はどのように書き込まれますか?
真偽値と数値はテキストとして書き込まれます。たとえば、trueや5432のようになります。null値はKEY=のように空の値になります。