Google

NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.7">

parse_ini_file

(PHP 4 )

parse_ini_file -- Analysiert eine Konfiguratiionsdatei

Beschreibung

array parse_ini_file ( string 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.

Anmerkung: 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.

Anmerkung: Enthält ein Wert in der ini Datei nicht alphanumerische Zeichen, so muss dieser von doppelten Anführungszeichen (") eingeschlossen sein.

Anmerkung: 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.

Warnung

Ist die zu parsende ini-Datei missgebildet, beendet PHP das Skript.

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

[zweite_gruppe]
pfad = /usr/local/bin
URL = "http://www.example.com/~username"

Beispiel 2. parse_ini_file()

<?php

// 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
    [pfad] => /usr/local/bin
    [URL] => http://www.example.com/~username
)
Array
(
    [erste_gruppe] => Array
        (
            [eins] => 1
            [fünf] => 5
        )

    [zweite_gruppe] => Array
        (
            [pfad] => /usr/local/bin
            [URL] => http://www.example.com/~username
        )

)