PHP-Funktion parse_ini_file()

PHP-Dateisystemfunktionen

Definition und Verwendung

Die Funktion parse_ini_file() analysiert eine Konfigurationsdatei und gibt die darin enthaltenen Einstellungen in Form eines Arrays zurück.

Syntax

parse_ini_file(file,process_sections)
Parameter Beschreibung
file Erforderlich. Legt die zu überprüfende ini-Datei fest.
process_sections Optional. Wenn auf true gesetzt, wird ein mehrdimensionales Array zurückgegeben, das die Namen und Einstellungen jedes Abschnitts der Konfigurationsdatei enthält. Standardmäßig ist dies false.

Erklärung

Die Struktur der ini-Datei ist ähnlich wie die des php.ini.

Konstanten können auch in der ini-Datei interpretiert werden, daher werden Konstanten, die vor der Ausführung von parse_ini_file() als Werte für ini definiert wurden, in die Ergebnisse integriert. Nur die Werte von ini werden ausgewertet.

Schlüsselnamen und Abschnittsnamen, die aus Ziffern bestehen, werden von PHP als Integer behandelt, daher werden Ziffern, die mit 0 beginnen, als oktale und solche, die mit 0x beginnen, als hexadezimal behandelt.

Hinweise und Anmerkungen

Anmerkung:Diese Funktion kann verwendet werden, um die Konfigurationsdatei Ihres eigenen Anwendungen zu lesen. Diese Funktion hat nichts mit der Datei php.ini zu tun, die bereits bei der Ausführung des Skripts verarbeitet wurde.

Anmerkung:Falls der Wert in der ini-Datei nicht aus reinen Buchstaben und Ziffern besteht, muss er in doppelte Anführungszeichen ("") gesetzt werden.

Anmerkung:Einige Reservewörter können nicht als Schlüsselnamen in ini-Dateien verwendet werden, einschließlich: null, yes, no, true und false. Werte wie null, no und false sind äquivalent zu "", und Werte wie yes und true sind äquivalent zu "1". Zeichen wie {}|"~![()" dürfen an keiner Stelle im Schlüsselnamen verwendet werden, und diese Zeichen haben in den Optionen eine spezielle Bedeutung.

Anmerkung:Ab PHP 5.0 Version wird die Funktion auch Optionen in der neuen Zeile behandeln.

Beispiel

Beispiel 1

Inhalt von "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"));
?>

Ausgabe:

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

Beispiel 2

Inhalt von "test.ini":

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

PHP-Code (process_sections gesetzt auf true):

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

Ausgabe:

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

PHP-Dateisystemfunktionen