Functii DOM XML

Aici gasiti cateva din cele mai comune si utilizate functii PHP DOM pentru XML.
Dupa lista cu functiile, gasiti in subsolul paginii un exemplu cu modul de aplicare a unora din aceste functii, din care puteti intelege cum se folosesc.

- Functii principale, de inceput:

• DOMDocument() - Creaza un obiect in memorie. Optional, poate avea parametri pt. versiunea XML si formatul caracterelor datelor, Ex.: $doc = new DOMDocument('1.0', 'utf-8')
• load("nume_fisier") - Incarca in obiect continutul XML din fisierul "nume_fisier".
• loadXML("sir") - Incarca in obiect continutul XML ce se gaseste in sirul "sir"

- Functii pentru elemente, atribute si continutul lor:

• createElement("nume", "continut") - Creaza un nou element (Nod) cu numele "nume" si optional cu un continut text specificat in "continut". Dupa creare se include in obiect cu "appendChild()".
• createAttribute("nume") - Creaza un atribut cu numele "nume". Dupa creare poate fi inclus in obiect cu "appendChild()" si poate primi o valoare cu "createTextNode()"
• setAttribute('nume', 'valoare') - Seteaza (adauga) un atribut cu numele "nume" si valoarea "valoare". Daca exista deja, il modifica.
• getElementsByTagName("tag") - Preia toate elementele cu numele "tag". Pentru toate elementele, cu toate numele, se specifica "*" in loc de "tag".
• createTextNode('text') - Adauga un continut text la un obiect-nod: element sau atribut din obiect. Dupa creare se include in obiect cu "appendChild()".
• getAttribute("nume") - Obtine valoarea atributului "nume" din obiectul curent.
• removeAttribute("nume") - Sterge atributul "nume" din element.

- Functii pentru sistemul ierarhic:

• appendChild($add) - Adauga in obiect un element-copil (atribut sau alta valoare) creat anterior si a carei instanta e stocata in "$add". Acesta este adaugat dupa continutul sau celelalte Noduri din acel obiect.
• removeChild($nod) - Sterge din obiect elementul a carui instanta e stocata in $nod.
• insertBefore($nod_nou, $nod_ref) - Adauga un copil (nod) nou inaintea unuia specificat ca referinta in "$nod_ref".
• parentNode - Obtine elementul parinte al nodului curent, in care acesta e inclus.
• firstChild - Obtine primul copil al obiectului (Nodului) curent.
• lastChild - Obtine ultimul copil al obiectului (Nodului) curent.
• previousSibling - Obtine nodul imediat dinaintea celui curent, din acelasi parinte.
• nextSibling - Obtine nodul urmator dupa cel curent, din acelasi parinte.

- Functii de verificare:

• validate() - Returneaza TRUE daca documentul e valid, in caz contrar FALSE.
• nodeType - Returneaza un numar ce indica tipul nodului curent, numar asocciat cu urmatoarele tipuri:
  • 1 - XML_ELEMENT_NODE
    2 - XML_ATTRIBUTE_NODE
    3 - XML_TEXT_NODE
    4 - XML_CDATA_SECTION_NODE
    5 - XML_ENTITY_REFERENCE_NODE
    6 - XML_ENTITY_NODE
    7 - XML_PROCESSING_INSTRUCTION_NODE
    8 - XML_COMMENT_NODE
    9 - XML_DOCUMENT_NODE
    10 - XML_DOCUMENT_TYPE_NODE
    11 - XML_DOCUMENT_FRAGMENT_NODE
    12 - XML_NOTATION_NODE
• hasAttribute("nume") - Returneaza TRUE daca atributul "nume" e in obiectul curent, in caz contrar FALSE.
• hasAttributes() - Returneaza TRUE daca obiectul curent are atribute, in caz contrar FALSE.
• hasChildNodes() - Returneaza TRUE daca obiectul curent are elemente copil, in caz contrar FALSE.

- Alte functii de lucru:

• childNodes - Preia intr-un obiect o lista (incepand cu index 0) cu toti copii obiectului curent.
• length - Obtine numarul de elemente (Noduri) dintr-un obiect. Ex.: $obiect->length
• item("nr") - Obtine elementul (Nodul) cu indexul (umar de ordine) "nr" din obiect. Ex., primu Nod: $obiect->item(0)
• nodeName - Numele nodului curent
• nodeValue - Valoarea (continutul) nodului curent.
• textContent - Continutul text din nodul curent.

- Functii care sunt de obicei apelate la sfarsit, dupa ce au fost executate celelalte functii:

• save("nume_fisier") - Salveaza structura de date din obiect in fisier-ul "nume_fisier"
• saveXML() - Transforma (stocheaza) structura de date din obiect intr-un sir. Ca parametru poate primi un Dom-Node si astfel va stoca in sir doar continutul acelui Nod.

Exemplu de aplicare

<?php
// Pentru aceste exemplele se foloseste un document XML stocat sub forma de sir intr-o variabila $xml_doc
$xml_doc = '<?xml version="1.0" encoding="utf-8" ?>
	<root>
	 <element>
	  <sub_element nume="se1">Text unu</sub_element>
	  <sub_element nume="se2">Text doi</sub_element>
	 </element> 
	</root>';

$doc = new DOMDocument();                    // Creaza un nou obiect in memorie
$doc->loadXML($xml_doc);                         // Transforma sirul din $xml_doc intr-un obiect, in cel nou creat

$get_elms = $doc->getElementsByTagName("*");     // Preia toate elementele (nodurile) stocate in obiect

// Afiseaza numarul de elemente (Nodes) preluate
echo $get_elms->length;                               // 4

// Afiseaza numele primului element
echo '<br>'. $get_elms->item(0)->nodeName;                   // root

// Afiseaza valoarea primului copil din elementul (Nodul) patru
echo '<br>'. $get_elms->item(3)->firstChild->nodeValue;      // Text doi

$nods_sube = $doc->getElementsByTagName('sub_element');       // Preia o lista cu elementele (nodurile) 'sub_element'

// Daca al doilea nod din $nods_sube are atributul 'nume', ii afiseaza valoarea
if($nods_sube->item(1)->hasAttributes()) {
  echo '<br>'. $nods_sube->item(1)->getAttribute('nume');          // se2
}

// Seteaza inca un atribut celui deal doilea element din $dods_sube
$nods_sube->item(1)->setAttribute('atr', 'atribut nou');

// Creaza un continut text nou
$text_nou = $doc->createTextNode(" - Text nou."); 

// Adauga textul din $text_nou la al doilea element din $dods_sube, dupa continutul text pe care deja il are
$nods_sube->item(1)->appendChild($text_nou); 

// Afiseaza continutul text al primului element din $nods_sube
echo '<br>'. $nods_sube->item(0)->textContent;                   // Text unu


// Obtine parintele in care sunt elementele (Nodurile) din $nods_sube
$parent_sube = $nods_sube->item(0)->parentNode;

// Sterge primul element din $nods_sube (apeland functia din parintele acestuia)
$parent_sube->removeChild($nods_sube->item(0));

// Adauga sub forma de sir continutul obiectului rezultat dupa aceste prelucrari
$doc_fin = $doc->saveXML();

echo '<br>'. htmlentities($doc_fin);          // Afiseaza sirul, transformand tag-urile pt. a fi vizibile in navigator
?>