Dislaimer | Kontakt | Sitemap

Hintergrund

Du bist hier: Tips » Scripte » PHP
PHP
Referenzliste

parse_ini_file
Dateisystem-Funktionen

    Befehl:
array parse_ini_file ( string $filename [, bool $process_sections ] )


    Parameter-Liste:
NameBeschreibung
filenameDer Dateiname der ini-Datei, die analysiert.
process_sectionsDurch die Einstellung der process_sections-Parameter auf TRUE, erhalten Sie ein mehrdimensionales Array, mit dem Abschnitt Namen und Einstellungen enthalten. Der Standardwert für process_sections ist false.
scanner_modeKann entweder INI_SCANNER_NORMAL (Standard) oder INI_SCANNER_RAW. Wenn INI_SCANNER_RAW angegeben wird, dann werden Optionswerte nicht analysiert werden.

    Rückgabewerte:
Die Einstellungen werden als assoziatives Array bei Erfolg zurück, und im Fehlerfall FALSE.

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


    Aktiv in Version:
(PHP 4, PHP 5, PHP 7)

    Hinweis:
Hinweis:


Diese Funktion hat nichts mit der php.ini-Datei zu tun. Es ist bereits von der Zeit, die Sie Ihrem Skript ausführen verarbeitet. Diese Funktion kann verwendet werden, um die Konfigurationsdateien Ihres eigenen Anwendung lesen.
Es gibt reservierte Wörter, die nicht als Schlüssel für INI-Dateien verwendet werden müssen. Dazu gehören: null, ja, nein, true, false, an, aus, keine. Werte null, nein und falsche Ergebnisse in "", ja und wahren Ergebnisse in "1". Charaktere ?{}|&~![()^" darf nicht überall in der Schlüssel verwendet werden und haben eine besondere Bedeutung in der Wertschöpfungs!.
Wenn ein Wert in der ini-Datei enthält alle nicht-alphanumerische Zeichen muss es in Anführungszeichen (") eingeschlossen werden.


    Siehe auch:
•  parse_ini_string()
Analysiert eine Konfigurationsstring
 

parse_ini_file() - Beispiel:

Eingabe:
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"


parse_ini_file() - Beispiel: 

<?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);
?>


Ausgabe:
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
                )
        )
)

Beschreibung:
Version Beschreibung
5.3.0 Hinzugefügt optional scanner_mode-Parameter. Einfache Anführungszeichen können nun rund Variablenzuweisungen verwendet werden. Hash Mark (#) kann nicht mehr als Kommentar verwendet werden und wird eine Missbilligung Warnung auslösen, wenn verwendet.
5.2.7 Auf Syntaxfehler wird diese Funktion FALSE, anstatt ein leeres Array zurück.
5.2.4 Tasten und Abschnittsnamen aus Zahlen bestehen, werden nun ausgewertet als PHP-Zahlen so Nummern beginnend mit 0 als octals und Nummern beginnend mit 0x bewertet werden hexadezimal ausgewertet.
5.0.0 Werte in Anführungszeichen können neue Zeilen enthalten.
4.2.1 Diese Funktion wird nun durch den abgesicherten Modus und open_basedir beeinflusst.
parse_ini_file() - Beispiel 2:

Eingabe:
Konstanten können auch in der ini-Datei analysiert werden, so dass, wenn Sie vor dem Ausführen parse_ini_file() eine Konstante als einer ini Wert definieren, wird es in die Ergebnisse einbezogen werden. Nur ini Werte ausgewertet. 


<?php
define('BIRD', 'Dodo bird');

// Parse without sections
$ini_array = parse_ini_file("sample.ini");
print_r($ini_array);

// Parse with sections
$ini_array = parse_ini_file("sample.ini", true);
print_r($ini_array);
?>


Ausgabe:
Array
(
    [one] => 1
    [five] => 5
    [animal] => Dodo bird
    [path] => /usr/local/bin
    [URL] => http://www.example.com/~username
    [phpversion] => Array
        (
            [0] => 5.0
            [1] => 5.1
            [2] => 5.2
            [3] => 5.3
        )

)
Array
(
    [first_section] => Array
        (
            [one] => 1
            [five] => 5
            [animal] => Dodo bird
        )

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

    [third_section] => Array
        (
            [phpversion] => Array
                (
                    [0] => 5.0
                    [1] => 5.1
                    [2] => 5.2
                    [3] => 5.3
                )

        )

)

Beschreibung:
Version Beschreibung
5.3.0 Hinzugefügt optional scanner_mode-Parameter. Einfache Anführungszeichen können nun rund Variablenzuweisungen verwendet werden. Hash Mark (#) kann nicht mehr als Kommentar verwendet werden und wird eine Missbilligung Warnung auslösen, wenn verwendet.
5.2.7 Auf Syntaxfehler wird diese Funktion FALSE, anstatt ein leeres Array zurück.
5.2.4 Tasten und Abschnittsnamen aus Zahlen bestehen, werden nun ausgewertet als PHP-Zahlen so Nummern beginnend mit 0 als octals und Nummern beginnend mit 0x bewertet werden hexadezimal ausgewertet.
5.0.0 Werte in Anführungszeichen können neue Zeilen enthalten.
4.2.1 Diese Funktion wird nun durch den abgesicherten Modus und open_basedir beeinflusst.
parse_ini_file() - Beispiel 3:

Eingabe: 
<?php
// A simple function used for comparing the results below
function yesno($expression)
{
    return($expression ? 'Yes' : 'No');
}

// Get the path to php.ini using the php_ini_loaded_file()
// function available as of PHP 5.2.4
$ini_path = php_ini_loaded_file();

// Parse php.ini
$ini = parse_ini_file($ini_path);

// Print and compare the values, note that using get_cfg_var()
// will give the same results for parsed and loaded here
echo '(parsed) magic_quotes_gpc = ' . yesno($ini['magic_quotes_gpc']) . PHP_EOL;
echo '(loaded) magic_quotes_gpc = ' . yesno(get_cfg_var('magic_quotes_gpc')) . PHP_EOL;
?>


Ausgabe:
(parsed) magic_quotes_gpc = Yes
(loaded) magic_quotes_gpc = Yes

Beschreibung:
Version Beschreibung
5.3.0 Hinzugefügt optional scanner_mode-Parameter. Einfache Anführungszeichen können nun rund Variablenzuweisungen verwendet werden. Hash Mark (#) kann nicht mehr als Kommentar verwendet werden und wird eine Missbilligung Warnung auslösen, wenn verwendet.
5.2.7 Auf Syntaxfehler wird diese Funktion FALSE, anstatt ein leeres Array zurück.
5.2.4 Tasten und Abschnittsnamen aus Zahlen bestehen, werden nun ausgewertet als PHP-Zahlen so Nummern beginnend mit 0 als octals und Nummern beginnend mit 0x bewertet werden hexadezimal ausgewertet.
5.0.0 Werte in Anführungszeichen können neue Zeilen enthalten.
4.2.1 Diese Funktion wird nun durch den abgesicherten Modus und open_basedir beeinflusst.
move_uploaded_file
Dateisystem-Funktionen