conf

conf lê e altera arquivos simples .conf, .cfg e .env formados por pares chave/valor e seções. As gravações são atômicas e dump mostra a configuração normalizada.

DadosVersão 1.1.6Estável
lil-terminal

Visão geral

conf trata configurações simples como dados estruturados de caminho e valor: permite ler, buscar, alterar ou apagar uma opção diretamente, validar a sintaxe compatível e mostrar o texto normalizado completo.

Configuração sem editor específico de formato

database.host significa a chave host dentro da seção database. Primeiro inspecione ou pesquise; depois altere apenas o caminho necessário com -w. Se comentários e formatação exata precisam permanecer intactos, use edit ou code.

Sintaxe

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

Referência

conf <file>

mostrar dados de configuração

conf <file> <key>

mostrar um caminho pontuado exato

conf dump <file>

mostrar o texto-fonte conf normalizado

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

procurar correspondências em chaves ou valores; * e ? ativam uma máscara

-w <key> : <value>

gravar um valor diretamente no arquivo

-w <key> < <file>

gravar um valor lido de outro arquivo

-d <key>

excluir um valor pelo caminho pontuado

-c

validar o arquivo conf

Arquivo ativo

Com o core atual, um arquivo aberto com sucesso passa a ficar disponível imediatamente como $. Se este módulo for o manipulador instalado de maior prioridade para a extensão, basta digitar o nome do arquivo para abri-lo por este comando. Esses são atalhos do core; conf <file> continua sendo a forma explícita.

Pesquisa

-f pesquisa caminhos e valores. Use -k somente para chaves ou -v somente para valores. Consultas com * ou ? são tratadas como máscaras.

Edição direta

-w grava imediatamente no arquivo. Depois de : vem um valor em linha; < <file> lê o valor de outro arquivo. -d exclui um caminho pontuado.

Escopo do formato

O módulo implementa de propósito o subconjunto de configuração comum em hospedagem compartilhada. Recursos avançados do formato devem ser editados como texto com edit ou code.

Não é um parser geral para Nginx, Apache nem para todas as variantes de .env. Chaves ou seções repetidas são rejeitadas; comentários e espaçamento não sobrevivem à regravação. Use edit ou code para diretivas complexas. Minimum permite leitura; Base disponibiliza operações avançadas.

Prévia interativa do sandbox

Execute os exemplos preparados diretamente na página. Os resultados são predefinidos e exibidos no navegador; nenhum comando do terminal é executado no servidor.

Abrir o arquivo e reutilizá-lo com $

Instalar e gerenciar

Instale a versão compatível atual. Escolha Base para o conjunto completo de recursos ou Minimum para o pacote reduzido; use upgrade para atualizar um módulo já instalado.

Base e Minimum são dois pacotes da mesma versão atual do módulo.

Pacote Base

Instala o pacote completo com referência local e todos os modos publicados.

install conf
Pacote Minimum

Instalar o pacote reduzido. A referência local é omitida; help <cmd> -i abre a referência atual do servidor.

install conf -m
Versão pública exata

Instalar exatamente esta versão publicada.

install conf -v 1.1.6
Verificar ou atualizar

upgrade verifica compatibilidade e substitui o bloco somente quando necessário.

upgrade conf
Remover módulo

Remove o bloco da extensão sem afetar o núcleo ou outros módulos.

install conf -u

Exemplos

Os exemplos podem ser copiados, mas o site não os executa. Revise caminhos, permissões e opções destrutivas.

Abrir o arquivo e reutilizá-lo com $
cd \sandbox\config | conf app.conf
application    shop
production     true
database.host  localhost
database.port  3306
Mostrar dados de configuração
cd \sandbox\config | app.conf
application    shop
production     true
database.host  localhost
database.port  3306
Mostrar um caminho pontuado exato
conf config/app.conf database.host
localhost
Procurar correspondências em chaves ou valores; * e ? ativam uma máscara
conf config/app.conf -f "database.*" -k
database.host  localhost
database.port  3306
Procurar correspondências em chaves ou valores; * e ? ativam uma máscara
conf config/app.conf -f "shop" -v
application  shop
Procurar correspondências em chaves ou valores; * e ? ativam uma máscara
conf config/app.conf -f "production"
production  true
Gravar um valor diretamente no arquivo
conf config/app.conf -w database.port : 3307
database.port  3307
Gravar um valor lido de outro arquivo
conf config/app.conf -w application < config/plain-value.txt
application  demo-site
Excluir um valor pelo caminho pontuado
conf config/app.conf -d database.port
application    shop
production     true
database.host  localhost
Tratar um arquivo ausente
conf config/app.conf -c
Valid configuration
Mostrar o texto-fonte conf normalizado
conf dump config/app.conf
application=shop
production=true

[database]
host=localhost
port=3306
Mostrar um caminho pontuado exato
conf config/app.conf missing.key
Path not found
Gravar um valor lido de outro arquivo
conf config/app.conf -w database.extra < config/value.json
Nested configuration sections are not supported
Validar o arquivo conf
conf config/duplicate.conf -c
Duplicate configuration key
Mostrar dados de configuração
conf config/missing.conf
File not found
Gravar um valor diretamente no arquivo
conf config/app.conf -w database.port
Value required after : or

Arquivo usado neste exemplo: sandbox/config/app.conf

O exemplo usa um arquivo ou diretório do espaço protegido de documentação /sandbox/.

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

[database]
host=localhost
port=3306

Documentação relacionada

Como instalar um módulo? →Por que um comando responde “command not found”? →

Versão pública atual

v1.1.62026-11-01

Refinamento de produção

Versão estável atual de conf. conf lê e altera arquivos simples `.

# Histórico de versões