LocallangArrayParser.php

Go to the documentation of this file.

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

class LocallangArrayParser implements \TYPO3\CMS\Core\Localization\Parser\LocalizationParserInterface {

    protected $cacheFileName;

    protected $csConvObj;

    protected $hashSource;

    protected $sourceCharset;

    protected $targetCharset;

    public function __construct() {
        $this->createCsConvObject();
    }

    public function getParsedData($sourcePath, $languageKey, $charset = '') {
        $this->validateParameters($sourcePath, $languageKey);
        $this->setCharsets($languageKey, $charset);
        $this->generateCacheFileName($sourcePath, $languageKey);
        if (!file_exists($this->cacheFileName)) {
            $LOCAL_LANG = $this->generateCacheFile($sourcePath, $languageKey);
        } else {
            $LOCAL_LANG = $this->getContentFromCacheFile();
        }
        $xliff = $this->convertToXLIFF($LOCAL_LANG);
        return $xliff;
    }

    protected function convertToXLIFF(array $LOCAL_LANG) {
        foreach ($LOCAL_LANG as &$keysLabels) {
            foreach ($keysLabels as &$label) {
                $label = array(
                    0 => array(
                        'target' => $label
                    )
                );
            }
            unset($label);
        }
        return $LOCAL_LANG;
    }

    protected function createCsConvObject() {
        if (is_object($GLOBALS['LANG'])) {
            $this->csConvObj = $GLOBALS['LANG']->csConvObj;
        } elseif (is_object($GLOBALS['TSFE'])) {
            $this->csConvObj = $GLOBALS['TSFE']->csConvObj;
        } else {
            $this->csConvObj = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance('TYPO3\\CMS\\Core\\Charset\\CharsetConverter');
        }
    }

    protected function generateCacheFile($sourcePath, $languageKey) {
        $LOCAL_LANG = array();
        // Get PHP data
        include $sourcePath;
        if (!is_array($LOCAL_LANG)) {
            $fileName = \TYPO3\CMS\Core\Utility\PathUtility::stripPathSitePrefix($sourcePath);
            throw new \RuntimeException('TYPO3 Fatal Error: "' . $fileName . '" is no TYPO3 language file!', 1308898491);
        }
        // Converting the default language (English)
        // This needs to be done for a few accented loan words and extension names
        if (is_array($LOCAL_LANG['default']) && $this->targetCharset !== 'utf-8') {
            foreach ($LOCAL_LANG['default'] as &$labelValue) {
                $labelValue = $this->csConvObj->conv($labelValue, 'utf-8', $this->targetCharset);
            }
            unset($labelValue);
        }
        if ($languageKey !== 'default' && is_array($LOCAL_LANG[$languageKey]) && $this->sourceCharset != $this->targetCharset) {
            foreach ($LOCAL_LANG[$languageKey] as &$labelValue) {
                $labelValue = $this->csConvObj->conv($labelValue, $this->sourceCharset, $this->targetCharset);
            }
            unset($labelValue);
        }
        // Cache the content now:
        if (isset($LOCAL_LANG[$languageKey])) {
            $serContent = array('origFile' => $this->hashSource, 'LOCAL_LANG' => array('default' => $LOCAL_LANG['default'], $languageKey => $LOCAL_LANG[$languageKey]));
        } else {
            $serContent = array('origFile' => $this->hashSource, 'LOCAL_LANG' => array('default' => $LOCAL_LANG['default']));
        }
        $res = \TYPO3\CMS\Core\Utility\GeneralUtility::writeFileToTypo3tempDir($this->cacheFileName, serialize($serContent));
        if ($res) {
            throw new \RuntimeException('TYPO3 Fatal Error: "' . $res, 1308898501);
        }
        return $LOCAL_LANG;
    }

    protected function generateCacheFileName($sourcePath, $languageKey) {
        $this->hashSource = \TYPO3\CMS\Core\Utility\PathUtility::stripPathSitePrefix($sourcePath) . '|' . date('d-m-Y H:i:s', filemtime($sourcePath)) . '|version=2.3';
        $this->cacheFileName = PATH_site . 'typo3temp/llxml/' . substr(basename($sourcePath), 10, 15) . '_' . \TYPO3\CMS\Core\Utility\GeneralUtility::shortMD5($this->hashSource) . '.' . $languageKey . '.' . $this->targetCharset . '.cache';
    }

    protected function getContentFromCacheFile() {
        $serContent = (array) unserialize(file_get_contents($this->cacheFileName));
        $LOCAL_LANG = $serContent['LOCAL_LANG'];
        return (array) $LOCAL_LANG;
    }

    protected function isWithinWebRoot($fileName) {
        return (bool) \TYPO3\CMS\Core\Utility\GeneralUtility::getFileAbsFileName($fileName);
    }

    protected function setCharsets($languageKey, $charset) {
        $this->sourceCharset = $this->csConvObj->parse_charset($this->csConvObj->charSetArray[$languageKey] ?: 'utf-8');
        if ($charset) {
            $this->targetCharset = $this->csConvObj->parse_charset($charset);
        } else {
            $this->targetCharset = 'utf-8';
        }
    }

    protected function validateParameters($sourcePath, $languageKey) {
        if (!$this->isWithinWebRoot($sourcePath) || !@is_file($sourcePath) || !$languageKey) {
            throw new \RuntimeException(sprintf('Invalid source path (%s) or languageKey (%s)', $sourcePath, $languageKey), 1309245002);
        }
    }

}