[翻译] Joomla XML 解析器规范 上

概述

Joomla! 1.5 新增 JSimpleXML 类，可以更为简单的读取xml文件，但是现在还不能修改CDATA或或者属性，也不支持XPath.

JSimpleXML需要PHP 4.2以上版本，以及 Expat扩展。


2. 实现

JSimpleXML 类代码：


class JSimpleXML extends JObject
{
    /**
    * Document element
    *
    * @var object
    */
    var $document = null;
   
     /**
     * Interprets a string of XML into an object
     *
     * This function will take the well-formed xml string data and return an object of class
     * JSimpleXMLElement with properties containing the data held within the xml document.
     * If any errors occur, it returns FALSE.
     *
     * @param string  Well-formed xml string data
     * @param string  currently ignored
     * @return object JSimpleXMLElement
     */
    function loadString($string, $classname = null)
    {
  $this->_parse($string);
  return true;
    }

     /**
     * Interprets an XML file into an object
     *
     * This function will convert the well-formed XML document in the file specified by
     * filename to an object  of class JSimpleXMLElement. If any errors occur during file
     * access or interpretation, the function returns FALSE.
     *
     * @param string  Path to xml file containing a well-formed XML document
     * @param string  currently ignored
     * @return object JSimpleXMLElement
     */
    function loadFile($path, $classname = null)
    {
  //Get the XML document loaded into a variable
  $xml = file_get_contents($path);
  $this->_parse($xml);
  return true;
    }

    /**
     * Get the parser
     *
     * @access public
     * @return resource XML parser resource handle
     */
    function getParser() {
  return $this->_parser;
    }

    /**
     * Set the parser
     *
     * @access public
     * @param resource XML parser resource handle
     */
    function setParser($parser) {
  $this->_parser = $parser;
    }
}

3. 使用

正如其名，JSimpleXML使用起来非常简单。你可以参考php5的SimpleXML文档，机关本质上两者有些不同，但是使用上是基本兼容的。

来看一个xml文档的例子(example.xml)




 
 
   
     Ms. Coder
     Onlivia Actora
   
   
     Mr. Coder
     El ActÓr
   
 
 
   So, this language. It's like, a programming language. Or is it a scripting language? All 
   is revealed in this thrilling horror spoof of a documentary.
 
  7
  5



2.1 开始

首先要载入xml文档，在本例中我们要载入example.xml,JSimpleXML loadFile 方法载入相应文件的xml格式数据。loadFile其实使用 file_get_contents()方法读取文件，并把被荣传递给解析器。

//Create a JSimpleXML object
$xml = new JSimpleXML();

//Load the xml file
$xml->loadFile($file);
?>

XML解析器在解析文档时候发生错误会触发 JError，如果没有任何错误，就会继续进行。

JSimpleXML的对象结构是直接了当的，文档的根包含在内。也就是说上例中$xml->document是根。$xml->document->movie[0]是第一个movie标签$xml->document->movie是一个数组，而不是JSimpleXMLElement对象。