Функция PHP parse_ini_file()

Определение и использование

Функция parse_ini_file() анализирует конфигурационный файл и возвращает его настройки в виде массива.

Синтаксис

parse_ini_file(file,process_sections)
Параметры Описание
file Обязателен. Определяет ini-файл, который нужно проверить.
process_sections Опционально. Если установлено в true,则在多维数组中返回配置文件中每一节的名称和设置。По умолчанию false.

Объяснение

Структура файла ini ähnelt der von php.ini.

Константы также могут быть интерпретированы в файлах ini, поэтому если перед вызовом parse_ini_file() определены константы в качестве значений ini, они будут интегрированы в результат. Оцениваются только значения ini.

Имена ключей и заголовков, состоящие из цифр, обрабатываются PHP как целые числа, поэтому числа, начинающиеся с 0, обрабатываются как восьмеричные, а числа, начинающиеся с 0x, обрабатываются как шестнадцатеричные.

Подсказки и комментарии

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

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

Комментарий:Некоторые ключевые слова не могут использоваться в качестве имен ключей в файлах ini, включая: null, yes, no, true и false. Значения null, no и false эквивалентны "", значения yes и true эквивалентны "1". Знаки {}|"~![()" также не могут использоваться в именах ключей в любом месте, и эти знаки имеют особое значение в значениях опций.

Комментарий:С PHP 5.0 версии функция также обрабатывает новые строки в значениях опций.

Пример

Пример 1

Содержимое файла "test.ini":

[names]
me = Robert
you = Peter
[urls]
first = "http://www.example.com"
second = "http://www.codew3c.com"

Код PHP:

<?php
print_r(parse_ini_file("test.ini"));
?>

Вывод:

Массив
(
[me] => Robert
[you] => Peter
[first] => http://www.example.com
[second] => http://www.codew3c.com
)

Пример 2

Содержимое файла "test.ini":

[names]
me = Robert
you = Peter
[urls]
first = "http://www.example.com"
second = "http://www.codew3c.com"

Код PHP (process_sections Установлено в true):

<?php
print_r(parse_ini_file("test.ini",true));
?>

Вывод:

Массив
(
[names] => Массив
  (
  [me] => Robert
  [you] => Peter
  )
[urls] => Массив
  (
  [first] => http://www.example.com
  [second] => http://www.codew3c.com
  )
)