Procesarea fisierelor XML in obiecte si lucrul cu acestea – PHP

Update : 11 decembrie 2009
Am promis o serie de articole destul de interesante dupa parerea mea. Acesta este al treilea articol din aceasta serie care il voi publica in urmatoarea perioada. Am inceput sa lucrez la ultima versiune si cea publica a sistemului de securitate ce va include si analiza fisierelor , anti RCE/CSRF dar pastrez linistea pana una alta.Anumite parti ce mi se par interesante le voi publica si le voi explica, pentru ca sunt sigur ca vor prezenta interes unora in viitor.

Ok , sa revenim. Pentru inceput , vom considera ca sunteti familiarizati cu XML si tot ce tine de acesta.In PHP nu prea exista functii care sa creeze obiecte usor de folosit pentru a returna valorilor,argumentele pastrate in acestea.

Clasa creata de mine suporta aproximativ toate operatiile de baza ce pot fi efectuate asupra unui fisier XML.Aceasta are ca dependenta majora clasa cException, studiata si prezentata in urma cu cateva zile pe blog.

Structura clasei :

  /**
 * @name        : xmlParser
 * @description : The XML Parser Class. Parse regular xml file content into array where ___value___ key represents
                      a node value and ___atrr___ key represents the attribute of specific node.
                      This class use cException class for exceptions handling.
 * @author      : Avadanei Andrei
 * @copyright   : 2009 - Avadanei Andrei
 **/
  class xmlParser
  {
      private $xmlObject        = array();         /* The Parsed XML Object */
      private $xmlContent      = "";                 /* The XML File Content   */
      private $xmlLength       = 0;                  /* The XML File Length     */

      public function xmlParser($xmlContent,$xmlLength);
      public function __construct($xmlContent,$xmlLength);
      public function getNodeXML($tree = '');
      public function addNodeXML($tree = '',$xmlNewNode = '', $addXML = '',$addID=-1);
      public function editNodeXML($tree = '',$editXML = '',$editID = -1);
      public function validateObject($object);
      public function removeNodeXML($tree = '',$editID = -1);
      public function ObjectToXML($returnXML = TRUE);
      private function buildObjectToXML($nodes,$push = '');
      public function XMLToObject($returnXML = TRUE);
  }

Observam ca avem posibilitatea de a parsa un fisier XML(continutul acestuia) intr-un obiect XML. De asemenea clasa suporta si operatia inversa. Avem posibilitatea de a elimina un nod si toate subnodurile sale,precum si de a edita sau adauga un nod nou(un string sau un obiect in cazul in care dorim sa adaugam un „sub-obiect”).Avem posibilitatea de a valida un nod si toate subnodurile sale pentru a verifica daca este corect din punct de vedere obiectual fata de structura aleasa de mine.Operatiile asupra atributelor le-am omis,asta putandu-se face manual. Daca voi vedea macar 2-3 persoane dornice sa updatez clasa o voi face.

Structura obiectului XML :

  [nod]
    array(
           [___attr___] array([atribut 1],[attribut 2] ... [attribut n]);
           [subnod] array([___value___],[___attr___]);
           [subnod]
           .......
           [subnod]
         );

Un nod ce are elementul [___value___] nu poate avea subnoduri, insa unul ce are elementul [___attr___] poate avea subnoduri.Toate subnodurile au „structura” nodului dat in exemplul de mai sus.De asemenea elementele [___value___] si [___attr___] pot lipsi din structura obiectului XML la un anumit nod.

Exemple de folosire :

<?php
include('xmlParser.php');
 $xml  = '<?xml version="1.0" encoding="ISO-8859-1"?>
<!-- Edited by XMLSpy® -->
<note>
 <to atttr="test" ab="adsgds"><attr>ss</attr><test>Tove</test></to>
 <from>Jaani</from>
 <from>Jaani2</from>
 <heading>Reminder</heading>

</note>

';
$xmlL = strlen($xml);
$xmlParser = new xmlParser($xml,$xmlL);
$siteXML         = $xmlParser->XMLToObject(TRUE);
echo $xmlParser->validateObject($siteXML);
print_r($siteXML);
$xmlParser->removeNodeXML('note/to/attr/');
echo $xmlParser->ObjectToXML(TRUE);
$xmlParser->addNodeXML('note/to/','attr',array('___value___'=>'valoareeee2'));
$xmlParser->editNodeXML('note/from/',array('___value___'=>'valoareeee2'),0);
echo $xmlParser->ObjectToXML(TRUE);
?>

Puteti descarca clasa de mai jos cu exemplele de mai sus , toate functiile avand explicatii complete despre modul in care ar trebui folosite functiile. Atasamentul de mai jos, in cazul exemplelor are inclusa si clasa cException.
Descarca Clasa xmlParser si exemple de folosire

Update

Au fost aduse imbunatatiri acestei clase.Cea mai importanta modificarea a fost posibilitatea de acum incolo de a lucra cu noduri cu acelasi nume.Au fost aduse si alte imbunatatiri minore si au fost fixate cateva bug-uri.Noua versiune o puteti descarca de la aceeasi adresa de mai sus.De asemenea functiile addNodeXML(),editNodeXML() si removeNodeXML() si-au modificat parametrii.Ii puteti vedea mai sus. 🙂