xml

xml convierte XML en un árbol direccionable: los elementos usan rutas con puntos, los atributos @name y el texto del elemento #text.

DatosVersión 1.1.6Estable
lil-terminal

Resumen

xml aplica el mismo flujo preciso a XML: inspecciona rutas de elementos y atributos, busca claves o valores, modifica un nodo de forma atómica, valida el documento y permite ver el XML normalizado completo.

Elementos, atributos y texto son nodos diferentes

config.@env y config.application.name seleccionan nodos XML distintos. La ruta compacta sirve para XML sencillo, no pretende sustituir XPath ni un editor XML completo; requiere PHP DOM.

Sintaxis

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

Referencia

xml <file>

mostrar datos XML

xml <file> <key>

mostrar un elemento, atributo (@name) o #text exacto por ruta

xml dump <file>

mostrar el texto XML normalizado

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

buscar coincidencias en claves o valores; * y ? activan una máscara

-w <key> : <value>

escribir un valor y normalizar el archivo XML

-w <key> < <file>

escribir un valor leído desde otro archivo

-d <key>

eliminar un valor por ruta con puntos

-c

validar el archivo XML

Cómo usarlo

Empieza con xml config/app.xml para ver las rutas y añade una ruta con puntos para consultar un valor. -f busca rutas y valores, -k solo nombres y -v solo valores. -c valida; dump muestra XML reconstruido. En Base, -w <key> : <value> cambia un valor, < <file> lo toma de otro archivo y -d <key> elimina un nodo. Haz una copia primero.

Límites y seguridad

La escritura reconstruye la estructura: puede perder comentarios, espacios de nombres, detalles de contenido mixto, espacios o el orden original. Se rechazan DTD y entidades externas. Requiere PHP DOM; Minimum solo muestra el archivo completo. Para conservar el texto exacto usa edit o code.

Vista interactiva del sandbox

Ejecuta los ejemplos preparados directamente en la página. Los resultados están predefinidos y se muestran en el navegador; no se ejecuta ningún comando de terminal en el servidor.

Abrir el archivo y reutilizarlo con $

Instalar y administrar

Instala la versión compatible actual. Elige Base para el conjunto completo de funciones o Minimum para el paquete reducido; usa upgrade para actualizar un módulo ya instalado.

Base y Minimum son dos paquetes de la misma versión actual del módulo.

Paquete Base

Instala el paquete completo con referencia local y todos los modos publicados.

install xml
Paquete Minimum

Instalar el paquete reducido. No incluye la referencia local; help <cmd> -i abre la referencia actual del servidor.

install xml -m
Versión pública exacta

Instalar exactamente esta versión publicada.

install xml -v 1.1.6
Comprobar o actualizar

upgrade comprueba la compatibilidad y sustituye el bloque solo cuando hace falta.

upgrade xml
Eliminar módulo

Elimina el bloque de extensión sin tocar el núcleo ni otros módulos.

install xml -u

Ejemplos

Los ejemplos se pueden copiar, pero el sitio no los ejecuta. Revisa rutas, permisos y opciones destructivas.

Abrir el archivo y reutilizarlo con $
xml config/app.xml
config.@env               production
config.application.name   lil-shop
config.application.debug  true
config.database.host      localhost
config.database.port      3306
Mostrar un elemento, atributo (@name) o #text exacto por ruta
xml config/app.xml config.application.name
lil-shop
Mostrar un elemento, atributo (@name) o #text exacto por ruta
xml config/app.xml config.@env
production
Mostrar un elemento, atributo (@name) o #text exacto por ruta
xml config/app.xml config.database.port
3306
Buscar coincidencias en claves o valores; * y ? activan una máscara
xml config/app.xml -f "config.database.*" -k
config.database.host  localhost
config.database.port  3306
Buscar coincidencias en claves o valores; * y ? activan una máscara
xml config/app.xml -f "localhost" -v
config.database.host  localhost
Buscar coincidencias en claves o valores; * y ? activan una máscara
xml config/app.xml -f "debug"
config.application.debug  true
Escribir un valor y normalizar el archivo XML
xml config/app.xml -w config.database.port : 3307
config.database.port  3307
Escribir un valor leído desde otro archivo
xml config/app.xml -w config.application.name < config/from-value.txt
config.application.name  new-shop
Eliminar un valor por ruta con puntos
xml config/app.xml -d config.application.debug
config.@env              production
config.application.name  lil-shop
config.database.host     localhost
config.database.port     3306
Gestionar un archivo ausente
xml config/app.xml -c
Valid XML
Mostrar el texto XML normalizado
xml dump config/app.xml
<?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>
Mostrar un elemento, atributo (@name) o #text exacto por ruta
xml config/app.xml unknown.key
Path not found
Validar el archivo XML
xml config/invalid.xml -c
Invalid XML
Mostrar datos XML
xml config/missing.xml
File not found
Escribir un valor y normalizar el archivo XML
xml config/app.xml -w config.database.port
Value required after : or <
Eliminar un valor por ruta con puntos
xml config/app.xml -d config
XML data must have exactly one root element
Escribir un valor y normalizar el archivo XML
xml config/app.xml -w config.missing.child : 5
Parent path is not a collection

Archivo usado en este ejemplo: sandbox/config/app.xml

El ejemplo usa un archivo o directorio del espacio protegido de documentación /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>

Documentación relacionada

¿Cómo instalo un módulo? →¿Por qué aparece “command not found”? →

Versión pública actual

v1.1.62026-11-01

Refinamiento de producción

Versión estable actual de xml. xml convierte XML en un árbol direccionable: los elementos usan rutas con puntos, los atributos @name y el texto del elemento #text.

# Historial de versiones