INI パーサー

セクション、key=value ペア、コメント（; または #）、引用符付き文字列値、複数行値に対応しています。ブール値と数値の型検出も行います。

このパーサーは標準 INI 形式を処理します。定数の置換や特殊演算子などの PHP 固有の拡張はサポートされない場合があります。

同じセクション内で重複キーが見つかった場合、最後の値が優先されます。これは標準的な INI パースの動作に従っています。

定番の利用先は php.ini（PHP エンジンの全設定）、.gitconfig、Windows の win.ini の系譜、Linux の .desktop エントリ、そして多くのゲームやデスクトップアプリです。この形式のルーツは 1960〜70 年代にまでさかのぼるため、構文は処理系によって微妙に異なります。セクション、key=value、セミコロンによるコメントが安定した中核となっています。

いいえ。すべては文字列であり、型は利用側の規約にすぎません。PHP の parse_ini_file() は true/on/yes/1 と false/off/no/0 を真偽値にキャストし（ドキュメント化された動作です）、数値に見える値は整数や浮動小数点数に変換し、それ以外は文字列のまま保持します。値を引用符で囲む（'1'）と、PHP では文字列として保持されます。このパーサーは、記述されたままの生の値を表示します。

[section] はセクションを開始し、次のヘッダーまでのすべての後続キーに適用されます。php.ini の [PHP] や [mail function] ブロックがこの方式です。形式自体は 1 階層しか持たないため、ネストはドット付きキー（database.host = localhost）や [database.pool] のようなセクション名で疑似的に表現します。深くネストされたデータは、INI の限界を超えて TOML や YAML を使うべきサインです。

基本の形式にはエスケープの定義がほとんどなく、値は行末までリテラルのまま解釈されます。実際には、二重引用符で空白を含む値をグループ化でき、これは先頭や末尾の空白を保持できる唯一の移植性のある方法です。${VAR} の補間は一部の実装（たとえば systemd）に存在しますが、他にはありません。また、; や # が行の途中からコメントを開始するかどうかは、読み込む側のパーサーに依存します。

.env は INI のフラットなサブセットです。KEY=value の行のみでセクションはなく、12-Factor App の設定方法論に従い、多数の言語の dotenv ライブラリによって読み込まれます。INI ファイルはセクションに依存し、一般的な規約ではなく特定のアプリケーションが読み取ります。.env の値はほぼ常に文字列として環境変数に注入されますが、INI の利用側はしばしば独自の型解釈ルールを適用します。