PHP parse_ini_file() functie

PHP Filesystem Functies

Definitie en gebruik

De parse_ini_file() functie ontledt een configuratiebestand en retourneert de instellingen ervan in de vorm van een array.

Syntax

parse_ini_file(file,process_sections)
Parameters Beschrijving
file Verplicht. Bepaalt het te controleren ini-bestand.
process_sections Optioneel. Als ingesteld op true, wordt een meerdimensionale array geretourneerd die de namen en instellingen van elke sectie in het configuratiebestand bevat. Standaard is dit false.

Verklaring

De structuur van het ini-bestand lijkt op die van php.ini.

Constanten kunnen ook in het ini-bestand worden geïnterpreteerd, dus als er voordat parse_ini_file() wordt uitgevoerd constanten zijn gedefinieerd als waarden van ini, worden deze geïntegreerd in het resultaat. Alleen de waarden van ini worden geëvalueerd.

Sleutelnamen en sectietitels die bestaan uit cijfers worden door PHP behandeld als integers, dus cijfers die beginnen met 0 worden behandeld als octaal en die beginnen met 0x als hexadecimaal.

Meldingen en annotaties

Opmerking:Deze functie kan worden gebruikt om de configuratiebestand van uw eigen applicatie te lezen. Deze functie heeft niets te maken met het php.ini-bestand, dat al is verwerkt bij het uitvoeren van het script.

Opmerking:Als de waarde in het ini-bestand enige niet-alfanumerieke tekens bevat, moeten deze worden geplaatst tussen aanhalingstekens (").

Opmerking:Sommige reservedwoorden mogen niet als sleutelnamen in ini-bestanden worden gebruikt, waaronder: null, yes, no, true en false. Waarden zoals null, no en false zijn equivalent aan "", terwijl waarden zoals yes en true equivalent zijn aan "1". Karakters {}|"~![()" mogen ook niet op elke plek in de sleutelnaam worden gebruikt en hebben speciale betekenis in optie-waarden.

Opmerking:Vanaf PHP 5.0 versie begint deze functie ook nieuwe regels te verwerken binnen optie-waarden.

Voorbeeld

Voorbeeld 1

Inhoud van "test.ini":

[names]
me = Robert
you = Peter
[urls]
first = "http://www.example.com"
second = "http://www.codew3c.com"

PHP code:

<?php
print_r(parse_ini_file("test.ini"));
?>

Uitvoer:

Array
(
[me] => Robert
[you] => Peter
[first] => http://www.example.com
[second] => http://www.codew3c.com
)

Voorbeeld 2

Inhoud van "test.ini":

[names]
me = Robert
you = Peter
[urls]
first = "http://www.example.com"
second = "http://www.codew3c.com"

PHP code (process_sections Gesetmd als true):

<?php
print_r(parse_ini_file("test.ini",true));
?>

Uitvoer:

Array
(
[names] => Array
  (
  [me] => Robert
  [you] => Peter
  )
[urls] => Array
  (
  [first] => http://www.example.com
  [second] => http://www.codew3c.com
  )
)

PHP Filesystem Functies