Forum und email

parse_ini_file

(PHP 4, PHP 5)

parse_ini_file — Verwerkt een configuratie bestand

Beschrijving

array parse_ini_file ( string $filename [, bool $process_sections ] )

parse_ini_file() laadt filename in en geeft de instellingen terug in een associatieve array. Door de laatste process_sections parameter op TRUE te zetten krijg je een multi dimensionale array, met de sectienamen en instellingen erin. Standaard is process_sections FALSE.

Note: Deze functie heeft niets met php.ini te maken. Die is al verwerkt als je je script runt. Deze functie kan gebruikt worden om je eigen configuratie files in te lezen.

Note: Als een waarde in het ini bestand enige niet-alphanumerieke tekens bevat, moet hij omsloten worden door apostrophes (").

Note: Vanaf PHP 4.2.1 wordt ook deze functie beïnvloed door safe mode en open_basedir.

Note: Er zijn gereserveerde woorden die niet gebruikt moeten worden als keys in ini files. Onder deze vallen: null, yes, no, true en false.

De structuur van het ini bestand is gelijk aan die van php.ini.

Constante kunnen ook verwerkt worden in het ini-bestand, dus als je een constante defineert voordat je parse_ini_file() runt, wordt hij verwerkt in het restultaat. Alleen ini-waardes worden verwerkt. Bijvoorbeeld:

Example#1 Inhoud van sample.ini

; Dit is een voorbeeld configuratie bestand
; Commentaar begint met ';', net zoals in php.ini

[first_section]
one = 1
five = 5
animal = BIRD

[second_section]
path = /usr/local/bin
URL = "https://www.example.com/~username"

Example#2 parse_ini_file() voorbeeld

<?php
define ('BIRD', 'Dodo bird');

// Verwerken zonder secties
$ini_array = parse_ini_file("sample.ini");
print_r($ini_array);

// Verwerken met secties
$ini_array = parse_ini_file("sample.ini", TRUE);
print_r($ini_array);

?>

Zal produceren:

Array
(
    [one] => 1
    [five] => 5
    [animal] => Dodo bird
    [path] => /usr/local/bin
    [URL] => https://www.example.com/~username
)
Array
(
    [first_section] => Array
        (
            [one] => 1
            [five] => 5
            [animal] = Dodo bird
        )

    [second_section] => Array
        (
            [path] => /usr/local/bin
            [URL] => https://www.example.com/~username
        )

)