Parser INI

Parser ini mendukung section, pasangan key=value, komentar (dengan ; atau #), nilai string berkutip, dan nilai multibaris. Parser juga menangani deteksi tipe boolean dan numerik.

Parser ini menangani format INI standar. Beberapa ekstensi khusus PHP seperti substitusi konstanta dan operator khusus mungkin tidak didukung.

Saat kunci duplikat ditemukan dalam section yang sama, nilai terakhir yang diutamakan. Ini mengikuti perilaku parsing INI standar.

Rumah klasiknya: php.ini (seluruh konfigurasi engine PHP), .gitconfig, warisan win.ini di Windows, entri .desktop di Linux, serta banyak game dan aplikasi desktop. Akar format ini berasal dari tahun 1960-70an, itulah mengapa sintaksnya sedikit berbeda di mana-mana - section, key=value, dan komentar titik koma adalah inti yang stabil.

Tidak - semuanya string; tipe hanyalah konvensi sisi konsumen. parse_ini_file() milik PHP mengubah true/on/yes/1 dan false/off/no/0 menjadi boolean (perilaku terdokumentasi), mengonversi nilai yang terlihat seperti angka menjadi integer dan float, dan menyisanya sebagai string. Memberi tanda kutip pada nilai ('1') mempertahankannya sebagai string di PHP. Parser ini menunjukkan nilai mentah apa adanya.

[section] memulai section yang mencakup semua kunci berikutnya hingga header berikutnya - blok [PHP] dan [mail function] pada php.ini bekerja dengan cara ini. Nesting dipalsukan dengan kunci bertitik (database.host = localhost) atau nama section seperti [database.pool], karena formatnya sendiri hanya memiliki satu tingkat. Data yang bersarang dalam adalah tanda Anda telah melampaui INI dan membutuhkan TOML atau YAML.

Format dasarnya hampir tidak mendefinisikan escape - nilai diambil secara harfiah hingga akhir baris. Dalam praktiknya: kutip ganda mengelompokkan nilai yang mengandung spasi dan merupakan satu-satunya cara portabel untuk mempertahankan spasi di awal atau akhir; interpolasi ${VAR} ada di beberapa implementasi (systemd, misalnya) tapi tidak di yang lain; dan apakah ; dan # memulai komentar di tengah baris tergantung pada parser penggunanya.

.env adalah subset datar dari INI: baris KEY=value, tanpa section, dikonsumsi oleh pustaka dotenv dalam belasan bahasa yang mengikuti metodologi konfigurasi 12-Factor App. File INI mengandalkan section dan dibaca oleh aplikasi tertentu, bukan konvensi generik. Nilai dalam .env hampir selalu string yang disuntikkan ke environment variable, sementara konsumen INI sering menerapkan aturan pengetikan mereka sendiri.