ini

ini trabalha com arquivos INI reais: lê seções e valores tipados, pesquisa configurações, valida a sintaxe e altera uma chave de forma atômica. O caminho é key ou section.key.

DadosVersão 1.3.6Estável
lil-terminal

Visão geral

ini trabalha diretamente com arquivos INI: lê chaves por caminhos pontuados, busca chaves ou valores, altera uma configuração de forma atômica, valida o resultado e mostra a fonte normalizada sem buffer de sessão.

Uma seção e uma chave formam dois níveis

application.name seleciona name dentro de [application]. Um caminho mais profundo como a.b.c é rejeitado de propósito; JSON, TOML ou YAML são melhores quando a configuração precisa de mais níveis.

Sintaxe

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

Referência

ini <file>

mostrar dados INI

ini <file> <key>

mostrar o valor exato de uma chave ou seção

ini dump <file>

mostrar o texto-fonte INI normalizado

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

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

-w <key> : <value>

gravar um escalar ou lista no estilo JSON diretamente no arquivo

-w <key> < <file>

gravar um valor lido de outro arquivo

-d <key>

excluir uma chave ou seção

-c

validar o arquivo INI

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; ini <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.

-w grava imediatamente após : ou lê o valor de outro arquivo com <; -d remove chave ou seção. Só é possível gravar key ou section.key, não a.b.c. Ao regravar, comentários e espaços podem sumir; chaves repetidas seguem o parser INI do PHP. Para preservar o texto, use edit ou code. Minimum permite leitura; operações avançadas exigem Base.

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 ini
Pacote Minimum

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

install ini -m
Versão pública exata

Instalar exatamente esta versão publicada.

install ini -v 1.3.6
Verificar ou atualizar

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

upgrade ini
Remover módulo

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

install ini -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 | ini app.ini
application.name   lil-sandbox
application.debug  true
paths.source       ../src
paths.public       ../public
Mostrar dados INI
cd \sandbox\config | app.ini
application.name   lil-sandbox
application.debug  true
paths.source       ../src
paths.public       ../public
Mostrar o valor exato de uma chave ou seção
ini config/app.ini application.name
lil-sandbox
Procurar correspondências em chaves ou valores; * e ? ativam uma máscara
ini config/app.ini -f "paths.*" -k
paths.source  ../src
paths.public  ../public
Procurar correspondências em chaves ou valores; * e ? ativam uma máscara
ini config/app.ini -f "../public" -v
paths.public  ../public
Procurar correspondências em chaves ou valores; * e ? ativam uma máscara
ini config/app.ini -f "debug"
application.debug  true
Gravar um escalar ou lista no estilo JSON diretamente no arquivo
ini config/app.ini -w application.debug : false
application.debug  false
Gravar um valor lido de outro arquivo
ini config/app.ini -w application.name < config/plain-value.txt
application.name  demo-site
Excluir uma chave ou seção
ini config/app.ini -d paths.public
application.name   lil-sandbox
application.debug  true
paths.source       ../src
Tratar um arquivo ausente
ini config/app.ini -c
Valid INI
Mostrar o texto-fonte INI normalizado
ini dump config/app.ini
[application]
name = "lil-sandbox"
debug = true

[paths]
source = "../src"
public = "../public"
Mostrar o valor exato de uma chave ou seção
ini config/app.ini missing.key
Path not found
Gravar um escalar ou lista no estilo JSON diretamente no arquivo
ini config/app.ini -w a.b.c : 1
INI paths support section.key only
Validar o arquivo INI
ini config/invalid.ini -c
Invalid INI
Mostrar dados INI
ini config/missing.ini
File not found
Gravar um escalar ou lista no estilo JSON diretamente no arquivo
ini config/app.ini -w application.name
Value required after : or

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

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

[application]
name = "lil-sandbox"
debug = true

[paths]
source = "../src"
public = "../public"

Documentação relacionada

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

Versão pública atual

v1.3.62026-11-01

Refinamento de produção

Versão estável atual de ini. ini trabalha com arquivos INI reais: lê seções e valores tipados, pesquisa configurações, valida a sintaxe e altera uma chave de forma atômica.

# Histórico de versões