]>
src.bluestatic.org Git - isso.git/blob - xml.php
2 /*=====================================================================*\
3 || ###################################################################
4 || # Iris Studios Shared Object Framework [#]version[#]
5 || # Copyright ©2002-[#]year[#] Iris Studios, Inc.
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.
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
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 \*=====================================================================*/
32 * This framework is a wrapper for a robust XML parser.
34 * @author Iris Studios, Inc.
35 * @copyright Copyright ©2002 - [#]year[#], Iris Studios, Inc.
43 * Framework registry object
55 * An array of function names that are to be executed for each tag name (name => function)
58 var $taghandler = array();
67 * Tag stack of all open nodes
73 * Node list for all open tag attributes
76 var $attribs = array();
79 * Resulting parsed array
82 var $result = array();
84 // ###################################################################
88 function __construct(&$registry)
90 $this->registry
=& $registry;
93 // ###################################################################
97 function XML(&$registry)
99 $this->__construct($registry);
102 // ###################################################################
108 * @param string XML file data
110 * @return array Array with all the XML data parsed
112 function parse($data)
114 $this->stack
= array();
115 $this->attribs
= array();
116 $this->result
= array();
119 // create a new parser
120 $this->parser
= xml_parser_create();
121 xml_set_object($this->parser
, $this);
122 xml_parser_set_option($this->parser
, XML_OPTION_CASE_FOLDING
, 0);
123 xml_set_element_handler($this->parser
, 'handle_tag_start', 'handle_tag_end');
124 xml_set_character_data_handler($this->parser
, 'handle_cdata');
126 $this->attach_node($this->result
);
128 // parse the data and check for errors
129 if (!xml_parse($this->parser
, $data))
131 $error['code'] = xml_get_error_code($this->parser
);
132 $error['string'] = xml_error_string($error['code']);
133 $error['line'] = xml_get_current_line_number($this->parser
);
134 $error['column'] = xml_get_current_column_number($this->parser
);
135 trigger_error("XML Error: $error[string] at line $error[line] colunn $error[column]", E_USER_ERROR
);
139 // destroy the parser
140 xml_parser_free($this->parser
);
142 // done... send the results back
143 return $this->result
;
146 // ###################################################################
148 * Process the opening location of an XML tag
152 * @param integer XML parser
153 * @param string Tag name
154 * @param array Tag attributes
156 function handle_tag_start(&$parser, $name, $attrs)
159 array_walk($attrs, 'trim');
162 if (isset($this->attribs
["$name"]))
164 // node set has < 1 child nodes
165 if (!isset($this->attribs["$name"][0]))
167 $tmp = $this->attribs
["$name"];
168 unset($this->attribs["$name"]);
169 $this->attribs
["$name"][0] = $tmp;
172 // create a new child node
173 $this->attach_node($this->attribs["$name"][] = (array)$attrs);
175 // node set doesn't exist, so create it
178 $this->attach_node($this->attribs
["$name"] = (array)$attrs);
182 // ###################################################################
188 * @param integer XML parser
189 * @param string CDATA from tag
191 function handle_cdata(&$parser, $data)
193 $this->cdata .= $data;
196 // ###################################################################
198 * Process the closing of an XML tag
202 * @param integer XML parser
203 * @param string Tag name
205 function handle_tag_end(&$parser, $name)
207 // attach data to the node
208 if (($this->cdata = trim($this->cdata)) != '')
210 // if we have a data handler, operate it now
211 if (isset($this->taghandler["$name"]))
213 $this->registry
->debug("handler: " . $this->taghandler
["$name"]);
214 if (function_exists($this->taghandler["$name"]))
216 $this->cdata
= $this->taghandler
["$name"]($this->cdata, $this);
220 trigger_error('Could not find the function [' . $this->taghandler["$name"] . '()] for the XML tag "' . $name . '"', E_USER_ERROR
);
224 $this->attribs
['value'] = $this->cdata
;
230 $this->detach_node();
233 // ###################################################################
235 * Shifts the node tree
239 * @param array Node to place into the stack
241 function attach_node(&$node)
244 $this->stack
[ count($this->stack
) ] =& $node;
246 // new attributes to work with
247 $this->attribs
=& $node;
250 // ###################################################################
252 * Unshifts the node tree
256 function detach_node()
258 // drop the newest node
259 unset($this->stack
[ count($this->stack
) - 1 ]);
261 // assign the attributes to the next newest node
262 $this->attribs
=& $this->stack
[ count($this->stack
) - 1 ];
266 /*=====================================================================*\
267 || ###################################################################
270 || ###################################################################
271 \*=====================================================================*/