INI-parser

Deze parser ondersteunt secties, key=value-paren, opmerkingen (met ; of #), aangehaalde tekenreekswaarden en meerregelige waarden. Hij verwerkt ook detectie van booleaanse en numerieke typen.

Deze parser verwerkt het standaard INI-formaat. Sommige PHP-specifieke uitbreidingen zoals constante-substitutie en speciale operators worden mogelijk niet ondersteund.

Wanneer dubbele sleutels in dezelfde sectie worden gevonden, heeft de laatste waarde voorrang. Dit volgt het standaard INI-parsingsgedrag.

Klassieke verblijfplaatsen: php.ini (de volledige configuratie van de PHP-engine), .gitconfig, de win.ini-erfenis op Windows, .desktop-items op Linux, en vele games en desktopapps. De wortels van het formaat gaan terug tot de jaren 1960-70, vandaar dat de syntax overal iets verschilt - secties, key=value en puntkomma-opmerkingen vormen de stabiele kern.

Nee - alles is een tekenreeks; typen zijn een conventie aan de kant van de gebruiker. PHP's parse_ini_file() cast true/on/yes/1 en false/off/no/0 naar booleans (gedocumenteerd gedrag), converteert getalachtige waarden naar integers en floats, en houdt de rest als tekenreeksen. Een waarde aanhalen ('1') behoudt deze als tekenreeks in PHP. Deze parser toont de ruwe waarden zoals ze geschreven zijn.

[section] start een sectie die alle volgende sleutels omvat tot de volgende header - de [PHP]- en [mail function]-blokken van php.ini werken zo. Nesting wordt geveinsd met gesleutelde puntnotatie (database.host = localhost) of sectienamen zoals [database.pool], aangezien het formaat zelf maar één niveau heeft. Diep geneste data is een teken dat u INI ontgroeit bent en TOML of YAML wilt.

Het basisformaat definieert vrijwel geen escapes - waarden worden letterlijk genomen tot het regeleinde. In de praktijk: dubbele aanhalingstekens groeperen waarden met spaties en zijn de enige draagbare manier om voorloop- of naloop-witruimte te behouden; ${VAR}-interpolatie bestaat in sommige implementaties (systemd bijvoorbeeld) maar niet in andere; en of ; en # midden in een regel een opmerking starten, hangt af van de parser die het verbruikt.

.env is het platte subset van INI: KEY=value-regels, geen secties, verbruikt door dotenv-bibliotheken in een dozijn talen volgens de 12-Factor App-configuratiemethodologie. INI-bestanden leunen op secties en worden gelezen door specifieke toepassingen in plaats van een generieke conventie. Waarden in .env zijn bijna altijd tekenreeksen die in omgevingsvariabelen worden geïnjecteerd, terwijl INI-verbruikers vaak hun eigen typeregels toepassen.