Login   Register  
PHP Classes
elePHPant
Icontem

File: outils_xml.inc.php

Recommend this page to a friend!
Stumble It! Stumble It! Bookmark in del.icio.us Bookmark in del.icio.us
  Classes of Julien PACHET  >  i18n  >  outils_xml.inc.php  >  Download  
File: outils_xml.inc.php
Role: Auxiliary script
Content type: text/plain
Description: xml functions
Class: i18n
Get translations texts from XML files
Author: By
Last change:
Date: 2005-09-16 07:55
Size: 7,658 bytes
 

Contents

Class file image Download
<?

// {{{ toString()
/**
 * This method converts a file to a string. It returns an Error object if it is unable to open the file.
 *
 * @param    fileName String. The name of the file to convert.
 *
 * @return    String
 * @author  simgar
 */

function toString$fileName )
{
    if (
$content_array file($fileName))
    {
        return 
implode(""$content_array);
    }
    else
    {
        
// Error
        
return false;
    }
}
// }}}

// {{{ xmlFileToArray()
/**
 * This static method converts an xml file to an associative array 
 * duplicating the xml file structure.
 *
 * @param    $fileName. String. The name of the xml file to convert. 
 *             This method returns an Error object if this file does not 
 *             exist or is invalid.
 * @param    $includeTopTag. boolean. Whether or not the topmost xml tag 
 *             should be included in the array. The default value for this is false.
 * @param    $lowerCaseTags. boolean. Whether or not tags should be 
 *            set to lower case. Default value for this parameter is true.
 * @access    public static
 * @return    Associative Array
 * @author    Jason Read <jason@ace.us.com>
 */
function xmlFileToArray($fileName$includeTopTag false$lowerCaseTags true)
{
    
// Definition file not found
    
if (!file_exists($fileName))
    {
        
// Error
        
return false;
    }
    
$p xml_parser_create();
    
xml_parse_into_struct($p,toString($fileName),$vals,$index);
    
xml_parser_free($p);
    
$xml = array();
    
$levels = array();
    
$multipleData = array();
    
$prevTag "";
    
$currTag "";
    
$topTag false;
    foreach (
$vals as $val)
    {
        
// Open tag
        
if ($val["type"] == "open")
        {
            if (!
_xmlFileToArrayOpen($topTag$includeTopTag$val$lowerCaseTags,
                                           
$levels$prevTag$multipleData$xml))
            {
                continue;
            }
        }
        
// Close tag
        
else if ($val["type"] == "close")
        {
            if (!
_xmlFileToArrayClose($topTag$includeTopTag$val$lowerCaseTags$currTag,
                                            
$levels$prevTag$multipleData$xml))
            {
                continue;
            }
        }
        
// Data tag
        
else if ($val["type"] == "complete" && isset($val["value"]))
        {
            
$loc =& $xml;
            foreach (
$levels as $level)
            {
                
$temp =& $loc[str_replace(":arr#"""$level)];
                
$loc =& $temp;
            }
            
$tag $val["tag"];
            if (
$lowerCaseTags)
            {
                
$tag strtolower($val["tag"]);
            }
            
$loc[$tag] = str_replace("\\n""\n"$val["value"]);
        }
        
// Tag without data
        
else if ($val["type"] == "complete")
        {
            
_xmlFileToArrayOpen($topTag$includeTopTag$val$lowerCaseTags$currTag,
                                      
$levels$prevTag$multipleData$xml);
            
_xmlFileToArrayClose($topTag$includeTopTag$val$lowerCaseTags$currTag
                                      
$levels$prevTag$multipleData$xml);
        }
    }
    return 
$xml;
}
// }}}

// {{{ _xmlFileToArrayOpen()
/**
 * Private support function for xmlFileToArray. Handles an xml OPEN tag.
 *
 * @param    $topTag. String. xmlFileToArray topTag variable
 * @param    $includeTopTag. boolean. xmlFileToArray includeTopTag variable
 * @param    $val. String[]. xmlFileToArray val variable
 * @param    $currTag. String. xmlFileToArray currTag variable
 * @param    $lowerCaseTags. boolean. xmlFileToArray lowerCaseTags variable
 * @param    $levels. String[]. xmlFileToArray levels variable
 * @param    $prevTag. String. xmlFileToArray prevTag variable
 * @param    $multipleData. boolean. xmlFileToArray multipleData variable
 * @param    $xml. String[]. xmlFileToArray xml variable
 * @access    private static
 * @return    boolean
 * @author    Jason Read <jason@ace.us.com>
 */
