conf

conf は、キー/値とセクションで構成された単純な .conf、.cfg、.env ファイルを読み書きします。書き込みはアトミックで、dump は正規化した設定を表示します。

データバージョン 1.1.6安定版
lil-terminal

概要

conf は単純な設定ファイルを構造化されたパスと値として扱います。設定を直接読み、検索・変更・削除し、対応構文を検証して、正規化した全文も確認できます。

形式専用エディタを使わない設定編集

database.host は database セクション内の host キーを表します。まず読み取りまたは検索し、必要なパスだけを -w で変更します。コメントや厳密な整形を残す必要がある場合は edit または code を使います。

構文

lil-terminal
conf <file> [key|options] · conf dump <file>

リファレンス

conf <file>

設定データを表示する

conf <file> <key>

ドット区切りの完全一致パスを表示する

conf dump <file>

正規化した conf ソースを表示する

-f <text|mask> [-k|-v]

キーまたは値を検索する。* と ? を含む場合はマスクとして扱う

-w <key> : <value>

値をファイルへ直接書き込む

-w <key> < <file>

別ファイルから読み取った値を書き込む

-d <key>

ドット区切りパスの値を削除する

-c

conf ファイルを検証する

使い方

conf <file> [key|-f|-w|-d|-c] | conf dump <file>

アクティブファイル

現在の core では、正常に開いたファイルをすぐに $ で再利用できます。このモジュールがその拡張子に対するインストール済みハンドラーのうち最優先なら、ファイル名だけを入力してこのコマンドで開けます。これらは core の補助機能であり、明示的な形式は conf <file> のままです。

検索

-f はパスと値を検索します。キーだけなら -k、値だけなら -v を追加します。* または ? を含む検索語はマスクとして扱います。

直接編集

-w は変更を直ちにファイルへ書き込みます。: の後ろに値を直接指定し、< <file> では別ファイルから値を読みます。-d は 1 つのドット区切りパスを削除します。

形式の範囲

このモジュールは共有ホスティングで一般的な設定形式の範囲を意図的に実装します。高度な形式機能は暗黙に解釈せず、edit または code でテキストとして編集してください。

Nginx、Apache やすべての .env 構文に対応する汎用パーサーではありません。重複するキーやセクションはエラーとなり、書き直すとコメントや元の配置は失われます。複雑なディレクティブは edit または code で編集してください。Minimum は全体表示のみ、詳細操作には Base が必要です。

インタラクティブな sandbox プレビュー

用意された例をページ上でそのまま実行できます。結果は事前に生成されてブラウザに表示され、サーバーではターミナルコマンドを実行しません。

ファイルを開いて $ で再利用する

インストールと管理

現在の互換バージョンをインストールします。全機能は Base、縮小版は Minimum を選び、すでに導入済みのモジュール更新には upgrade を使います。

Base と Minimum は同じ現在のモジュールリリースの二つのパッケージです。

Base パッケージ

ローカル参照と公開済みの全モードを含む完全パッケージをインストールします。

install conf
Minimum パッケージ

縮小パッケージをインストールします。ローカルリファレンスは含まれず、help <cmd> -i で現在のサーバーリファレンスを開きます。

install conf -m
正確な公開版

この公開済みバージョンを正確に指定してインストールします。

install conf -v 1.1.6
確認または更新

upgrade が互換性を確認し、必要な場合だけブロックを置換します。

upgrade conf
モジュールを削除

コアや他のモジュールに触れず拡張ブロックを削除します。

install conf -u

例

例はコピーできますが、サイトは実行しません。実プロジェクトではパス、権限、破壊的オプションを確認してください。

ファイルを開いて $ で再利用する
cd \sandbox\config | conf app.conf
application    shop
production     true
database.host  localhost
database.port  3306
設定データを表示する
cd \sandbox\config | app.conf
application    shop
production     true
database.host  localhost
database.port  3306
ドット区切りの完全一致パスを表示する
conf config/app.conf database.host
localhost
キーまたは値を検索する。* と ? を含む場合はマスクとして扱う
conf config/app.conf -f "database.*" -k
database.host  localhost
database.port  3306
キーまたは値を検索する。* と ? を含む場合はマスクとして扱う
conf config/app.conf -f "shop" -v
application  shop
キーまたは値を検索する。* と ? を含む場合はマスクとして扱う
conf config/app.conf -f "production"
production  true
値をファイルへ直接書き込む
conf config/app.conf -w database.port : 3307
database.port  3307
別ファイルから読み取った値を書き込む
conf config/app.conf -w application < config/plain-value.txt
application  demo-site
ドット区切りパスの値を削除する
conf config/app.conf -d database.port
application    shop
production     true
database.host  localhost
存在しないファイルを扱う
conf config/app.conf -c
Valid configuration
正規化した conf ソースを表示する
conf dump config/app.conf
application=shop
production=true

[database]
host=localhost
port=3306
ドット区切りの完全一致パスを表示する
conf config/app.conf missing.key
Path not found
別ファイルから読み取った値を書き込む
conf config/app.conf -w database.extra < config/value.json
Nested configuration sections are not supported
Conf ファイルを検証する
conf config/duplicate.conf -c
Duplicate configuration key
設定データを表示する
conf config/missing.conf
File not found
値をファイルへ直接書き込む
conf config/app.conf -w database.port
Value required after : or

この例で使うファイル: sandbox/config/app.conf

例では、保護されたドキュメント用 /sandbox/ ワークスペースのファイルまたはディレクトリを使います。

# common key/value configuration
application=shop
production=true

[database]
host=localhost
port=3306

関連ドキュメント

モジュールをインストールするには？ →「command not found」と表示されるのはなぜですか？ →

現在の公開版

v1.1.62026-11-01

プロダクション向け調整

conf の現在の安定版。conf は、キー/値とセクションで構成された単純な `.

# バージョン履歴