Une question de caractères
Outre les éléments et les attributs, la classe XML_Statistics offre deux méthodes permettant de compter les données de caractères contenues dans une instance de document XML. La première est la méthode countDataChunks(), qui calcule le nombre total de blocs CDATA dans le document. Le listing C en montre un exemple.
Comme il existe deux éléments qui renferment du contenu, countDataChunks() signalera deux blocs CDATA. Si vous préférez être encore plus précis, vous pouvez obtenir un décompte du nombre exact de caractères utilisés dans les différents blocs de données de caractères du document grâce à la méthode getCDataLength(). Le listing D illustre cette méthode; voici à quoi devrait ressembler la sortie:
String contains 2 CDATA blocks and 51 characters
Notez que la méthode getCDataLength() ignore les blancs pour effectuer ses calculs.
Outre le comptage des éléments, des blocs CDATA et des attributs, la classe XML_Statistics vous permet également de compter le nombre d'instructions de traitement et d'entités externes d'un fichier XML, respectivement avec les méthodes countPI() et countExternalEntity(). Nous y reviendrons dans le dernier exemple de cet article.
Un autre niveau
La classe XML_Statistics s'accompagne également de deux fonctions utilitaires. La méthode getMaxDepth() mesure la profondeur maximale d'une série d'éléments imbriqués, tandis que la méthode countTagsInDepth() compte toutes les balises à un niveau d'imbrication donné. Le listing E est un exemple de fichier XML que nous analyserons à l'aide de PHP dans le listing F.
Vous pouvez voir dans le listing F que j'ai tout d'abord obtenu la profondeur de l'arbre XML avec la méthode getMaxDepth(), avant d'utiliser une boucle for() et la méthode countTagsInDepth() pour calculer le nombre total d'éléments à chaque niveau. Voici ce à quoi ressemble la sortie:
Maximum depth of XML tree is 3
1 element(s) at level 1
5 element(s) at level 2
4 element(s) at level 3
Assemblage final
Pour finir, le listing G est un exemple composite qui reprend toutes les méthodes décrites ci-dessus. Cet exemple comprend un formulaire dans lequel l'utilisateur peut saisir un chemin. Lors de l'envoi du formulaire, le script examine l'emplacement indiqué pour les fichiers XML, analyse chacun d'eux et présente un rapport quant au contenu de chacun.
Ce script est en fait divisé en deux parties: la première affiche le formulaire et la seconde traite les données du formulaire. Une fois que l'utilisateur a renseigné l'emplacement du répertoire, le script vérifie d'abord que le chemin indiqué est correct, avant d'itérer sur le répertoire pour obtenir une liste des fichiers valides (ceux qui portent l'extension .xml). Chaque fichier est analysé via la méthode analyzeFile() et un rapport est imprimé quant à son contenu. Le processus se poursuit jusqu'à ce que tous les fichiers XML contenus dans le répertoire indiqué aient été analysés. Si l'utilisateur saisit un répertoire incorrect, le script se contente de produire un message d'erreur.
Vous pouvez voir un exemple de la sortie dans la figure A. Au cas où vous demanderiez d'où viennent les lignes "PIs: 0" dans chaque fichier, sachez que la toute première ligne d'un document XML (la déclaration XML) est par nature une instruction de traitement.