array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.parse-ini-string.php', 1 => 'parse_ini_string', 2 => 'Разбирает строку конфигурации', ), 'up' => array ( 0 => 'ref.filesystem.php', 1 => 'Функции файловой системы', ), 'prev' => array ( 0 => 'function.parse-ini-file.php', 1 => 'parse_ini_file', ), 'next' => array ( 0 => 'function.pathinfo.php', 1 => 'pathinfo', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/filesystem/functions/parse-ini-string.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

parse_ini_string

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

parse_ini_string — Разбирает строку конфигурации

Описание

parse_ini_string(string $ini_string, bool $process_sections = false, int $scanner_mode = INI_SCANNER_NORMAL): array|false

parse_ini_string() возвращает настройки из строки ini_string в виде ассоциативного массива.

Структура INI-строки такая же, как и в php.ini.

Внимание

Функция не должна использоваться с недоверенными входными данными, за исключением случаев, когда значение параметра scanner_mode равно INI_SCANNER_RAW, поскольку обработанные данные могут содержать значения конфиденциальных констант, таких как константы, содержащие пароль базы данных.

Список параметров

ini_string

Содержимое разбираемого 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). Символы ?{}|&~!()^" не должны использоваться в ключах и иметь какой-либо особый смысл в значениях.

Смотрите также