LocallangXmlParser.php

Go to the documentation of this file.

<?php
namespace TYPO3\CMS\Core\Localization\Parser;

class LocallangXmlParser extends \TYPO3\CMS\Core\Localization\Parser\AbstractXmlParser {

    protected $parsedTargetFiles;

    public function getParsedData($sourcePath, $languageKey, $charset = '') {
        $this->sourcePath = $sourcePath;
        $this->languageKey = $languageKey;
        $this->charset = $this->getCharset($languageKey, $charset);
        // Parse source
        $parsedSource = $this->parseXmlFile();
        // Parse target
        $localizedTargetPath = \TYPO3\CMS\Core\Utility\GeneralUtility::getFileAbsFileName(\TYPO3\CMS\Core\Utility\GeneralUtility::llXmlAutoFileName($this->sourcePath, $this->languageKey));
        $targetPath = $this->languageKey !== 'default' && @is_file($localizedTargetPath) ? $localizedTargetPath : $this->sourcePath;
        try {
            $parsedTarget = $this->getParsedTargetData($targetPath);
        } catch (\TYPO3\CMS\Core\Localization\Exception\InvalidXmlFileException $e) {
            $parsedTarget = $this->getParsedTargetData($this->sourcePath);
        }
        $LOCAL_LANG = array();
        $LOCAL_LANG[$languageKey] = $parsedSource;
        \TYPO3\CMS\Core\Utility\ArrayUtility::mergeRecursiveWithOverrule($LOCAL_LANG[$languageKey], $parsedTarget);
        return $LOCAL_LANG;
    }

    protected function doParsingFromRootForElement(\SimpleXMLElement $root, $element) {
        $bodyOfFileTag = $root->data->languageKey;
        // Check if the source llxml file contains localized records
        $localizedBodyOfFileTag = $root->data->xpath('languageKey[@index=\'' . $this->languageKey . '\']');
        if ($element === 'source' || $this->languageKey === 'default') {
            $parsedData = $this->getParsedDataForElement($bodyOfFileTag, $element);
        } else {
            $parsedData = array();
        }
        if ($element === 'target' && isset($localizedBodyOfFileTag[0]) && $localizedBodyOfFileTag[0] instanceof \SimpleXMLElement) {
            $parsedDataTarget = $this->getParsedDataForElement($localizedBodyOfFileTag[0], $element);
            $mergedData = $parsedDataTarget + $parsedData;
            if ($this->languageKey === 'default') {
                $parsedData = array_intersect_key($mergedData, $parsedData, $parsedDataTarget);
            } else {
                $parsedData = array_intersect_key($mergedData, $parsedDataTarget);
            }
        }
        return $parsedData;
    }

    protected function getParsedDataForElement(\SimpleXMLElement $bodyOfFileTag, $element) {
        $parsedData = array();
        $children = $bodyOfFileTag->children();
        if ($children->count() == 0) {
            // Check for externally-referenced resource:
            // <languageKey index="fr">EXT:yourext/path/to/localized/locallang.xml</languageKey>
            $reference = sprintf('%s', $bodyOfFileTag);
            if (substr($reference, -4) === '.xml') {
                return $this->getParsedTargetData(\TYPO3\CMS\Core\Utility\GeneralUtility::getFileAbsFileName($reference));
            }
        }
        foreach ($children as $translationElement) {
            if ($translationElement->getName() === 'label') {
                // If restype would be set, it could be metadata from Gettext to XLIFF conversion (and we don't need this data)
                $parsedData[(string) $translationElement['index']][0] = array(
                    $element => (string) $translationElement
                );
            }
        }
        return $parsedData;
    }

    protected function doParsingFromRoot(\SimpleXMLElement $root) {
        return $this->doParsingFromRootForElement($root, 'source');
    }

    protected function doParsingTargetFromRoot(\SimpleXMLElement $root) {
        return $this->doParsingFromRootForElement($root, 'target');
    }

    public function getParsedTargetData($path) {
        if (!isset($this->parsedTargetFiles[$path])) {
            $this->parsedTargetFiles[$path] = $this->parseXmlTargetFile($path);
        }
        return $this->parsedTargetFiles[$path];
    }

    protected function parseXmlTargetFile($targetPath) {
        $rootXmlNode = FALSE;
        if (file_exists($targetPath)) {
            $xmlContent = file_get_contents($targetPath);
            // Disables the functionality to allow external entities to be loaded when parsing the XML, must be kept
            $previousValueOfEntityLoader = libxml_disable_entity_loader(TRUE);
            $rootXmlNode = simplexml_load_string($xmlContent, 'SimpleXmlElement', \LIBXML_NOWARNING);
            libxml_disable_entity_loader($previousValueOfEntityLoader);
        }
        if (!isset($rootXmlNode) || $rootXmlNode === FALSE) {
            throw new \TYPO3\CMS\Core\Localization\Exception\InvalidXmlFileException('The path provided does not point to existing and accessible well-formed XML file (' . $targetPath . ').', 1278155987);
        }
        return $this->doParsingTargetFromRoot($rootXmlNode);
    }

}