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.5Está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.

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.5
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
app.conf
application    shop
production     true
database.host  localhost
database.port  3306
Mostrar um caminho pontuado exato
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
Mostrar o texto-fonte conf normalizado
conf dump $
application=shop
production=true

[database]
host=localhost
port=3306
Tratar um arquivo ausente
conf \sandbox\config\missing.conf
Arquivo não encontrado

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.52026-08-12

Ajuda uniforme para dados estruturados

Leitura, busca, gravação, remoção e validação seguem agora o mesmo padrão de opções.

# Histórico de versões