(PHP 4, PHP 5)
parse_ini_file — Analysiert eine Konfigurationsdatei
$filename
[, bool $process_sections
] )
parse_ini_file() lädt die in
filename
angegebene Datei, und gibt
die darin enthaltenen Einstellungen in einem assoziativen
Array zurück. Setzen Sie den letzten Parameter
process_sections
auf TRUE
, erhalten
Sie ein mehrdimensionales Array mit den Gruppennamen und
Einstellungen. Ist process_sections
nicht angegeben, wird FALSE
angenommen.
Hinweis:
Diese Funktion hat nichts mit der php.ini zu tun, denn diese ist bereits abgearbeitet, wenn Sie Ihr Skript ausführen. Diese Funktion ist vorgesehen, um Konfigurationsdateien für Ihre eigenen Applikationen einzulesen.
Hinweis:
Enthält ein Wert in der ini Datei nicht alphanumerische Zeichen, so muss dieser von doppelten Anführungszeichen (") eingeschlossen sein.
Hinweis: Seit PHP 4.2.1 wird diese Funktion auch von Safe Mode und open_basedir beeinflusst.
Die Struktur der ini Datei ist der von php.ini ähnlich.
Konstanten können in der ini Datei ebenfalls geparsed werden. Wenn Sie eine Konstante als einen ini Wert definieren bevor Sie parse_ini_file() aufrufen, wird diese in den Ergebnissen enthalten sein. Es werden nur ini Werte ausgewertet. Zum Beispiel:
Beispiel #1 Inhalt der sample.ini
; Dies ist ein Beispiel für eine Konfigurationsdatei ; Kommentare beginnen wie in der php.ini mit ';' [erste_gruppe] eins = 1 fünf = 5 tier = VOGEL [zweite_gruppe] pfad = /usr/local/bin URL = "http://www.example.com/~username" [dritte_gruppe] phpversion[] = "5.0" phpversion[] = "5.1" phpversion[] = "5.2" phpversion[] = "5.3"
Beispiel #2 parse_ini_file()
<?php define ('VOGEL', 'Amsel'); // Ohne Gruppen analysieren $ini_array = parse_ini_file("sample.ini"); print_r($ini_array); // Mit Gruppen analysieren $ini_array = parse_ini_file("sample.ini", TRUE); print_r($ini_array); ?>
Würde wie folgt ausgeben:
Array ( [eins] => 1 [fünf] => 5 [tier] => Amsel [pfad] => /usr/local/bin [URL] => http://www.example.com/~username [phpversion] => Array ( [0] => 5.0 [1] => 5.1 [2] => 5.2 [3] => 5.3 ) ) Array ( [erste_gruppe] => Array ( [eins] => 1 [fünf] => 5 [tier] => Amsel ) [zweite_gruppe] => Array ( [pfad] => /usr/local/bin [URL] => http://www.example.com/~username ) [dritte_gruppe] => Array ( [phpversion] => Array ( [0] => 5.0 [1] => 5.1 [2] => 5.2 [3] => 5.3 ) ) )