ini

ini は標準的な INI ファイルを直接扱います。セクションと型付き値の読み取り、検索、構文検証、1 つのキーのアトミックな変更が可能です。パスは key または section.key です。

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

概要

ini は INI ファイルを直接扱います。ドットパスでキーを読み、キーや値を検索し、1つの設定をアトミックに変更して検証し、セッションバッファーを使わず正規化したソースを確認できます。

セクションとキーで二階層を表す

application.name は [application] 内の name を選びます。a.b.c のような深いパスは意図的に拒否されます。より深い構造が必要なら JSON、TOML、YAML が適しています。

構文

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

リファレンス

ini <file>

INI データを表示する

ini <file> <key>

キーまたはセクションの値を完全一致で表示する

ini dump <file>

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

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

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

-w <key> : <value>

スカラー値または JSON 形式のリストをファイルへ直接書き込む

-w <key> < <file>

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

-d <key>

キーまたはセクションを削除する

-c

INI ファイルを検証する

使い方

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

アクティブファイル

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

検索

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

直接編集

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

-w は : の後の値、または < で指定した別ファイルの値を直ちに保存します。-d はキーやセクションを削除します。書き込み可能なパスは key と section.key のみで、a.b.c は不可です。再保存時にコメントや空白が失われる場合があり、重複キーは PHP の INI パーサーに従います。原文を保つなら edit または code を使ってください。Minimum は全体表示のみ、詳細操作は Base が必要です。

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

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

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

インストールと管理

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

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

Base パッケージ

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

install ini
Minimum パッケージ

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

install ini -m
正確な公開版

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

install ini -v 1.3.6
確認または更新

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

upgrade ini
モジュールを削除

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

install ini -u

例

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

ファイルを開いて $ で再利用する
cd \sandbox\config | ini app.ini
application.name   lil-sandbox
application.debug  true
paths.source       ../src
paths.public       ../public
INI データを表示する
cd \sandbox\config | app.ini
application.name   lil-sandbox
application.debug  true
paths.source       ../src
paths.public       ../public
キーまたはセクションの値を完全一致で表示する
ini config/app.ini application.name
lil-sandbox
キーまたは値を検索する。* と ? を含む場合はマスクとして扱う
ini config/app.ini -f "paths.*" -k
paths.source  ../src
paths.public  ../public
キーまたは値を検索する。* と ? を含む場合はマスクとして扱う
ini config/app.ini -f "../public" -v
paths.public  ../public
キーまたは値を検索する。* と ? を含む場合はマスクとして扱う
ini config/app.ini -f "debug"
application.debug  true
スカラー値または JSON 形式のリストをファイルへ直接書き込む
ini config/app.ini -w application.debug : false
application.debug  false
別ファイルから読み取った値を書き込む
ini config/app.ini -w application.name < config/plain-value.txt
application.name  demo-site
キーまたはセクションを削除する
ini config/app.ini -d paths.public
application.name   lil-sandbox
application.debug  true
paths.source       ../src
存在しないファイルを扱う
ini config/app.ini -c
Valid INI
正規化した INI ソースを表示する
ini dump config/app.ini
[application]
name = "lil-sandbox"
debug = true

[paths]
source = "../src"
public = "../public"
キーまたはセクションの値を完全一致で表示する
ini config/app.ini missing.key
Path not found
スカラー値または JSON 形式のリストをファイルへ直接書き込む
ini config/app.ini -w a.b.c : 1
INI paths support section.key only
INI ファイルを検証する
ini config/invalid.ini -c
Invalid INI
INI データを表示する
ini config/missing.ini
File not found
スカラー値または JSON 形式のリストをファイルへ直接書き込む
ini config/app.ini -w application.name
Value required after : or

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

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

[application]
name = "lil-sandbox"
debug = true

[paths]
source = "../src"
public = "../public"

関連ドキュメント

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

現在の公開版

v1.3.62026-11-01

プロダクション向け調整

ini の現在の安定版。ini は標準的な INI ファイルを直接扱います。

# バージョン履歴