xml

xml transforme XML en arbre adressable : chemins pointés pour les éléments, @name pour les attributs et #text pour le texte d’un élément.

DonnéesVersion 1.1.6Stable
lil-terminal

Vue d’ensemble

xml applique le même flux ciblé aux fichiers XML : lecture des chemins d’éléments et d’attributs, recherche, modification atomique d’un nœud, validation du document et affichage du XML normalisé complet.

Éléments, attributs et texte sont des nœuds distincts

config.@env et config.application.name ciblent des nœuds XML différents. La syntaxe compacte convient aux XML simples sans remplacer XPath ni un éditeur XML complet ; PHP DOM est requis.

Syntaxe

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

Référence

xml <file>

afficher les données XML

xml <file> <key>

afficher un élément, attribut (@name) ou #text exact par chemin

xml dump <file>

afficher le texte source XML normalisé

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

rechercher dans les clés ou valeurs ; * et ? activent un masque

-w <key> : <value>

écrire une valeur et normaliser le fichier XML

-w <key> < <file>

écrire une valeur lue depuis un autre fichier

-d <key>

supprimer une valeur par chemin pointé

-c

valider le fichier XML

Mode d’emploi

Commencez par xml config/app.xml pour voir les chemins, puis ajoutez un chemin à points pour lire une valeur. -f cherche dans les chemins et valeurs, -k uniquement dans les clés et -v dans les valeurs. -c valide et dump affiche le XML reconstruit. Dans Base, -w <key> : <value> modifie, < <file> lit une autre source et -d <key> supprime un nœud. Sauvegardez avant.

Limites et sécurité

La réécriture peut perdre les commentaires, espaces de noms, détails de contenu mixte, espaces et ordre d’origine. DTD et entités externes sont refusés. L’extension PHP DOM est requise; Minimum affiche seulement le fichier entier. Utilisez edit ou code pour préserver la source.

Aperçu interactif du sandbox

Lancez les exemples préparés directement sur la page. Les résultats sont prédéfinis et affichés dans le navigateur ; aucune commande terminal n’est exécutée sur le serveur.

Ouvrir le fichier et le réutiliser avec $

Installer et gérer

Installez la version compatible actuelle. Choisissez Base pour l’ensemble complet des fonctions ou Minimum pour le paquet réduit ; utilisez upgrade pour mettre à jour un module déjà installé.

Base et Minimum sont deux paquets de la même version actuelle du module.

Paquet Base

Installer le paquet complet avec référence locale et tous les modes publiés.

install xml
Paquet Minimum

Installer le paquet réduit. La référence locale est omise ; help <cmd> -i ouvre la référence serveur actuelle.

install xml -m
Version publique exacte

Installer exactement cette version publiée.

install xml -v 1.1.6
Vérifier ou mettre à jour

upgrade vérifie la compatibilité et remplace le bloc seulement si nécessaire.

upgrade xml
Supprimer le module

Supprimer le bloc d’extension sans toucher au noyau ni aux autres modules.

install xml -u

Exemples

Les exemples sont copiables mais ne sont pas exécutés par le site. Vérifiez chemins, droits et options destructrices.

Ouvrir le fichier et le réutiliser avec $
xml config/app.xml
config.@env               production
config.application.name   lil-shop
config.application.debug  true
config.database.host      localhost
config.database.port      3306
Afficher un élément, attribut (@name) ou #text exact par chemin
xml config/app.xml config.application.name
lil-shop
Afficher un élément, attribut (@name) ou #text exact par chemin
xml config/app.xml config.@env
production
Afficher un élément, attribut (@name) ou #text exact par chemin
xml config/app.xml config.database.port
3306
Rechercher dans les clés ou valeurs ; * et ? activent un masque
xml config/app.xml -f "config.database.*" -k
config.database.host  localhost
config.database.port  3306
Rechercher dans les clés ou valeurs ; * et ? activent un masque
xml config/app.xml -f "localhost" -v
config.database.host  localhost
Rechercher dans les clés ou valeurs ; * et ? activent un masque
xml config/app.xml -f "debug"
config.application.debug  true
Écrire une valeur et normaliser le fichier XML
xml config/app.xml -w config.database.port : 3307
config.database.port  3307
Écrire une valeur lue depuis un autre fichier
xml config/app.xml -w config.application.name < config/from-value.txt
config.application.name  new-shop
Supprimer une valeur par chemin pointé
xml config/app.xml -d config.application.debug
config.@env              production
config.application.name  lil-shop
config.database.host     localhost
config.database.port     3306
Gérer un fichier absent
xml config/app.xml -c
Valid XML
Afficher le texte source XML normalisé
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>
Afficher un élément, attribut (@name) ou #text exact par chemin
xml config/app.xml unknown.key
Path not found
Valider le fichier XML
xml config/invalid.xml -c
Invalid XML
Afficher les données XML
xml config/missing.xml
File not found
Écrire une valeur et normaliser le fichier XML
xml config/app.xml -w config.database.port
Value required after : or <
Supprimer une valeur par chemin pointé
xml config/app.xml -d config
XML data must have exactly one root element
Écrire une valeur et normaliser le fichier XML
xml config/app.xml -w config.missing.child : 5
Parent path is not a collection

Fichier utilisé dans cet exemple: sandbox/config/app.xml

L’exemple utilise un fichier ou un répertoire de l’espace de documentation protégé /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>

Documentation associée

Comment installer un module ? →Pourquoi une commande répond-elle « command not found » ? →

Version publique actuelle

v1.1.62026-11-01

Affinage de production

Version stable actuelle de xml. xml transforme XML en arbre adressable : chemins pointés pour les éléments, @name pour les attributs et #text pour le texte d’un élément.

# Historique des versions