class.ilXmlWriter.php

Go to the documentation of this file.

<?php

/* Copyright (c) 1998-2009 ILIAS open source, Extended GPL, see docs/LICENSE */

class ilXmlWriter
{
    public $xmlStr;

    public $version;

    public $outEnc;

    public $inEnc;

    public $dtdDef = "";

    public $stSheet = "";

    public $genCmt = "Generated by ILIAS XmlWriter";

    public function __construct($version = "1.0", $outEnc = "utf-8", $inEnc = "utf-8")
    {
        // initialize xml string
        $this->xmlStr = "";
        
        // set properties
        $this->version = $version;
        $this->outEnc = $outEnc;
        $this->inEnc = $inEnc;
    }
    
    public function _ilXmlWriter()
    {
        // terminate xml string
        unset($this->xmlStr);
    }
    
    public function xmlSetDtdDef($dtdDef)
    {
        $this->dtdDef = $dtdDef;
    }
    
    public function xmlSetStSheet($stSheet)
    {
        $this->stSheet = $stSheet;
    }
    
    public function xmlSetGenCmt($genCmt)
    {
        $this->genCmt = $genCmt;
    }

    public static function _xmlEscapeData($data)
    {
        $position = 0;
        $length = strlen($data);
        $escapedData = "";
        
        for (; $position < $length;) {
            $character = substr($data, $position, 1);
            $code = Ord($character);
            
            switch ($code) {
                case 34:
                    $character = "&quot;";
                    break;
                
                case 38:
                    $character = "&amp;";
                    break;
                
                case 39:
                    $character = "&apos;";
                    break;
                
                case 60:
                    $character = "&lt;";
                    break;
                
                case 62:
                    $character = "&gt;";
                    break;
                
                default:
                    if ($code < 32) {
                        $character = ("&#" . strval($code) . ";");
                    }
                    break;
            }
            
            $escapedData .= $character;
            $position++;
        }
        return $escapedData;
    }
    
    public function xmlEncodeData($data)
    {
        if ($this->inEnc == $this->outEnc) {
            $encodedData = $data;
        } else {
            switch (strtolower($this->outEnc)) {
                case "utf-8":
                    if (strtolower($this->inEnc) == "iso-8859-1") {
                        $encodedData = utf8_encode($data);
                    } else {
                        die("<b>Error</b>: Cannot encode iso-8859-1 data in " . $this->outEnc .
                                " in <b>" . __FILE__ . "</b> on line <b>" . __LINE__ . "</b><br />");
                    }
                    break;
                
                case "iso-8859-1":
                    if (strtolower($this->inEnc) == "utf-8") {
                        $encodedData = utf8_decode($data);
                    } else {
                        die("<b>Error</b>: Cannot encode utf-8 data in " . $this->outEnc .
                                " in <b>" . __FILE__ . "</b> on line <b>" . __LINE__ . "</b><br />");
                    }
                    break;
                    
                default:
                    die("<b>Error</b>: Cannot encode " . $this->inEnc . " data in " . $this->outEnc .
                            " in <b>" . __FILE__ . "</b> on line <b>" . __LINE__ . "</b><br />");
            }
        }
        return $encodedData;
    }
    
    public function xmlFormatData($data)
    {
        // regular expression for tags
        $formatedXml = preg_replace_callback("|<[^>]*>[^<]*|", array($this, "xmlFormatElement"), $data);
        
        return $formatedXml;
    }
    
    public function xmlFormatElement($array)
    {
        $found = trim($array[0]);
        
        static $indent;
        
        // linebreak (default)
        $nl = "\n";
        
        $tab = str_repeat(" ", $indent * 2);
        
        // closing tag
        if (substr($found, 0, 2) == "</") {
            if ($indent) {
                $indent--;
            }
            $tab = str_repeat(" ", $indent * 2);
        } elseif (substr($found, -2, 1) == "/" or // opening and closing, comment, ...
                strpos($found, "/>") or
                substr($found, 0, 2) == "<!") {
            // do not change indent
        } elseif (substr($found, 0, 2) == "<?") {
            // do not change indent
            // no linebreak
            $nl = "";
        } else { // opening tag
            $indent++;
        }
        
        // content
        if (substr($found, -1) != ">") {
            $found = str_replace(">", ">\n" . str_repeat(" ", ($indent + 0) * 2), $found);
        }
        
        return $nl . $tab . $found;
    }
    
