Справочник - все функции PHP

a b c d e f g h i j k l m n o p q r s t u v w x y z

parse_ini_file

(PHP 4)
parse_ini_file - разбирает файл конфигурации.

Описание

array parse_ini_file (string filename [, bool process_sections])
parse_ini_file() загружает ini-файл filename и возвращает его установки в виде ассоциативного массива. Установив в последний параметр process_sections TRUE, вы получите многомерный массив, включая имена разделов и установки. По умолчанию process_sections имеет значение FALSE.

Примечание: эта функция ничего не делает с файлом php.ini. Он уже обработан при запуске скрипта. Эта функция может использоваться для чтения файлов конфигураций ваших приложений.

Примечание: если значение в ini-файле содержит не-алфавитно-числовые символы, необходимо заключить его в двойные кавычки (").

Примечание: начиная с PHP 4.2.1, на эту функцию воздействует также safe_mode и open_basedir.

Структура ini-файла аналогична структуре php.ini.

Предупреждение!
Если разбираемый ini-файл сформирован неверно, PHP выполняет выход.

Пример 1. Содержимое sample.ini

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

[first_section]
one = 1
five = 5

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

Пример 2. parse_ini_file()

<?php

// Разобрать без разделов
$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
    [path] => /usr/local/bin
    [URL] => http://www.example.com/~username
)
Array
(
    [first_section] => Array
        (
            [one] => 1
            [five] => 5
        )

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

)