(PHP 5 >= 5.3.0, PHP 7, PHP 8)
parse_ini_string — Analysiert einen Konfigurations-String
$ini_string
, bool $process_sections
= false
, int $scanner_mode
= INI_SCANNER_NORMAL
): array|false
parse_ini_string() Gibt die Konfiguration aus dem String
ini_string
in einem assoziativen Array zurück.
Die Struktur des ini-Strings ist die selbe wie die der php.ini
ini_string
Der Inhalt der ini-Datei die analysiert wird.
process_sections
Ist der Parameter process_sections
als true
gesetzt, werden Sie ein mehrdimensionales Array zurückbekommen, welches die Abschnitte und Einstellungen enthält.
Die Standardeinstellung process_sections
ist false
scanner_mode
Kann entweder INI_SCANNER_NORMAL
(normal) oder
INI_SCANNER_RAW
sein. Wenn INI_SCANNER_RAW
angegeben ist, werden optionale Inhalte nicht analysiert.
Seit PHP 5.6.1 kann auch INI_SCANNER_TYPED
angegeben werden.
In diesem Modus werden soweit möglich die Typen von Boolean-, Null- oder Integer-Werten
beibehalten. Die Zeichenketten "true"
, "on"
und
"yes"
werden zu true
konvertiert. "false"
,
"off"
, "no"
und "none"
werden
als false
angesehen. "null"
wird in diesem Modus zu null
.
Soweit möglich werden alle numerischen Zeichenketten zu Integertypen umgewandelt.
Die Einstellungen werden als assoziatives Array bei Erfolg,
und false
bei einem Fehler zurückgegeben..
Hinweis: Es gibt reservierte Wörter die nicht als Keys für die ini-Dateien benutzt werden dürfen. Dies schließt
null
,yes
,no
,true
,false
,on
,off
undnone
ein. Die Wertenull
,off
,no
undfalse
geben""
zurück, und die Werteon
,yes
undtrue
"1"
, es sei denn derINI_SCANNER_TYPED
-Modus wird verwendet. Die Buchstaben?{}|&~![()^"
dürfen nirgendwo inm Key benutzt werden und haben eine spezielle Bedeutung.