XML_Parser.php

Go to the documentation of this file.

<?php
/* vim: set expandtab tabstop=4 shiftwidth=4: */
//  
//  Copyright (c) 2003 Laurent Bedubourg
//  
//  This library is free software; you can redistribute it and/or
//  modify it under the terms of the GNU Lesser General Public
//  License as published by the Free Software Foundation; either
//  version 2.1 of the License, or (at your option) any later version.
//  
//  This library is distributed in the hope that it will be useful,
//  but WITHOUT ANY WARRANTY; without even the implied warranty of
//  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
//  Lesser General Public License for more details.
//  
//  You should have received a copy of the GNU Lesser General Public
//  License along with this library; if not, write to the Free Software
//  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
//  
//  Authors: Laurent Bedubourg <laurent.bedubourg@free.fr>
//  

require_once PT_IP . "/Types/Errors.php";

class PHPTAL_XML_Parser 
{
    var $_file = '#string';
    var $_tags = array();
    var $_parser;
    var $_error;
    var $_xmlErrors = array(
        XML_ERROR_NONE                      => "XML_ERROR_NONE",
        XML_ERROR_NO_MEMORY                 => "XML_ERROR_NO_MEMORY",
        XML_ERROR_SYNTAX                    => "XML_ERROR_SYNTAX",
        XML_ERROR_NO_ELEMENTS               => "XML_ERROR_NO_ELEMENTS",
        XML_ERROR_INVALID_TOKEN             => "XML_ERROR_INVALID_TOKEN",
        XML_ERROR_UNCLOSED_TOKEN            => "XML_ERROR_UNCLOSED_TOKEN",
        XML_ERROR_PARTIAL_CHAR              => "XML_ERROR_PARTIAL_CHAR",
        XML_ERROR_TAG_MISMATCH              => "XML_ERROR_TAG_MISMATCH",
        XML_ERROR_DUPLICATE_ATTRIBUTE       => "XML_ERROR_DUPLICATE_ATTRIBUTE",
        XML_ERROR_JUNK_AFTER_DOC_ELEMENT    => "XML_ERROR_JUNK_AFTER_DOC_ELEMENT",
        XML_ERROR_PARAM_ENTITY_REF          => "XML_ERROR_PARAM_ENTITY_REF",
        XML_ERROR_UNDEFINED_ENTITY          => "XML_ERROR_UNDEFINED_ENTITY",
        XML_ERROR_RECURSIVE_ENTITY_REF      => "XML_ERROR_RECURSIVE_ENTITY_REF",
        XML_ERROR_ASYNC_ENTITY              => "XML_ERROR_ASYNC_ENTITY",
        XML_ERROR_BAD_CHAR_REF              => "XML_ERROR_BAD_CHAR_REF",
        XML_ERROR_BINARY_ENTITY_REF         => "XML_ERROR_BINARY_ENTITY_REF",
        XML_ERROR_ATTRIBUTE_EXTERNAL_ENTITY_REF => "XML_ERROR_ATTRIBUTE_EXTERNAL_ENTITY_REF",
        XML_ERROR_MISPLACED_XML_PI          => "XML_ERROR_MISPLACED_XML_PI",
        XML_ERROR_UNKNOWN_ENCODING          => "XML_ERROR_UNKNOWN_ENCODING",
        XML_ERROR_INCORRECT_ENCODING        => "XML_ERROR_INCORRECT_ENCODING",
        XML_ERROR_UNCLOSED_CDATA_SECTION    => "XML_ERROR_UNCLOSED_CDATA_SECTION",
        XML_ERROR_EXTERNAL_ENTITY_HANDLING  => "XML_ERROR_EXTERNAL_ENTITY_HANDLING",
        );
        
    function PHPTAL_XML_Parser()
    {
        $this->__construct();
    }

    function __construct()
    {
        $this->_parser = xml_parser_create();
        xml_set_object($this->_parser, $this);
        xml_set_element_handler($this->_parser, "_onElementStart", "_onElementClose");
        xml_set_character_data_handler($this->_parser, "_onElementData");
        xml_set_default_handler($this->_parser, "_onSpecific");
        xml_parser_set_option($this->_parser, XML_OPTION_CASE_FOLDING, 0);
    }

    function _parse($data, $eof=true)
    {
        $data = str_replace('&','&amp;', $data);
        if (!xml_parse($this->_parser, $data)) {
            // PHPTAL errors first
            if (PEAR::isError($this->_error)) {
                return $this->_error;
            }
            // then look for parser errors
            $err = xml_get_error_code($this->_parser);
            return PEAR::raiseError($this->_xmlErrors[$err]
                                    .' in '.$this->_file
                                    .' around line '.$this->getLineNumber());
        }
        if (PEAR::isError($this->_error)) {
            return $this->_error;
        }
        return true;
    }
    
    function parseString($data)
    {
        return $this->_parse($data, true);
    }
    
    function parseFile($path)
    {
        $this->_file = $path;
        $fp = @fopen($path, "r");
        if (!$fp) {
            return PEAR::raiseError($php_errormsg);
        }
        while ($data = fread($fp, 1024)) {
            $err = $this->_parse($data, feof($fp));
            if (PEAR::isError($err)) {
                fclose($fp);
                return $err;
            }
        }
        fclose($fp);
    }

    function _onElementStart($parser, $tag, $attributes)
    { 
        if (PEAR::isError($this->_error)) return;
        $this->_error = $this->onElementStart($tag, $attributes);
    }

    function _onElementClose($parser, $tag)
    {
        if (PEAR::isError($this->_error)) return;
        $this->_error = $this->onElementClose($tag);
    }

    function _onElementData($parser, $data)
    {
        if (PEAR::isError($this->_error)) return;
        $this->_error = $this->onElementData($data);
    }

    function _onSpecific($parser, $data)
    {
        if (PEAR::isError($this->_error)) return;
        $this->_error = $this->onSpecific($data);
    }

    function getLineNumber()
    {
        return xml_get_current_line_number($this->_parser);
    }

    // 
    // ABSTRACT METHODS
    // 

    function onElementStart($tag, $attributes){}

    function onElementClose($tag){}

    function onElementData($data){}

    function onSpecific($data){}
}

?>

---