conf

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

ДанныеВерсия 1.1.5Стабильная
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, чтобы не переосмысливать их молча.

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

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

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

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

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

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

Пакет Base

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

install conf
Пакет Minimum

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

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

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

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

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

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

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

install conf -u

Примеры

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

Открыть файл и повторно использовать его через $
cd \sandbox\config | conf app.conf
application    shop
production     true
database.host  localhost
database.port  3306
Показать данные конфигурации
app.conf
application    shop
production     true
database.host  localhost
database.port  3306
Показать точное значение по точечному пути
conf $ database.host
localhost
Conf · find-key
conf $ -f "database*" -k
database.host  localhost
database.port  3306
Conf · find-value
conf $ -f "true" -v
production  true
Conf · write
conf $ -w database.password : "Ed1g!fs:13od"
database.password  Ed1g!fs:13od
Conf · delete
conf $ -d database.password
database.host  localhost
database.port  3306
Conf · validate
conf $ -c
Valid configuration
Показать нормализованный исходный текст conf
conf dump $
application=shop
production=true

[database]
host=localhost
port=3306
Проверить отсутствующий файл
conf \sandbox\config\missing.conf
Файл не найден

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

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

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

[database]
host=localhost
port=3306

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

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

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

v1.1.52026-08-12

Единая справка структурированных данных

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

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