Comment Ca Marche - Communauté informatique  
   
Accueil - Encyclopédie informatiqueTélécharger l'encyclopédieContribuer à cet article

PHP - Parser du XML

Parser un document XML avec PHP Encyclopédie


Introduction à XML

PHP permet l'analyse syntaxique (parsage ou parsing en anglais) d'un document XML.
Le langage XML (eXtensible Markup Language, traduisez Langage à balises extensibles) est un métalangage, c'est-à-dire un langage permettant de définir votre propre langage. Ainsi contrairement au langage HTML, le langage XML permet d'aller définir vos propres balises, ce qui permet de séparer la présentation du document de son contenu.

Cette séparation entre le contenu et la présentation se fait à l'aide d'un analyseur syntaxique (parseur), c'est-à-dire un programme capable de vérifier la cohérence de la syntaxe du document et de l'interpréter afin de mettre en page son contenu. PHP propose une extension permettant de mettre au point facilement des analyseurs XML. Cette extension utilise la librairie expat disponible à http://www.jclark.com/xml/.

Installer l'extension XML

L'extension XML de PHP supporte la librairie expat disponible à http://www.jclark.com/xml/.
Sur les serveurs Apache récents (de version supérieure à la 1.3.7) la librairie expat est installée en standard. sur les serveurs apache de version antérieure à la 1.3.7 il suffit de télécharger cette librairie :

Pour activer le support de cette librairie lors de l'installation de PHP il suffit de lancer la configuration de PHP avec l'option --with-xml.

Pour vérifier que votre installation supporte bien la librairie expat, il vous suffit de créer un fichier phpinfo.php3 contenant uniquement les lignes suivantes

<?
phpinfo();

?>

Fonctionnement de l'extension XML

Les analyseurs XML sont également divisés selon l'approche qu'ils utilisent pour traiter le document. On distingue actuellement deux types d'approches :

  • Les API utilisant une approche hiérarchique : les analyseurs utilisant cette technique construisent une structure hiérarchique contenant des objets représentant les éléments du document, et dont les méthodes permettent d'acCèder aux propriétés. La principale API utilisant cette approche est DOM (Document Object Model)
  • Les API basés sur un mode événementiel permettent de réagir à des événements (comme le début d'un élément, la fin d'un élément) et de renvoyer le résultat à l'application utilisant cette API. SAX (Simple API for XML est la principale interface utilisant l'aspect événementiel Ainsi, on tend à associer l'approche hiérarchique avec DOM et l'approche événementielle avec SAX.

Considérons le document XML suivant :

<debut>

	Bienvenue sur CCM - http://www.commentcamarche.net
</debut>

Avec un parseur XML utilisant une approche événementielle, les 3 événements suivants seraient générés :

  • Start Element : debut
  • Start CDATA section, value : Bienvenue sur CCM - http://www.commentcamarche.net
  • Close Element : debut

L'extension XML fonctionne selon un mode événementiel, c'est-à-dire qu'elle définit des fonctions permettant de réagir aux divers événements :

  • La fonction xml_set_element_handler() permet d'associer une action au début, à la fin d'un élément ou bien au contenu d'un attribut
  • La fonction xml_set_character_data_handler() permet d'associer un événement au contenu textuel des balises
  • La fonction xml_set_processing_instruction_handler() permet d'associer une action à la rencontre d'une instruction de traitement
  • La fonction xml_set_notation_decl_handler() associe un traitement à la détection d'une instruction de traitement
  • La fonction xml_set_external_entity_ref() permet de détecter un appel à une entité externe

Création de l'analyseur XML

