conf

conf читает и изменяет простые файлы .conf, .cfg и .env с парами «ключ — значение» и секциями. Запись выполняется атомарно, а dump показывает нормализованную конфигурацию.

ДанныеВерсия 1.1.6Стабильная
lil-terminal

Обзор

conf представляет простые конфигурационные файлы как структурированные пары «путь — значение»: чтение, поиск, изменение и удаление настройки прямо в файле, проверка синтаксиса и полный нормализованный текст через dump.

Конфигурация без отдельного редактора формата

Путь database.host означает ключ host внутри секции database. Сначала удобно прочитать значение или найти его через -f, затем изменить только нужный путь через -w; если важно сохранить комментарии и точное оформление исходника, используйте edit или code.

Синтаксис

lil-terminal
conf <file> [key|options] · conf dump <file>

Справочник

conf <file>

показать данные конфигурации

conf <file> <key>

показать точное значение по точечному пути

conf dump <file>

показать нормализованный исходный текст conf

-f <text|mask> [-k|-v]

найти совпадения в ключах или значениях; * и ? включают маску

-w <key> : <value>

записать значение прямо в файл

-w <key> < <file>

записать значение, прочитанное из другого файла

-d <key>

удалить значение по точечному пути

-c

проверить корректность файла conf

Активный файл

В текущем ядре успешно открытый файл сразу становится доступен через $. Если этот модуль — установленный обработчик с наивысшим приоритетом для расширения файла, достаточно ввести только имя файла: ядро направит его в эту команду. Это удобства ядра; явной формой остаётся conf <file>.

Поиск

-f ищет по путям и значениям. -k ограничивает поиск ключами, -v — значениями. Если запрос содержит * или ?, он трактуется как маска.

Прямое редактирование

-w сразу записывает изменение в файл. После : задаётся значение в строке, а < <file> читает значение из другого файла. -d удаляет один точечный путь.

Границы формата

Модуль намеренно поддерживает распространённое подмножество конфигурационного формата, типичное для shared hosting. Редкие возможности формата лучше править текстом через edit или code, чтобы не переосмысливать их молча.

Это не универсальный парсер Nginx, Apache и всех разновидностей .env. Сложные директивы, блоки и особые правила экранирования могут не поддерживаться. Повторные имена секций и ключей отклоняются; комментарии и исходное оформление при записи не сохраняются. Для таких файлов безопаснее edit или code. В Minimum доступен просмотр, остальные функции требуют Base.

Интерактивный пример из `/sandbox/`

Запускайте подготовленные примеры прямо на странице. Результат заранее сформирован и показывается в браузере; команды терминала на сервере не выполняются.

Открыть файл и повторно использовать его через $

Установка и управление

Устанавливайте актуальную совместимую версию. Для полного набора возможностей выбирайте Base, для сокращённого — Minimum; уже установленный модуль обновляет команда upgrade.

Base и Minimum — два пакета одного текущего релиза модуля, а не разные версии команды.

Пакет Base

Установить полный пакет с локальной справкой и всеми опубликованными режимами.

install conf
Пакет Minimum

Установить сокращённый пакет без локальной справки; help <cmd> -i открывает актуальную серверную справку.

install conf -m
Точная публичная версия

Установить именно эту опубликованную версию.

install conf -v 1.1.6
Проверить или обновить

Поручить upgrade проверить совместимость и заменить установленный блок только при необходимости.

upgrade conf
Удалить модуль

Удалить блок расширения, не затрагивая ядро и остальные модули.

install conf -u

Примеры

Примеры можно копировать, но сайт их не выполняет. Перед запуском на реальном проекте проверьте пути, права и разрушающие флаги.

Открыть файл и повторно использовать его через $
cd \sandbox\config | conf app.conf
application    shop
production     true
database.host  localhost
database.port  3306
Показать данные конфигурации
cd \sandbox\config | app.conf
application    shop
production     true
database.host  localhost
database.port  3306
Показать точное значение по точечному пути
conf config/app.conf database.host
localhost
Найти совпадения в ключах или значениях; * и ? включают маску
conf config/app.conf -f "database.*" -k
database.host  localhost
database.port  3306
Найти совпадения в ключах или значениях; * и ? включают маску
conf config/app.conf -f "shop" -v
application  shop
Найти совпадения в ключах или значениях; * и ? включают маску
conf config/app.conf -f "production"
production  true
Записать значение прямо в файл
conf config/app.conf -w database.port : 3307
database.port  3307
Записать значение, прочитанное из другого файла
conf config/app.conf -w application < config/plain-value.txt
application  demo-site
Удалить значение по точечному пути
conf config/app.conf -d database.port
application    shop
production     true
database.host  localhost
Проверить отсутствующий файл
conf config/app.conf -c
Valid configuration
Показать нормализованный исходный текст conf
conf dump config/app.conf
application=shop
production=true

[database]
host=localhost
port=3306
Показать точное значение по точечному пути
conf config/app.conf missing.key
Path not found
Записать значение, прочитанное из другого файла
conf config/app.conf -w database.extra < config/value.json
Nested configuration sections are not supported
Проверить корректность файла conf
conf config/duplicate.conf -c
Duplicate configuration key
Показать данные конфигурации
conf config/missing.conf
File not found
Записать значение прямо в файл
conf config/app.conf -w database.port
Value required after : or

Файл из примера: sandbox/config/app.conf

Пример использует файл или каталог из защищённой учебной папки /sandbox/.

# common key/value configuration
application=shop
production=true

[database]
host=localhost
port=3306

Связанная документация

Как установить модуль? →Почему команда отвечает «command not found»? →

Текущая публичная версия

v1.1.62026-11-01

Производственная доработка

Актуальная стабильная версия conf. conf читает и изменяет простые файлы `.

# История версий