* Copyright 2005-2008, Cake Software Foundation, Inc. * 1785 E. Sahara Avenue, Suite 490-204 * Las Vegas, Nevada 89104 * * Licensed under The MIT License * Redistributions of files must retain the above copyright notice. * * @filesource * @copyright Copyright 2005-2008, Cake Software Foundation, Inc. * @link http://www.cakefoundation.org/projects/info/cakephp CakePHP(tm) Project * @package cake * @subpackage cake.cake.libs * @since CakePHP v .0.10.3.1400 * @version $Revision$ * @modifiedby $LastChangedBy$ * @lastmodified $Date$ * @license http://www.opensource.org/licenses/mit-license.php The MIT License */ App::import('Core', 'Set'); /** * XML node. * * Single XML node in an XML tree. * * @package cake * @subpackage cake.cake.libs * @since CakePHP v .0.10.3.1400 */ class XmlNode extends Object { /** * Name of node * * @var string * @access public */ var $name = null; /** * Node namespace * * @var string * @access public */ var $namespace = null; /** * Value of node * * @var string * @access public */ var $value; /** * Attributes on this node * * @var array * @access public */ var $attributes = array(); /** * This node's children * * @var array * @access public */ var $children = array(); /** * Reference to parent node. * * @var XmlNode * @access private */ var $__parent = null; /** * Constructor. * * @param string $name Node name * @param array $attributes Node attributes * @param mixed $value Node contents (text) * @param array $children Node children */ function __construct(&$parent, $name = null, $value = null, $namespace = null) { $prefix = null; if (strpos($name, ':') !== false) { list($prefix, $name) = explode(':', $name); } if ($namespace) { $this->namespace = $namespace; } elseif (!empty($prefix)) { $document = $parent->document(); for ($i = 0; $i < count($document->namespaces); $i++) { if ($document->namespaces[$i]->prefix == $prefix) { $this->namespace =& $document->namespaces[$i]; break; } } } $this->name = $name; $this->setParent($parent); if (is_array($value) || is_object($value)) { $this->normalize($value); } elseif(!empty($value) || $value === 0 || $value === '0') { $this->createTextNode($value); } } /** * Creates an XmlNode object that can be appended to this document or a node in it * * @param string $name Node name * @param string $value Node value * @param string $namespace Node namespace * @return object XmlNode */ function &createNode($name = null, $value = null, $namespace = false) { $node = XmlNode($this, $name, $value, $namespace); return $node; } /** * Creates an XmlElement object that can be appended to this document or a node in it * * @param string $name Element name * @param string $value Element value * @param array $attributes Element attributes * @param string $namespace Node namespace * @return object XmlElement */ function &createElement($name = null, $value = null, $attributes = array(), $namespace = false) { $element =& new XmlElement($this, $name, $value, $attributes, $namespace); return $element; } /** * Creates an XmlTextNode object that can be appended to this document or a node in it * * @param string $value Node value * @return object XmlTextNode */ function &createTextNode($value = null) { $node = new XmlTextNode($this, $value); return $node; } /** * Gets the XML element properties from an object. * * @param object $object Object to get properties from * @return array Properties from object * @access public */ function normalize($object, $keyName = null, $options = array()) { if (is_a($object, 'XmlNode')) { return $object; } $name = null; $options = array_merge(array('format' => 'attributes'), $options); if ($keyName !== null && !is_numeric($keyName)) { $name = $keyName; } elseif (isset($object->_name_) && !empty($object->_name_)) { $name = $object->_name_; } elseif (isset($object->name) && $object->name != null) { $name = $object->name; } elseif ($options['format'] == 'attributes') { $name = get_class($object); } if ($this->__tagOptions($name) === false) { return; } $tagOpts = $this->__tagOptions($name); if (isset($tagOpts['name'])) { $name = $tagOpts['name']; } elseif ($name != strtolower($name)) { $name = Inflector::slug(Inflector::underscore($name)); } if (!empty($name)) { $node =& new XmlElement($this, $name); } else { $node =& $this; } $namespace = array(); $attributes = array(); $children = array(); $chldObjs = array(); $document =& $this->document(); if (is_object($object)) { $chldObjs = get_object_vars($object); } elseif (is_array($object)) { $chldObjs = $object; } elseif (!empty($object) || $object === 0) { $node->append(new XmlTextNode($node, $object)); } $attr = array(); if (isset($tagOpts['attributes'])) { $attr = $tagOpts['attributes']; } if (isset($tagOpts['value']) && isset($chldObjs[$tagOpts['value']])) { new XmlTextNode($node, $chldObjs[$tagOpts['value']]); unset($chldObjs[$tagOpts['value']]); } unset($chldObjs['_name_']); $c = 0; foreach ($chldObjs as $key => $val) { if (in_array($key, $attr) && !is_object($val) && !is_array($val)) { $attributes[$key] = $val; } else { if (!isset($tagOpts['children']) || $tagOpts['children'] === array() || (is_array($tagOpts['children']) && in_array($key, $tagOpts['children']))) { $n = $key; if (is_numeric($n)) { $n = $name; } if (is_array($val)) { foreach ($val as $i => $obj2) { $n2 = $i; if (is_numeric($n2)) { $n2 = $n; } $node->normalize($obj2, $n2, $options); } } else { if (is_object($val)) { $node->normalize($val, $n, $options); } elseif ($options['format'] == 'tags' && $this->__tagOptions($key) !== false) { $tmp =& new XmlElement($node, $key); if (!empty($val) || $val === 0) { new XmlTextNode($tmp, $val); } } elseif ($options['format'] == 'attributes') { $node->addAttribute($key, $val); } } } } $c++; } if (!empty($name)) { return $node; } return $children; } /** * Gets the tag-specific options for the given node name * * @param string $name XML tag name * @param string $option The specific option to query. Omit for all options * @return mixed A specific option value if $option is specified, otherwise an array of all options * @access private */ function __tagOptions($name, $option = null) { if (isset($this->__tags[$name])) { $tagOpts = $this->__tags[$name]; } elseif (isset($this->__tags[strtolower($name)])) { $tagOpts = $this->__tags[strtolower($name)]; } else { return null; } if ($tagOpts === false) { return false; } if (empty($option)) { return $tagOpts; } if (isset($tagOpts[$option])) { return $tagOpts[$option]; } return null; } /** * Returns the fully-qualified XML node name, with namespace * * @access public */ function name() { if (!empty($this->namespace)) { return $this->namespace . ':' . $this->name; } return $this->name; } /** * Sets the parent node of this XmlNode. * * @access public */ function setParent(&$parent) { if (strtolower(get_class($this)) == 'xml') { return; } if (isset($this->__parent) && is_object($this->__parent)) { if ($this->__parent->compare($parent)) { return; } foreach ($this->__parent->children as $i => $child) { if ($this->compare($child)) { array_splice($this->__parent->children, $i, 1); break; } } } if ($parent == null) { unset($this->__parent); } else { $parent->children[] =& $this; $this->__parent =& $parent; } } /** * Returns a copy of self. * * @return object Cloned instance * @access public */ function cloneNode() { return clone($this); } /** * Compares $node to this XmlNode object * * @param object An XmlNode or subclass instance * @return boolean True if the nodes match, false otherwise * @access public */ function compare($node) { $keys = array(get_object_vars($this), get_object_vars($node)); return ($keys[0] === $keys[1]); } /** * Append given node as a child. * * @param object $child XmlNode with appended child * @param array $options XML generator options for objects and arrays * @return object A reference to the appended child node * @access public */ function &append(&$child, $options = array()) { if (empty($child)) { $return = false; return $return; } if (is_array($child) || is_object($child)) { if (is_object($child) && is_a($child, 'XmlNode') && $this->compare($child)) { trigger_error('Cannot append a node to itself.'); $return = false; return $return; } if (is_array($child)) { $child = Set::map($child); if (is_array($child)) { if (!is_a(current($child), 'XmlNode')) { foreach ($child as $i => $childNode) { $child[$i] = $this->normalize($childNode, null, $options); } } else { foreach ($child as $childNode) { $this->append($childNode, $options); } } return $child; } } if (!is_a($child, 'XmlNode')) { $child = $this->normalize($child, null, $options); } $this->setParent($child); if (empty($child->namespace) && !empty($this->namespace)) { $child->namespace = $this->namespace; } } elseif (is_string($child)) { $attr = array(); if (func_num_args() >= 2 && is_array(func_get_arg(1))) { $attributes = func_get_arg(1); } $document = $this->document(); $child =& $document->createElement($name, null, $attributes); } return $child; } /** * Returns first child node, or null if empty. * * @return object First XmlNode * @access public */ function &first() { if (isset($this->children[0])) { return $this->children[0]; } else { return null; } } /** * Returns last child node, or null if empty. * * @return object Last XmlNode * @access public */ function &last() { if (count($this->children) > 0) { return $this->children[count($this->children) - 1]; } else { return null; } } /** * Returns child node with given ID. * * @param string $id Name of child node * @return object Child XmlNode * @access public */ function &child($id) { $null = null; if (is_int($id)) { if (isset($this->children[$id])) { return $this->children[$id]; } else { return null; } } elseif (is_string($id)) { for ($i = 0; $i < count($this->children); $i++) { if ($this->children[$i]->name == $id) { return $this->children[$i]; } } } return $null; } /** * Gets a list of childnodes with the given tag name. * * @param string $name Tag name of child nodes * @return array An array of XmlNodes with the given tag name * @access public */ function children($name) { $nodes = array(); $count = count($this->children); for ($i = 0; $i < $count; $i++) { if ($this->children[$i]->name == $name) { $nodes[] =& $this->children[$i]; } } return $nodes; } /** * Gets a reference to the next child node in the list of this node's parent. * * @return object A reference to the XmlNode object * @access public */ function &nextSibling() { $count = count($this->__parent->children); for ($i = 0; $i < $count; $i++) { if ($this->__parent->children == $this) { if ($i >= $count - 1 || !isset($this->__parent->children[$i + 1])) { return null; } return $this->__parent->children[$i + 1]; } } } /** * Gets a reference to the previous child node in the list of this node's parent. * * @return object A reference to the XmlNode object * @access public */ function &previousSibling() { $count = count($this->__parent->children); for ($i = 0; $i < $count; $i++) { if ($this->__parent->children == $this) { if ($i == 0 || !isset($this->__parent->children[$i - 1])) { return null; } return $this->__parent->children[$i - 1]; } } } /** * Returns parent node. * * @return object Parent XmlNode * @access public */ function &parent() { return $this->__parent; } /** * Returns the XML document to which this node belongs * * @return object Parent XML object * @access public */ function &document() { $document =& $this; while (true) { if (get_class($document) == 'Xml' || $document == null) { break; } $document =& $document->parent(); } return $document; } /** * Returns true if this structure has child nodes. * * @return bool * @access public */ function hasChildren() { if (is_array($this->children) && count($this->children) > 0) { return true; } return false; } /** * Returns this XML structure as a string. * * @return string String representation of the XML structure. * @access public */ function toString($options = array(), $depth = 0) { if (is_int($options)) { $depth = $options; $options = array(); } $defaults = array('cdata' => true, 'whitespace' => false, 'convertEntities' => false, 'showEmpty' => true); $options = array_merge($defaults, XML::options(), $options); $tag = !(strpos($this->name, '#') === 0); $d = ''; if ($tag) { if ($options['whitespace']) { $d .= str_repeat("\t", $depth); } $d .= '<' . $this->name(); if (is_array($this->attributes) && count($this->attributes) > 0) { foreach ($this->attributes as $key => $val) { $d .= " $key=\"$val\""; } } } if (!$this->hasChildren() && empty($this->value) && $this->value !== 0 && $tag) { $d .= " />"; if ($options['whitespace']) { $d .= "\n"; } } elseif ($tag || $this->hasChildren()) { if ($tag) { $d .= ">"; } if ($this->hasChildren()) { if ($options['whitespace']) { $d .= "\n"; } $count = count($this->children); $cDepth = $depth + 1; for ($i = 0; $i < $count; $i++) { $d .= $this->children[$i]->toString($options, $cDepth); } if ($tag) { if ($options['whitespace'] && $tag) { $d .= str_repeat("\t", $depth); } $d .= "name() . ">"; if ($options['whitespace']) { $d .= "\n"; } } } } return $d; } /** * Returns data from toString when this object is converted to a string. * * @return string String representation of this structure. * @access private */ function __toString() { return $this->toString(); } /** * Debug method. Deletes the parent. Also deletes this node's children, * if given the $recursive parameter. * * @param boolean $recursive Recursively delete elements. * @access private */ function __killParent($recursive = true) { unset($this->__parent, $this->_log); if ($recursive && $this->hasChildren()) { for ($i = 0; $i < count($this->children); $i++) { $this->children[$i]->__killParent(true); } } } } /** * Main XML class. * * Parses and stores XML data, representing the root of an XML document * * @package cake * @subpackage cake.cake.libs * @since CakePHP v .0.10.3.1400 */ class Xml extends XmlNode { /** * Resource handle to XML parser. * * @var resource * @access private */ var $__parser; /** * File handle to XML indata file. * * @var resource * @access private */ var $__file; /** * Raw XML string data (for loading purposes) * * @var string * @access private */ var $__rawData = null; /** * XML document header * * @var string * @access private */ var $__header = null; /** * Default array keys/object properties to use as tag names when converting objects or array structures to XML. * Set by passing $options['tags'] to this object's constructor. * * @var array * @access private */ var $__tags = array(); /** * XML document version * * @var string * @access private */ var $version = '1.0'; /** * XML document encoding * * @var string * @access private */ var $encoding = 'UTF-8'; /** * Namespace used in this document * * @var array * @access public */ var $namespaces = array(); /** * Constructor. Sets up the XML parser with options, gives it this object as * its XML object, and sets some variables. * * @param string $input What should be used to set up * @param array $options Options to set up with */ function __construct($input = null, $options = array()) { $defaults = array('root' => '#document', 'tags' => array(), 'namespaces' => array(), 'version' => '1.0', 'encoding' => 'UTF-8', 'format' => 'attributes'); $options = array_merge($defaults, XML::options(), $options); foreach (array('version', 'encoding', 'namespaces') as $key) { $this->{$key} = $options[$key]; } $this->__tags = $options['tags']; parent::__construct($this, $options['root']); if (!empty($input)) { if (is_string($input)) { $this->load($input); } elseif (is_array($input) || is_object($input)) { $this->append($input, $options); } } // if (Configure::read('App.encoding') !== null) { // $this->encoding = Configure::read('App.encoding'); // } } /** * Initialize XML object from a given XML string. Returns false on error. * * @param string $input XML string, a path to a file, or an HTTP resource to load * @return boolean Success * @access public */ function load($input) { if (!is_string($input)) { return false; } $this->__rawData = null; $this->header = null; if (strstr($input, "<")) { $this->__rawData = $input; } elseif (strpos($input, 'http://') === 0 || strpos($input, 'https://') === 0) { App::import('Core', 'HttpSocket'); $socket = new HttpSocket(); $this->__rawData = $socket->get($input); } elseif (file_exists($input)) { $this->__rawData = file_get_contents($input); } else { trigger_error('XML cannot be read'); return false; } return $this->parse(); } /** * Parses and creates XML nodes from the __rawData property. * * @return boolean Success * @access public * @see Xml::load() * @todo figure out how to link attributes and namespaces */ function parse() { $this->__initParser(); $this->header = trim(str_replace(a('<'.'?', '?'.'>'), a('', ''), substr(trim($this->__rawData), 0, strpos($this->__rawData, "\n")))); xml_parse_into_struct($this->__parser, $this->__rawData, $vals); $xml =& $this; $count = count($vals); for ($i = 0; $i < $count; $i++) { $data = $vals[$i]; $namespace = false; $data = array_merge(array('tag' => null, 'value' => null, 'attributes' => array()), $data); foreach ($data['attributes'] as $attr => $val) { if (strpos($attr, 'xmlns') === 0) { if ($attr == 'xmlns') { $namespace = $val; } else { list($pre, $prefix) = explode(':', $attr); $this->addNamespace($prefix, $val); } } } switch($data['type']) { case "open" : $xml =& $xml->createElement($data['tag'], $data['value'], $data['attributes'], $namespace); break; case "close" : $xml =& $xml->parent(); break; case "complete" : $xml->createElement($data['tag'], $data['value'], $data['attributes']); break; case 'cdata': $xml->createTextNode($data['value']); break; } } return true; } /** * Initializes the XML parser resource * * @return void * @access private */ function __initParser() { if (empty($this->__parser)) { $this->__parser = xml_parser_create(); xml_set_object($this->__parser, $this); xml_parser_set_option($this->__parser, XML_OPTION_CASE_FOLDING, 0); xml_parser_set_option($this->__parser, XML_OPTION_SKIP_WHITE, 1); } } /** * Returns a string representation of the XML object * * @param mixed $options If boolean: whether to include the XML header with the document (defaults to true); if array: * overrides the default XML generation options * @return string XML data * @access public * @deprecated * @see Xml::toString() */ function compose($options = array()) { return $this->toString($options); } /** * If debug mode is on, this method echoes an error message. * * @param string $msg Error message * @param integer $code Error code * @param integer $line Line in file * @access public */ function error($msg, $code = 0, $line = 0) { if (Configure::read('debug')) { echo $msg . " " . $code . " " . $line; } } /** * Returns a string with a textual description of the error code, or FALSE if no description was found. * * @param integer $code Error code * @return string Error message * @access public */ function getError($code) { $r = @xml_error_string($code); return $r; } // Overridden functions from superclass /** * Get next element. NOT implemented. * * @return object * @access public */ function &next() { $return = null; return $return; } /** * Get previous element. NOT implemented. * * @return object * @access public */ function &previous() { $return = null; return $return; } /** * Get parent element. NOT implemented. * * @return object * @access public */ function &parent() { $return = null; return $return; } /** * Adds a namespace to the current document * * @param string $prefix The namespace prefix * @param string $url The namespace DTD URL * @return void */ function addNamespace($prefix, $url) { $_this =& XmlManager::getInstance(); if ($ns = XML::__resolveNamespace($prefix, $url)) { $_this->namespaces = array_merge($_this->namespaces, $ns); return true; } return false; } /** * Return string representation of current object. * * @return string String representation * @access public */ function toString($options = array()) { if (is_bool($options)) { $options = array('header' => $options); } $defaults = array('header' => false, 'encoding' => $this->encoding); $options = array_merge($defaults, Xml::options(), $options); $data = parent::toString($options, 0); if ($options['header']) { if (!empty($this->__header)) { $header = '<' . '?' . $this->__header . ' ?' . '>' . "\n"; } else { $header = '<' . '?xml version="' . $this->version . '" encoding="' . $this->encoding . '" ?' . '>' . "\n"; } return $header . $data; } return $data; } /** * Destructor, used to free resources. * * @access private */ function __destruct() { if (is_resource($this->__parser)) { xml_parser_free($this->__parser); } } /** * Adds a namespace to any XML documents generated or parsed * * @param string $name The namespace name * @param string $url The namespace URI; can be empty if in the default namespace map * @return boolean False if no URL is specified, and the namespace does not exist * default namespace map, otherwise true * @access public * @static */ function addGlobalNs($name, $url = null) { $_this =& XmlManager::getInstance(); if ($ns = Xml::__resolveNamespace($name, $url)) { $_this->__namespaces = array_merge($_this->__namespaces, $ns); return true; } return false; } /** * Private method * * @param string $name * @param string $url * @return array * @access private */ function __resolveNamespace($name, $url) { $_this =& XmlManager::getInstance(); if ($url == null && in_array($name, array_keys($_this->__defaultNamespaceMap))) { $url = $_this->__defaultNamespaceMap[$name]; } elseif ($url == null) { return false; } if (!strpos($url, '://') && in_array($name, array_keys($_this->__defaultNamespaceMap))) { $_url = $_this->__defaultNamespaceMap[$name]; $name = $url; $url = $_url; } return array($name => $url); } /** * Alias to Xml::addNs * * @access public * @static */ function addGlobalNamespace($name, $url = null) { return Xml::addGlobalNs($name, $url); } /** * Removes a namespace added in addNs() * * @param string $name The namespace name or URI * @access public * @static */ function removeGlobalNs($name) { $_this =& XmlManager::getInstance(); if (in_array($name, array_keys($_this->namespaces))) { unset($_this->namespaces[$name]); } elseif (in_array($name, $_this->namespaces)) { $keys = array_keys($_this->namespaces); $count = count($keys); for ($i = 0; $i < $count; $i++) { if ($_this->namespaces[$keys[$i]] == $name) { unset($_this->namespaces[$keys[$i]]); return; } } } } /** * Alias to Xml::removeNs * * @access public * @static */ function removeGlobalNamespace($name, $url = null) { Xml::removeGlobalNs($name, $url); } /** * Sets/gets global XML options * * @param array $options * @return array * @access public * @static */ function options($options = array()) { $_this =& XmlManager::getInstance(); $_this->options = array_merge($_this->options, $options); return $_this->options; } } class XmlElement extends XmlNode { function __construct(&$parent, $name = null, $value = null, $attributes = array(), $namespace = false) { parent::__construct($parent, $name, $value, $namespace); $this->addAttribute($attributes); } function attributes() { return $this->attributes; } function addAttribute($name, $val = null) { if (is_object($name)) { $name = get_object_vars($name); } if (is_array($name)) { foreach ($name as $key => $val) { $this->addAttribute($key, $val); } return true; } if (is_numeric($name)) { $name = $val; $val = null; } if (!empty($name)) { $this->attributes[$name] = $val; return true; } return false; } function removeAttribute($attr) { if ($this->attributes[$attr]) { unset($this->attributes[$attr]); return true; } return false; } } /** * XML text or CDATA node * * Stores XML text data according to the encoding of the parent document * * @package cake * @subpackage cake.cake.libs * @since CakePHP v .1.2.6000 */ class XmlTextNode extends XmlNode { /** * Harcoded XML node name, represents this object as a text node * * @var string */ var $name = '#text'; /** * The text/data value which this node contains * * @var string */ var $value = null; /** * Construct text node with the given parent object and data * * @param object $parent Parent XmlNode/XmlElement object * @param mixed $value Node value */ function __construct(&$parent, $value = null) { if (is_numeric($value)) { $value = floatval($value); } $this->value = $value; $this->setParent($parent); } /** * Looks for child nodes in this element * * @return boolean False - not supported */ function hasChildren() { return false; } /** * Append an XML node: XmlTextNode does not support this operation * * @return boolean False - not supported * @todo make convertEntities work without mb support, convert entities to number entities */ function append() { return false; } /** * Return string representation of current text node object. * * @return string String representation * @access public */ function toString($options = array(), $depth = 0) { if (is_int($options)) { $depth = $options; $options = array(); } $defaults = array('cdata' => true, 'whitespace' => false, 'convertEntities' => false); $options = array_merge($defaults, Xml::options(), $options); $val = $this->value; if ($options['convertEntities'] && function_exists('mb_convert_encoding')) { $val = mb_convert_encoding($val,'UTF-8', 'HTML-ENTITIES'); } if ($options['cdata'] === true && is_string($val)) { $val = ''; } if ($options['whitespace']) { return str_repeat("\t", $depth) . $val . "\n"; } return $val; } } /** * Manages application-wide namespaces and XML parsing/generation settings. * Private class, used exclusively within scope of XML class. * * @access private */ class XmlManager { /** * Global XML namespaces. Used in all XML documents processed by this application * * @var array * @access public */ var $namespaces = array(); /** * Global XML document parsing/generation settings. * * @var array * @access public */ var $options = array(); /** * Map of common namespace URIs * * @access private * @var array */ var $__defaultNamespaceMap = array( 'dc' => 'http://purl.org/dc/elements/1.1/', // Dublin Core 'dct' => 'http://purl.org/dc/terms/', // Dublin Core Terms 'g' => 'http://base.google.com/ns/1.0', // Google Base 'rc' => 'http://purl.org/rss/1.0/modules/content/', // RSS 1.0 Content Module 'wf' => 'http://wellformedweb.org/CommentAPI/', // Well-Formed Web Comment API 'fb' => 'http://rssnamespace.org/feedburner/ext/1.0', // FeedBurner extensions 'lj' => 'http://www.livejournal.org/rss/lj/1.0/', // Live Journal 'itunes' => 'http://www.itunes.com/dtds/podcast-1.0.dtd', // iTunes 'xhtml' => 'http://www.w3.org/1999/xhtml', // XHTML, 'atom' => 'http://www.w3.org/2005/Atom' // Atom ); /** * Returns a reference to the global XML object that manages app-wide XML settings * * @return object * @access public */ function &getInstance() { static $instance = array(); if (!isset($instance[0]) || !$instance[0]) { $instance[0] =& new XmlManager(); } return $instance[0]; } } ?>