La première étape consiste à créer un analyseur XML (ou plus exactement pour utiliser une instance de parseur XML) grâce à la fonction xml_create_parser() $xml_parseur = xml_parser_create(); Une fois le parseur créé, il s'agit de lui associer des événements, c'est-à-dire qu'il s'agit de créer des fonctions qui seront appelées par le parseur en cas de déclenchement d'un événement.
L'extension XML (expat) définit 7 types d'événements et leurs gestionnaires (handlers) associés :
Evénement Gestionnaire associé Description
Elements xml_set_element_handler() ce gestionnaire gère les ouvertures et fermetures de balises
Character Data xml_set_character_data_handler() Ce handler permet d'associer une fonction aux données textuelles (hors des balises)
External Entities xml_set_external_entity_ref_handler() Ce gestionnaire intercepte les appels à des entités externes
Unparsed external entities xml_set_unparsed_entity_decl_handler() Affecte les gestionnaires d'entités non déclarées de l'analyseur XML
Processing instructions xml_set_processing_instruction_handler() Permet d'intercepter l'occurrence d'une instructrion de traitement (PI, processing instruction)
Notation declarations xml_set_notation_decl_handler() Gère les occurences de déclarations de notation
default xml_set_default_handler() Permet de gérer tous les événements pour lesquels aucun gestionnaire n'a été défini

Toutes ces fonctions de gestion des événements prennent comme premier argument l'instance du parseur qui a été renvoyée par la fonction xml_create_handler().

Prenons l'exemple de la fonction xml_set_element_handler(). Cette fonction nécessite trois arguments :

  • L'instance du parseur
  • Le nom de la fonction qui gère les balises ouvrantes
  • Le nom de la fonction qui gère les balises fermantes
Les fonctions de gestion des événements définies par l'utilisateur doivent exister avant de commencer à parser le document. De plus leurs définitions doivent concorder exactement avec le prototype défini dans le manuel PHP (http://www.php.net).

Par exemple la fonction chargée de gérer l'événement "balise ouvrante" doit comporter trois paramètres :

function ouverture ($parser, $name, $attrs){
 echo "$name<BR>";

}
Son nom et le nom de ses attributs peuvent être modifiés mais le nombre de ses arguments et leur ordre doit être conforme au manuel PHP. Dans le cas de la fonction associée à l'ouverture de balise, le premier argument est l'identifiant de l'instance du parseur, le second est le nom de la balise rencontrée (pour une balise <Debut> sa valeur sera "Debut") et le troisième est un tableau associatif contenant tous les noms des attributs de cet élément et leur valeur.

Voici certains gestionnaires d'événement que nous allons définir

  • la fermeture d'une balise XML :
    function fermeture ($parser, $name){
     echo "$name<BR>";
    
    }

    Le prototype est le même que pour le gestionnaire d'événement associé aux balises ouvrantes
  • du texte est trouvé hors des balises :
    function texte ($parser, $data_text){
     return $data_text;
    
    }

    Dans cette fonction le deuxième argument est le texte retourné par le gestionnaire d'événement

  • une fonction par défaut :
    function defaut (){
     return TRUE;
    
    }
