Парсер INI

Этот парсер поддерживает секции, пары «ключ=значение», комментарии (с использованием ; или #), строковые значения в кавычках и многострочные значения. Также выполняется определение логических и числовых типов.

Этот парсер обрабатывает стандартный формат INI. Некоторые специфичные для PHP расширения, такие как подстановка констант и специальные операторы, могут не поддерживаться.

При обнаружении дубликатов ключей в одной секции приоритет имеет последнее значение. Это соответствует стандартному поведению разбора INI.

Классические места: php.ini (вся конфигурация движка PHP), .gitconfig, наследие win.ini на Windows, записи .desktop на Linux, а также множество игр и десктопных приложений. Корни формата уходят в 1960–70-е годы, поэтому синтаксис везде немного различается — секции, пары key=value и комментарии с точкой с запятой образуют стабильное ядро.

Нет — всё является строкой; типы — это соглашение на стороне потребителя. Функция PHP parse_ini_file() приводит true/on/yes/1 и false/off/no/0 к логическим значениям (это задокументированное поведение), преобразует значения, похожие на числа, в целые и дробные, а остальное оставляет строками. Значение в кавычках ('1') в PHP сохраняется как строка. Этот парсер показывает исходные значения в том виде, в каком они записаны.

[section] начинает секцию, которая охватывает все последующие ключи до следующего заголовка — блоки [PHP] и [mail function] в php.ini устроены именно так. Вложенность имитируется ключами с точками (database.host = localhost) или именами секций вида [database.pool], поскольку сам формат имеет только один уровень. Глубоко вложенные данные — признак того, что вы переросли INI и вам нужен TOML или YAML.

Базовый формат почти не определяет escape-последовательностей — значения берутся буквально до конца строки. На практике: двойные кавычки группируют значения, содержащие пробелы, и являются единственным переносимым способом сохранить пробелы в начале или конце значения; интерполяция ${VAR} есть в одних реализациях (например, systemd) и отсутствует в других; а начинается ли комментарий с ; или # в середине строки, зависит от использующего парсера.

.env — это плоское подмножество INI: строки KEY=value, без секций, которые читают библиотеки dotenv на десятке языков, следуя методологии конфигурации 12-Factor App. Файлы INI опираются на секции и читаются конкретными приложениями, а не являются универсальным соглашением. Значения в .env почти всегда представляют собой строки, подставляемые в переменные окружения, тогда как потребители INI часто применяют собственные правила типизации.