parse_ini_string
(PHP 5 >= 5.3.0, PHP 7, PHP 8)
parse_ini_string — Analysiert einen Konfigurations-String
Beschreibung
$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
Parameter-Liste
-
ini_string
-
Der Inhalt der ini-Datei die analysiert wird.
-
process_sections
-
Ist der Parameter
process_sections
alstrue
gesetzt, werden Sie ein mehrdimensionales Array zurückbekommen, welches die Abschnitte und Einstellungen enthält. Die Standardeinstellungprocess_sections
istfalse
-
scanner_mode
-
Kann entweder
INI_SCANNER_NORMAL
(normal) oderINI_SCANNER_RAW
sein. WennINI_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 zutrue
konvertiert."false"
,"off"
,"no"
und"none"
werden alsfalse
angesehen."null"
wird in diesem Modus zunull
. Soweit möglich werden alle numerischen Zeichenketten zu Integertypen umgewandelt.
Rückgabewerte
Die Einstellungen werden als assoziatives Array bei Erfolg,
und false
bei einem Fehler zurückgegeben..
Anmerkungen
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.