Il suffit ensuite d'utiliser les fonctions XML fournies par PHP (appelés gestionnaires d'événement ou en anglais event handler) pour associer les fonctions que vous avez définies à des événements XML :
  • La fonction xml_set_element_handler() permet de définir les fonctions associées à l'ouverture et à la fermeture d'une balise XML (dans notre cas il s'agit des fonctions ouverture() et fermeture()) :
    xml_set_element_handler($xml_parseur, "ouverture", "fermeture");
  • La fonction xml_set_character_data_handler() définit la fonction associée à la rencontre de texte en dehors ou entre les balises XML :
    xml_set_character_data_handler($xml_parseur, "texte");
  • La fonction xml_set_default_handler() permet d'associer une fonction par défaut aux événements non traités
    xml_set_default_handler($xml_parseur,"defaut");

La fonction xml_parser_set_option() permet de définir des options de parsage. Le premier argument est bien évidemment l'instance du parseur. Le second argument peut prendre deux valeurs (0 ou 1, représenté par la constante XML_OPTION_CASE_FOLDING) : cette option est activée par défaut. Le fait de désactiver cette option force le gestionnaire d'événement à transformer les noms des balises en majuscule (il est essentiel de ne pas la désactiver car le XML est sensible à la casse, c'est-à-dire qu'il différencie minuscules et majuscules). Le troisième argument définit quel encodage utiliser dans le parseur XML (ISO-8859-1, US-ASCII ou UTF-8). Par défaut l'encodage est celui de xml_parser_create())

xml_parser_set_option($xml_parseur, XML_OPTION_CASE_FOLDING);

Pour parser un fichier XML, il suffit de l'ouvrir en lecture, puis de faire appel à la fonction xml_parse() :

$fp = fopen("essai.xml", "r") or die("
Fichier introuvable. L'analyse a ete suspendue"); while ($fdata = fread($fp, 2048)){ xml_parse($xml_parseur, $fdata, feof($fp)) or die( sprintf("Erreur XML : %s à la ligne %d\n", xml_error_string(xml_get_error_code($xml_parseur)), xml_get_current_line_number($xml_parseur)) ); }

Si le document XML n'est pas bien formé la fonction xml_parse() renvoie la valeur false

Les fonctions xml_error_string() et xml_get_current_line_number() permettent, en cas d'erreur, d'afficher l'erreur qui a été générée ainsi que le numéro de la ligne du fichier XML où elle se trouve !

Appel à des entités externes

Comme chacun devrait le savoir, il est possible avec XML de faire appel à des entités externes, c'est-à-dire importer des éléments XML stockés dans un autre fichier. Ainsi il est essentiel lors du parsage d'un fichier XML d'incorporer le document externe au document XML principal.
Cela est possible grâce au gestionnaire d'entité externe permettant d'appeler une fonction à chaque fois qu'une balise du type suivant est rencontrée dans le document XML :

<!ENTITY systemEntity SYSTEM "externe.xml">
<?
// Fichier à analyser
$file = "data.xml";

// variable de la profondeur du parcours de l'arbre
$depth = array();

// Etat de la pile de parcours du document XML
$stack = array();

// Valeur d'un dernier élément lu
$globaldata ="";

// Fonction associée à l’événement début d’élément
function startElement($parser, $name, $attrs)
{

global $depth;

global $stack;

for ($i = 0; $i < $depth[$parser]; $i++)
{print " ";}
array_push($stack,$name);

$depth[$parser]++;

print "Début de l'élément : ".$name."\n -- ";

print "profondeur : ".$depth[$parser]." -- Attributs de l'élément : ";

//affichage des attributs de l'élément
while (list ($key, $val) = each ($attrs))
{echo "$key => $val";}
print " ";

}

// Fonction associée à l’événement fin d’élément
function endElement($parser, $name)
{

global $depth;

global $stack;

global $globaldata;

for ($i = 0; $i < $depth[$parser]-1; $i++)
{print " ";}
print "Fin de l'élément : ".$name." avec la valeur :".$globaldata." -- ";

print "profondeur : ".$depth[$parser]." ";

$depth[$parser]--;

array_pop($stack);

}

// Fonction associée à l’événement données textuelles
function characterData($parser, $data)
{

global $globaldata;

$globaldata = $data;

}

// Fonction associée à l’événement de détection d'un appel d'entité externe
function externalEntityRefHandler($parser,
								  $openEntityNames,
								  $base,
								  $systemId,
								  $publicId)
{

if ($systemId)
{ if (!list($parser, $fp) = new_xml_parser($systemId))
{

printf("Impossible d'ouvrir %s à %s\n",
				   $openEntityNames,
				   $systemId);
return FALSE;

}

while ($data = fread($fp, 4096))
{

if (!xml_parse($parser, $data, feof($fp)))
{

printf("Erreur XML : %s à la ligne %d lors du traitement de l'entité %s\n",
			   xml_error_string(xml_get_error_code($parser)),
			   xml_get_current_line_number($parser),
			   $openEntityNames);

xml_parser_free($parser);

return FALSE;

}

}

xml_parser_free($parser);

return TRUE; } return FALSE;

}

// Fonction de création du parser et d'affectation
// des fonctions aux gestionnaires d'événements
function new_xml_parser($file)
{

global $parser_file;

//création du parseur
$xml_parser = xml_parser_create();

//Activation du respect de la casse du nom des éléments XML
xml_parser_set_option($xml_parser, XML_OPTION_CASE_FOLDING, 1);

//Déclaration des fonctions à rattacher au gestionnaire d'événement
xml_set_element_handler($xml_parser, "startElement", "endElement");
xml_set_character_data_handler($xml_parser, "characterData");
xml_set_external_entity_ref_handler($xml_parser, "externalEntityRefHandler");

//Ouverture du fichier
if (!($fp = @fopen($file, "r"))) { return FALSE; }
//Transformation du parseur en un tableau
if (!is_array($parser_file))
{ settype($parser_file, "array"); }
$parser_file[$xml_parser] = $file;

return array($xml_parser, $fp);

}

// Appel à la fonction de création et d'initialisation du parseur
if (!(list($xml_parser, $fp) = new_xml_parser($file)))
{ die("Impossible d'ouvrir le document XML"); }
// Traitement de la ressource XML
while ($data = fread($fp, 4096))
{

if (!xml_parse($xml_parser, $data, feof($fp)))
   { die(sprintf("Erreur XML : %s à la ligne %d\n",
			  xml_error_string(xml_get_error_code($xml_parser)),
			  xml_get_current_line_number($xml_parser)));
   }
}

// Libération de la ressource associée au parser
xml_parser_free($xml_parser);

?>

Article écrit par Jean-François Pillou

Trucs & astuces pertinents trouvés dans la base de connaissances

01/01 03h06 Notice: Undefined index: (Langages)
29/12 16h39 Afficher facilement le code php/xhtml de vos pages (Webmaster)
28/12 00h03 Récupérer login et mot de passe passés par un .htaccess (PHP)
08/12 22h42 Les ressemblances à ne pas confondre (PHP)
02/12 16h02 Vérifier une adresse électronique (format du mail) (PHP)
22/11 23h51 Rediriger sur une autre page (redirection) (PHP)
18/11 01h10 Fonction mail() (PHP)
11/11 01h39 Coloration syntaxique dans vos pages web (Webmaster)
27/10 00h14 Transformer une URL en lien hypertexte cliquable (PHP)
22/09 18h56 Connexion à une base Oracle en php (Oracle)
PHP XML Plus d'astuces sur « PHP XML »

Discussions pertinentes trouvées dans le forum

17/11 21h46 php xml PHP et XML Webmastering 14/02 16h03->pyranhaz2
23/03 23h22 php xml templates [PHP&XML] Templates & ... Webmastering 16/01 00h40->Chouaibi7
10/04 11h56 découper fichier xml script php découper fichier xml avec script php Webmastering 10/04 15h13->dargos5
22/04 16h28 parser xml php Parser XML avec PHP Webmastering 23/04 12h25->@cid4
11/08 02h47 php xml [PHP , XML] Webmastering 11/08 10h39->Chris4
12/06 23h59 écrire fichier xml php écrire dans un fichier xml avec php Webmastering 13/06 15h58->musashii3
01/03 22h31 php mysql xml php/mysql/xml Développement 27/03 10h19->Zep3k!GnO3
05/10 16h43 php xml externe xsl php+xml externe+xsl Webmastering 06/10 17h57->dudu2
03/07 10h17 php génération fichier xml php [php] pb génération fichier xml avec php Développement 03/07 13h01->peppena2
16/09 00h03 php traitement fichiers xml. Php et traitement de fichiers xml. Webmastering 20/07 18h01->Firebush2
Discussion fermée Problème résolu PHP XML Plus de discussions sur « PHP XML »

Ce document intitulé « PHP - Parser du XML » issu de l'encyclopédie informatique Comment Ça Marche (www.commentcamarche.net) est mis à disposition sous les termes de la licence Creative Commons. Vous pouvez copier, modifier des copies de cette page, dans les conditions fixées par la licence, tant que cette note apparaît clairement.