`xml`

xml transforma XML em uma árvore endereçável: elementos usam caminhos pontuados, atributos usam @name e o texto do elemento usa #text.

DadosVersão 1.1.5Estável

lil-terminal

pwd/sandboxdir 1 . -Fconfig/ data/ logs/ src/ tmp/app.xmlconfig.@env production config.application.name lil-shop config.application.debug true config.database.host localhost config.database.port 3306xml $ -cValid XMLxml dump $<?xml version="1.0" encoding="UTF-8"?> <config env="production">…</config>

Visão geral

xml aplica o mesmo fluxo focado a XML: lê caminhos de elementos e atributos, busca chaves ou valores, altera um nó de forma atômica, valida o documento e mostra XML normalizado quando a fonte completa é necessária.

Elementos, atributos e texto são nós diferentes

config.@env e config.application.name selecionam nós XML diferentes. O modelo compacto serve para XML simples, não substitui XPath nem um editor XML completo; requer PHP DOM.

Sintaxe

lil-terminal

xml <file> [key|options] · xml dump <file>

Referência

xml <file>

mostrar dados XML

xml <file> <key>

mostrar um elemento, atributo (@name) ou #text exato pelo caminho

xml dump <file>

mostrar o texto-fonte XML normalizado

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

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

-w <key> : <value>

gravar um valor e normalizar o arquivo XML

-w <key> < <file>

gravar um valor lido de outro arquivo

-d <key>

excluir um valor pelo caminho pontuado

-c

validar o arquivo XML

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

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 xml

Pacote Minimum

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

install xml -m

Versão pública exata

Instalar exatamente esta versão publicada.

install xml -v 1.1.5

Verificar ou atualizar

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

upgrade xml

Remover módulo

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

install xml -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 | xml app.xml

config.@env              production
config.application.name  lil-shop
config.application.debug true
config.database.host     localhost
config.database.port     3306

Mostrar dados XML

app.xml

config.@env              production
config.application.name  lil-shop
config.application.debug true
config.database.host     localhost
config.database.port     3306

Mostrar um elemento, atributo (@name) ou #text exato pelo caminho

xml $ config.application.name

lil-shop

Mostrar um elemento, atributo (@name) ou #text exato pelo caminho

xml $ config.@env

production

Xml · find-key

xml $ -f "host" -k

config.database.host  localhost

Xml · find-value

xml $ -f "localhost" -v

config.database.host  localhost

Xml · write

xml $ -w config.database.port : 3307

config.database.port  3307

Xml · delete

xml $ -d config.application.debug

config.application.name  lil-shop
config.database.host     localhost

Xml · validate

xml $ -c

Valid XML

Mostrar o texto-fonte XML normalizado

xml dump $

<?xml version="1.0" encoding="UTF-8"?>
<config env="production">…</config>

Tratar um arquivo ausente

xml \sandbox\config\missing.xml

Arquivo não encontrado

Arquivo usado neste exemplo: `sandbox/config/app.xml`

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

<?xml version="1.0" encoding="UTF-8"?>
<config env="production">
  <application><name>lil-shop</name><debug>true</debug></application>
  <database><host>localhost</host><port>3306</port></database>
</config>

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-14

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

xml