xml.php

   1 <?php
   2 /*=====================================================================*\
   3 || ###################################################################
   4 || # Blue Static ISSO Framework
   5 || # Copyright ©2002-[#]year[#] Blue Static
   6 || #
   7 || # This program is free software; you can redistribute it and/or modify
   8 || # it under the terms of the GNU General Public License as published by
   9 || # the Free Software Foundation; version [#]gpl[#] of the License.
  10 || #
  11 || # This program is distributed in the hope that it will be useful, but
  12 || # WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  13 || # or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
  14 || # more details.
  15 || #
  16 || # You should have received a copy of the GNU General Public License along
  17 || # with this program; if not, write to the Free Software Foundation, Inc.,
  18 || # 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
  19 || ###################################################################
  20 \*=====================================================================*/
  21
  22 /**
  23 * XML Parser
  24 * xml.php
  25 *
  26 * @package      ISSO
  27 */
  28
  29 /**
  30 * XML Parser
  31 *
  32 * This framework is a wrapper for a robust XML parser.
  33 *
  34 * @author               Blue Static
  35 * @copyright    Copyright ©2002 - [#]year[#], Blue Static
  36 * @version              $Revision$
  37 * @package              ISSO
  38 *
  39 */
  40 class XML
  41 {
  42         /**
  43         * Framework registry object
  44         * @var  object
  45         * @access       private
  46         */
  47         var $registry = null;
  48
  49         /**
  50         * Parser resource
  51         * @var  integer
  52         * @access       private
  53         */
  54         var $parser = null;
  55
  56         /**
  57         * An array of function names that are to be executed for each tag name (name => function)
  58         * @var  array()
  59         * @access       private
  60         */
  61         var $taghandler = array();
  62
  63         /**
  64         * Current CDATA value
  65         * @var  string
  66         * @access       private
  67         */
  68         var $cdata = '';
  69
  70         /**
  71         * Tag stack of all open nodes
  72         * @var  array
  73         * @access       private
  74         */
  75         var $stack = array();
  76
  77         /**
  78         * Node list for all open tag attributes
  79         * @var  array
  80         * @access       private
  81         */
  82         var $attribs = array();
  83
  84         /**
  85         * Resulting parsed array
  86         * @var  array
  87         * @access       private
  88         */
  89         var $result = array();
  90
  91         // ###################################################################
  92         /**
  93         * Constructor
  94         */
  95         function __construct(&$registry)
  96         {
  97                 $this->registry =& $registry;
  98         }
  99
 100         // ###################################################################
 101         /**
 102         * (PHP 4) Constructor
 103         */
 104         function XML(&$registry)
 105         {
 106                 $this->__construct($registry);
 107         }
 108
 109         // ###################################################################
 110         /**
 111         * Parse an XML file
 112         *
 113         * @access       public
 114         *
 115         * @param        string  XML file data
 116         * @param        string  Parse file as UTF-8 instead of ISSO-8859-1
 117         *
 118         * @return       array   Array with all the XML data parsed
 119         */
 120         function parse($data, $utf8 = false)
 121         {
 122                 $this->registry->check_isso_fields(get_class($this));
 123
 124                 $this->stack = array();
 125                 $this->attribs = array();
 126                 $this->result = array();
 127                 $this->cdata = '';
 128
 129                 if ($utf8)
 130                 {
 131                         $data = utf8_encode($data);
 132                         $this->parser = xml_parser_create('UTF-8');
 133                 }
 134                 else
 135                 {
 136                         $this->parser = xml_parser_create('ISO-8859-1');
 137                 }
 138
 139                 // create a new parser
 140                 xml_set_object($this->parser, $this);
 141                 xml_parser_set_option($this->parser, XML_OPTION_CASE_FOLDING, 0);
 142                 xml_set_element_handler($this->parser, 'handle_tag_start', 'handle_tag_end');
 143                 xml_set_character_data_handler($this->parser, 'handle_cdata');
 144
 145                 $this->attach_node($this->result);
 146
 147                 // parse the data and check for errors
 148                 if (!xml_parse($this->parser, $data))
 149                 {
 150                         $error['code'] = xml_get_error_code($this->parser);
 151                         $error['string'] = xml_error_string($error['code']);
 152                         $error['line'] = xml_get_current_line_number($this->parser);
 153                         $error['column'] = xml_get_current_column_number($this->parser);
 154                         trigger_error("XML Error: $error[string] at line $error[line] colunn $error[column]", E_USER_ERROR);
 155                         exit;
 156                 }
 157
 158                 // destroy the parser
 159                 xml_parser_free($this->parser);
 160
 161                 // done... send the results back
 162                 return $this->result;
 163         }
 164
 165         // ###################################################################
 166         /**
 167         * Process the opening location of an XML tag
 168         *
 169         * @access       private
 170         *
 171         * @param        integer XML parser
 172         * @param        string  Tag name
 173         * @param        array   Tag attributes
 174         */
 175         function handle_tag_start(&$parser, $name, $attrs)
 176         {
 177                 // we need to keep track of indicies to monitor the last key in $this->attribs
 178                 static $index;
 179
 180                 // trim attributes
 181                 array_walk($attrs, 'trim');
 182
 183                 // existing node set
 184                 if (isset($this->attribs["$name"]))
 185                 {
 186                         // node set has < 1 child nodes
 187                         if (!isset($this->attribs["$name"][0]))
 188                         {
 189                                 $tmp = $this->attribs["$name"];
 190                                 unset($this->attribs["$name"]);
 191                                 $this->attribs["$name"][0] = $tmp;
 192                         }
 193
 194                         // create a new child node
 195                         $this->attribs["$name"][ $index["$name"] ] = (array)$attrs;
 196                         $this->attach_node($this->attribs["$name"][ $index["$name"] ]);
 197                         $index["$name"]++;
 198                 }
 199                 // node set doesn't exist, so create it
 200                 else
 201                 {
 202                         $this->attribs["$name"] = (array)$attrs;
 203                         $this->attach_node($this->attribs["$name"]);
 204                         $index["$name"] = 1;
 205                 }
 206         }
 207
 208         // ###################################################################
 209         /**
 210         * Process XML CDATA
 211         *
 212         * @access       private
 213         *
 214         * @param        integer XML parser
 215         * @param        string  CDATA from tag
 216         */
 217         function handle_cdata(&$parser, $data)
 218         {
 219                 $this->cdata .= $data;
 220         }
 221
 222         // ###################################################################
 223         /**
 224         * Process the closing of an XML tag
 225         *
 226         * @access       private
 227         *
 228         * @param        integer XML parser
 229         * @param        string  Tag name
 230         */
 231         function handle_tag_end(&$parser, $name)
 232         {
 233                 // attach data to the node
 234                 if (($this->cdata = trim($this->cdata)) != '')
 235                 {
 236                         $this->attribs['value'] = $this->cdata;
 237                 }
 238
 239                 $this->cdata = '';
 240
 241                 // remove the node
 242                 $this->detach_node();
 243         }
 244
 245         // ###################################################################
 246         /**
 247         * Shifts the node tree
 248         *
 249         * @access       private
 250         *
 251         * @param        array   Node to place into the stack
 252         */
 253         function attach_node(&$node)
 254         {
 255                 // create a new node
 256                 $this->stack[ sizeof($this->stack) ] =& $node;
 257
 258                 // new attributes to work with
 259                 $this->attribs =& $node;
 260         }
 261
 262         // ###################################################################
 263         /**
 264         * Unshifts the node tree
 265         *
 266         * @access       private
 267         */
 268         function detach_node()
 269         {
 270                 // drop the newest node
 271                 unset($this->stack[ sizeof($this->stack) - 1 ]);
 272
 273                 // assign the attributes to the next newest node
 274                 $this->attribs =& $this->stack[ sizeof($this->stack) - 1 ];
 275         }
 276
 277         // ###################################################################
 278         /**
 279         * Unless a node has multiple children, there will not be a numerical
 280         * index for the child node. So this means that if you have variable
 281         * XML structure with some of the same types of nodes having one children
 282         * or multiple children, you'd have different things to parse. If
 283         * you want the node unified (as in, all single-children would be indexed
 284         * numerically, run this function on the node. It works on references.
 285         *
 286         * @access        public
 287         *
 288         * @param        array   The node to int-index
 289         */
 290         function unify_node(&$node)
 291         {
 292                 if (!isset($node[0]))
 293                 {
 294                         $node = array($node);
 295                 }
 296         }
 297 }
 298
 299 /*=====================================================================*\
 300 || ###################################################################
 301 || # $HeadURL$
 302 || # $Id$
 303 || ###################################################################
 304 \*=====================================================================*/
 305 ?>