(PHP 5 >= 5.3.0, PHP 7)
parse_ini_string — Разбирает строку конфигурации
$ini
[, bool $process_sections
= FALSE
[, int $scanner_mode
= INI_SCANNER_NORMAL
]] ) : array
parse_ini_string() возвращает настройки из строки
ini
в виде ассоциативного массива.
Структура INI-строки такая же, как и в php.ini.
ini
Содержимое разбираемого INI-файла.
process_sections
Установив в параметр process_sections
TRUE
, можно получить многомерный массив, который включает
названия секций и настроек. По умолчанию
process_sections
равен FALSE
scanner_mode
Может принимать следующие значения: INI_SCANNER_NORMAL
(по умолчанию) или INI_SCANNER_RAW
. Если
указано значение INI_SCANNER_RAW
, то
значения опций не будут обрабатываться.
С версии PHP 5.6.1 также можно задать INI_SCANNER_TYPED
.
В этом режиме типы boolean, null и integer будут, по возможности, сохраняться.
Строковые значения "true", "on" и "yes"
будут преобразованы в TRUE
. "false", "off", "no"
и "none" в FALSE
. "null" преобразуется в NULL
.
Кроме этого, все числовые строки будут, по возможности, преобразованы к целым числам.
В случае успеха, настройки возвращаются в виде ассоциативного
массива (array). В случае ошибки, возвращается FALSE
.
Замечание: Существует зарезервированные слова, которые нельзя использовать в качестве ключей в ini-файлах. Такими словами являются: null, yes, no, true, false, on, off, none. Значения null, off, no и false преобразуются в "", а значения on, yes и true в "1" , но только если не используется режим
INI_SCANNER_TYPED
(доступен с PHP 5.6.1). Символы ?{}|&~!()^" не должны использоваться в ключах и иметь какой-либо особый смысл в значениях.