4. Document Object Model (DOM ) définition

Propriétés:

• version = la version du document
• encoding = pour l'encodage du texte
• standalone = (boolean)
• type = parmi une liste des types de constantes (voir ...)
• ...

Méthodes:

• root() = rétourne la racine du document
• children() = rétourne un array avec les noeuds enfants
• add_root($node) = ajoute un noeud
• dtd() = rétourne le DTD du document
• dumpmem() = rétourne les données xml en forme du chaîne des charactères

Propriétés:

• name = le nom du noeud
• content = "empty" ou texte pour les noeuds du texte
• type = parmi une liste des types de constantes qui définit le type d'objet qui est le noeud (voir ...)

Méthodes:

• lastchild() = rétourne le dernier enfant du noeud
• children() = rétourne un array avec les enfants du noeud
• parent() = rétourne le parent du noeud
• new_child($name, $content) = ajoute un noeud avec son contenu
• getattr($name) = rétourne les attributs du noeud
• setattr($name, $value) = assignation des attributs à un noeud
• attributes() = rétourne un array avec des objets "DomAttribute"

Exemple 4-1: Extraction des attributs

• http://tecfa.unige.ch/guides/php/examples/xml_with_dom/attribweb.php
• http://tecfa.unige.ch/guides/php/examples/xml_with_dom/attribweb.phps

<?php 

/* This is an example for getting the attribute "id" of a node "para" using the xmldocfile - function. */

$doc = xmldocfile("test.xml") or die("*** There is no such file ***");

$node = $doc->children(); 

$node = $node[0]->children(); 

$attr = $node[1]->attributes(); 

printf("%s=%s", $attr[0]->name, $attr[0]->children[0]->content); 

?>

Exemple 4-2: (complet) Extraction des travaux staf14 d'un étudiant staf-g

• http://tecfa.unige.ch/guides/php/examples/xml_with_dom/extract_travaux.php
• http://tecfa.unige.ch/guides/php/examples/xml_with_dom/extract_travaux.phps
• http://tecfa.unige.ch/guides/php/examples/xml_with_dom/travaux.xml
• http://tecfa.unige.ch/guides/php/examples/xml_with_dom/travaux.dtd

# iterate through an array of nodes

# looking for a text node

# return its content

function get_content($parent)

{

    $nodes = $parent->children();

    while($node = array_shift($nodes)) {

        if ($node->type == XML_TEXT_NODE)

            return $node->content;

    }    

    return ""; }

# get the content of a particular node

function find_content($parent,$name)

{

    $nodes = $parent->children();

    while($node = array_shift($nodes)) {

        if ($node->name == $name)

            return get_content($node);

    }

    return ""; }

# get an attribute from a particular node

function find_attr($parent,$name,$attr)

{

    $nodes = $parent->children();

    while($node = array_shift($nodes))

        if ($node->name == $name)

            return $node->getattr($attr);

    return "";

}

# load xml doc

$doc = xmldocfile("travaux.xml") or die("*** There is no such file ***");

# get root Node (student)

$root = $doc->root();

# get an array of students' children

$student_children = $root->children();

# go through the array of students' children

   while($curr_node = array_shift($student_children)) {

    # if you find "personal-data" extract several info    

        if ($curr_node->name == "personal-data") {

        # get some data from personal-data

        $first_name = find_content($curr_node,"first-name");

        $family_name = find_content($curr_node,"family-name");

        $email = find_content($curr_node,"email");

        echo "<h2><a href='mailto:$email'>".$first_name." ".$family_name."</a></h2>\n";

    }

    # if you find "exercises" extract some info

        if ($curr_node->name == "exercises") {

        $exercises = $curr_node->children();

        while($exercise = array_shift($exercises)) {

                if ($exercise->type == XML_TEXT_NODE)

                    continue;

            # get some data from each exercise

            $staf = find_attr($exercise,"staf","no");

            $no = find_attr($exercise,"staf","ex-number");    

            $title = find_content($exercise,"title");

            $url = find_content($exercise,"url");

            if ($staf == "14") {

                echo "<b>Staf14-ex".$no.": </b> <a href='".$url."'>".$title."</a><br>\n";

            }

        }

    }

}