Функции за работа с файловата система
PHP Manual

parse_ini_file

(PHP 4, PHP 5)

parse_ini_fileParse a configuration file

Описание

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

parse_ini_file() зарежда ini файл посочен чрез filename и връща настройките в него като асоциативен масив.

Структурата на ini файла трябва да е същата като на php.ini.

Параметри

filename

Името на ini файла, който ще бъде парснат.

process_sections

Чрез подаване на TRUE на process_sections функцията ще върне многомерен масив, съдържащ имената на секциите и настройките. По подразбиране process_sections е FALSE.

Връщани стойности

При успех - връща настройките като асоциативен масив; при неуспех връща FALSE

Дневник на промените

Версия Описание
5.2.7 Ако открие ситнтактична грешка ще върне FALSE вместо празен масив. array
5.2.4 Ключовете и имената на секциите, които са съставени от числа ще бъдат оценени като PHP цели числа, т.е. числата, започващи с 0 ще бъдат оценени като осмични стойности и номерата, започващо с 0x ще бъдат оценени като шестнайсетични.
5.0.0 Стойностите заградени с двойни кавички могат да съдържат нови редове.
4.2.1 От PHP 4.2.1 тази функция взима под внимание ограниченията на защитен режим и open_basedir.

Примери

Example #1 Съдържанието на sample.ini

; Това е примерен конфигурационен файл
; Коментарите започват с ;', както в php.ini

[first_section]
one = 1
five = 5
animal = BIRD

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

Example #2 parse_ini_file() пример

Константите също може да се парсват в ini файл ако сте ги дефинирали преди да се използвате parse_ini_file(). По този начин техните стойности ще присъстват в резултите. Само ini стойностите ще бъдат оценявани за съвпадение с имената на константите. Например:

<?php

define
('BIRD''Dodo bird');

// Парсване без секции
$ini_array parse_ini_file("sample.ini");
print_r($ini_array);

// Парсване със секции
$ini_array parse_ini_file("sample.ini"true);
print_r($ini_array);

?>

Примерът по-горе ще изведе нещо подобно на:

Array
(
    [one] => 1
    [five] => 5
    [animal] => Dodo bird
    [path] => /usr/local/bin
    [URL] => http://www.example.com/~username
)
Array
(
    [first_section] => Array
        (
            [one] => 1
            [five] => 5
            [animal] = Dodo bird
        )

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

)

Бележки

Забележка: Тази функция няма нищо общо с файла php.ini, който е вече е обработен преди да е старитиран текущия скрипт. Тази функция е предназначена да зарежда конфигурационните файлове на вашето собствено приложение.

Забележка: Ако някоя стойност в ini файла съдържа символи, които не са букви или числа - то трябва стойността да е оградена с кавички.

Забележка: Има запазени думи, които трябва да не бъдат използвани като ключове в ini файловете. Те са: null, yes, no, true, и false. Стойностите null, no и false се превръщат в "", yes и true в "1". Символите {}|&~![()" не трябва да бъдат използвани в ключовете и имат специално значение в стойностите.


Функции за работа с файловата система
PHP Manual