function _xmlFileToArrayOpen(& $topTag, & $includeTopTag, & $val, & $lowerCaseTags
                             & 
$levels, & $prevTag, & $multipleData, & $xml)
{
    
// don't include top tag
    
if (!$topTag && !$includeTopTag)
    {
        
$topTag $val["tag"];
        return 
false;
    }
    
$currTag $val["tag"];
    if (
$lowerCaseTags)
    {
        
$currTag strtolower($val["tag"]);
    }
    
$levels[] = $currTag;
    
    
// Multiple items w/ same name. Convert to array.
    
if ($prevTag === $currTag)
    {
        if (!
array_key_exists($currTag$multipleData) || 
            !
$multipleData[$currTag]["multiple"])
        {
            
$loc =& $xml;
            foreach (
$levels as $level)
            {
                
$temp =& $loc[$level];
                
$loc =& $temp;
            }
            
$loc = array($loc);
            
$multipleData[$currTag]["multiple"] = true;
            
$multipleData[$currTag]["multiple_count"] = 0;
        }
        
$multipleData[$currTag]["popped"] = false;
        
$levels[] = ":arr#" . ++$multipleData[$currTag]["multiple_count"];
    }
    else
    {
        
$multipleData[$currTag]["multiple"] = false;
    }
    
    
// Add attributes array
    
if (array_key_exists("attributes"$val))
    {
        
$loc =& $xml;
        foreach (
$levels as $level)
        {
            
$temp =& $loc[str_replace(":arr#"""$level)];
            
$loc =& $temp;
        }
        
$keys array_keys($val["attributes"]);
        foreach (
$keys as $key)
        {
            
$tag $key;
            if (
$lowerCaseTags)
            {
                
$tag strtolower($tag);
            }
            
$loc["attributes"][$tag] = & $val["attributes"][$key];
        }
    }
    return 
true;
}
// }}}

// {{{ _xmlFileToArrayClose()
/**
 * Private support function for xmlFileToArray. Handles an xml OPEN tag.
 *
 * @param    $topTag. String. xmlFileToArray topTag variable
 * @param    $includeTopTag. boolean. xmlFileToArray includeTopTag variable
 * @param    $val. String[]. xmlFileToArray val variable
 * @param    $currTag. String. xmlFileToArray currTag variable
 * @param    $lowerCaseTags. boolean. xmlFileToArray lowerCaseTags variable
 * @param    $levels. String[]. xmlFileToArray levels variable
 * @param    $prevTag. String. xmlFileToArray prevTag variable
 * @param    $multipleData. boolean. xmlFileToArray multipleData variable
 * @param    $xml. String[]. xmlFileToArray xml variable
 * @access    private static
 * @return    boolean
 * @author    Jason Read <jason@ace.us.com>
 */
function _xmlFileToArrayClose(& $topTag, & $includeTopTag, & $val, & $lowerCaseTags,& $currTag
                              & 
$levels, & $prevTag, & $multipleData, & $xml)
{
    
// don't include top tag
    
if ($topTag && !$includeTopTag && $val["tag"] == $topTag)
    {
        return 
false;
    }
    if (
            (!
is_array($currTag))
        &&
            (
count($multipleData)>0)
        &&
        isset(
$multipleData[$currTag])
        &&
        (
$multipleData[$currTag]["multiple"])
    )
    {
        
$tkeys array_reverse(array_keys($multipleData));
        foreach (
$tkeys as $tkey)
        {
            if (
$multipleData[$tkey]["multiple"] && !$multipleData[$tkey]["popped"])
            {
                
array_pop($levels);
                
$multipleData[$tkey]["popped"] = true;
                break;
            }
            else if (!
$multipleData[$tkey]["multiple"])
            {
                break;
            }
        }
    }
    
$prevTag array_pop($levels);
    if (
strpos($prevTag"arr#"))
    {
        
$prevTag array_pop($levels);
    }
    return 
true;
}
// }}}
?>