    public function xmlHeader()
    {
        // version and encoding
        $this->xmlStr .= "<?xml version=\"" . $this->version . "\" encoding=\"" . $this->outEnc . "\"?>";
        
        // dtd definition
        if ($this->dtdDef <> "") {
            $this->xmlStr .= $this->dtdDef;
        }
        
        // stSheet
        if ($this->stSheet <> "") {
            $this->xmlStr .= $this->stSheet;
        }
        
        // generated comment
        if ($this->genCmt <> "") {
            $this->xmlComment($this->genCmt);
        }
        
        return $xmlStr;
    }
    
    public function xmlStartTag($tag, $attrs = null, $empty = false, $encode = true, $escape = true)
    {
        // write first part of the starttag
        $this->xmlStr .= "<" . $tag;
        
        // check for existing attributes
        if (is_array($attrs)) {
            // write attributes
            foreach ($attrs as $name => $value) {
                // encode
                if ($encode) {
                    $value = $this->xmlEncodeData($value);
                }
                
                // escape
                if ($escape) {
                    $value = ilXmlWriter::_xmlEscapeData($value);
                }
                
                $this->xmlStr .= " " . $name . "=\"" . $value . "\"";
            }
        }
        
        // write last part of the starttag
        if ($empty) {
            $this->xmlStr .= "/>";
        } else {
            $this->xmlStr .= ">";
        }
    }
    
    public function xmlEndTag($tag)
    {
        $this->xmlStr .= "</" . $tag . ">";
    }
    
    public function xmlComment($comment)
    {
        $this->xmlStr .= "<!--" . $comment . "-->";
    }

    public function xmlData($data, $encode = true, $escape = true)
    {
        // encode
        if ($encode) {
            $data = $this->xmlEncodeData($data);
        }
        
        // escape
        if ($escape) {
            $data = ilXmlWriter::_xmlEscapeData($data);
        }
        
        $this->xmlStr .= $data;
    }
    
    public function xmlElement($tag, $attrs = null, $data = null, $encode = true, $escape = true)
    {
        // check for existing data (element's content)
        if (is_string($data) or
            is_integer($data) or
            is_float($data)) {
            // write starttag
            $this->xmlStartTag($tag, $attrs, false, $encode, $escape);
            
            // write text
            $this->xmlData($data, $encode, $escape);
            
            // write endtag
            $this->xmlEndTag($tag);
        } else { // no data
            // write starttag (= empty tag)
            $this->xmlStartTag($tag, $attrs, true, $encode, $escape);
        }
    }
    
    public function xmlDumpFile($file, $format = true)
    {
        // open file
        if (!($fp = @fopen($file, "w+"))) {
            die("<b>Error</b>: Could not open \"" . $file . "\" for writing" .
                    " in <b>" . __FILE__ . "</b> on line <b>" . __LINE__ . "</b><br />");
        }
        
        // set file permissions
        chmod($file, 0770);
        
        // format xml data
        if ($format) {
            $xmlStr = $this->xmlFormatData($this->xmlStr);
        } else {
            $xmlStr = $this->xmlStr;
        }
        
        // write xml data into the file
        fwrite($fp, $xmlStr);
        
        // close file
        fclose($fp);
    }
    
    public function xmlDumpMem($format = true)
    {
        // format xml data
        if ($format) {
            $xmlStr = $this->xmlFormatData($this->xmlStr);
        } else {
            $xmlStr = $this->xmlStr;
        }
        
        return $xmlStr;
    }

    public function appendXML($a_str)
    {
        $this->xmlStr .= $a_str;
    }
    
    public function xmlClear()
    {
        // reset xml string
        $this->xmlStr = "";
    }
}