LanguageStore.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
/*
 * This file is part of the TYPO3 CMS project.
 *
 * It is free software; you can redistribute it and/or modify it under
 * the terms of the GNU General Public License, either version 2
 * of the License, or any later version.
 *
 * For the full copyright and license information, please read the
 * LICENSE.txt file that was distributed with this source code.
 *
 * The TYPO3 project - inspiring people to share!
 */
 
namespace ‪TYPO3\CMS\Core\Localization;
 
use ‪TYPO3\CMS\Core\Localization\Exception\FileNotFoundException;
use ‪TYPO3\CMS\Core\Localization\Exception\InvalidParserException;
use TYPO3\CMS\Core\Package\PackageManager;
use ‪TYPO3\CMS\Core\SingletonInterface;
use ‪TYPO3\CMS\Core\Utility\GeneralUtility;
use ‪TYPO3\CMS\Core\Utility\PathUtility;
 
class ‪LanguageStore implements ‪SingletonInterface
{
    protected ‪$supportedExtensions;
 
    protected ‪$configuration;
 
    protected $data;
 
    public function __construct(private readonly PackageManager $packageManager)
    {
        $this->‪initialize();
    }
 
    public function ‪initialize()
    {
        if (isset(‪$GLOBALS['TYPO3_CONF_VARS']['SYS']['lang']['format']['priority']) && trim(‪$GLOBALS['TYPO3_CONF_VARS']['SYS']['lang']['format']['priority']) !== '') {
            $this->supportedExtensions = ‪GeneralUtility::trimExplode(',', ‪$GLOBALS['TYPO3_CONF_VARS']['SYS']['lang']['format']['priority']);
        } else {
            $this->supportedExtensions = ['xlf'];
        }
    }
 
    public function ‪hasData($fileReference, $languageKey)
    {
        if (isset($this->‪data[$fileReference][$languageKey]) && is_array($this->‪data[$fileReference][$languageKey])) {
            return true;
        }
        return false;
    }
 
    public function getData($fileReference)
    {
        return $this->‪data[$fileReference];
    }
 
    public function getDataByLanguage($fileReference, $languageKey)
    {
        return $this->‪data[$fileReference][$languageKey] ?? [];
    }
 
    public function ‪setData($fileReference, $languageKey, $data)
    {
        $this->‪data[$fileReference][$languageKey] = $data;
        return $this;
    }
 
    public function ‪flushData($fileReference)
    {
        unset($this->‪data[$fileReference]);
        return $this;
    }
 
    public function ‪setConfiguration($fileReference, $languageKey)
    {
        $this->configuration[$fileReference] = [
            'fileReference' => $fileReference,
            'fileExtension' => false,
            'parserClass' => null,
            'languageKey' => $languageKey,
        ];
        if (‪PathUtility::isExtensionPath($fileReference)) {
            $packageKey = $this->packageManager->extractPackageKeyFromPackagePath($fileReference);
            $relativeFileName = substr($fileReference, strlen($packageKey) + 5);
            $directory = dirname($relativeFileName);
            $fileName = basename($relativeFileName);
            $this->configuration[$fileReference]['localizedLabelsPathPattern'] = sprintf(
                '/%%1$s/%s/%s%%1$s.%s',
                $packageKey,
                ($directory ? $directory . '/' : ''),
                $fileName
            );
        }
        $fileWithoutExtension = GeneralUtility::getFileAbsFileName($this->‪getFileReferenceWithoutExtension($fileReference));
        foreach ($this->supportedExtensions as $extension) {
            if (@is_file($fileWithoutExtension . '.' . $extension)) {
                $this->configuration[$fileReference]['fileReference'] = $fileWithoutExtension . '.' . $extension;
                $this->configuration[$fileReference]['fileExtension'] = $extension;
                break;
            }
        }
        if ($this->configuration[$fileReference]['fileExtension'] === false) {
            throw new ‪FileNotFoundException(sprintf('Source localization file (%s) not found', $fileReference), 1306410755);
        }
        $extension = $this->configuration[$fileReference]['fileExtension'];
        if (isset(‪$GLOBALS['TYPO3_CONF_VARS']['SYS']['lang']['parser'][$extension]) && trim(‪$GLOBALS['TYPO3_CONF_VARS']['SYS']['lang']['parser'][$extension]) !== '') {
            $this->configuration[$fileReference]['parserClass'] = ‪$GLOBALS['TYPO3_CONF_VARS']['SYS']['lang']['parser'][$extension];
        } else {
            throw new ‪InvalidParserException('TYPO3 Fatal Error: l10n parser for file extension "' . $extension . '" is not configured! Please check you configuration.', 1301579637);
        }
        if (!class_exists($this->configuration[$fileReference]['parserClass']) || trim($this->configuration[$fileReference]['parserClass']) === '') {
            throw new ‪InvalidParserException('TYPO3 Fatal Error: l10n parser "' . $this->configuration[$fileReference]['parserClass'] . '" cannot be found or is an empty parser!', 1270853900);
        }
        return $this;
    }
 
    public function ‪getFileReferenceWithoutExtension($fileReference)
    {
        if (!isset($this->configuration[$fileReference]['fileReferenceWithoutExtension'])) {
            $this->configuration[$fileReference]['fileReferenceWithoutExtension'] = preg_replace('/\\.[a-z0-9]+$/i', '', $fileReference);
        }
        return $this->configuration[$fileReference]['fileReferenceWithoutExtension'];
    }
 
    public function ‪getParserInstance($fileReference)
    {
        if (isset($this->configuration[$fileReference]['parserClass']) && trim($this->configuration[$fileReference]['parserClass']) !== '') {
            return GeneralUtility::makeInstance((string)$this->configuration[$fileReference]['parserClass']);
        }
        throw new ‪InvalidParserException(sprintf('Invalid parser configuration for the current file (%s)', $fileReference), 1307293692);
    }
 
    public function ‪getAbsoluteFileReference($fileReference)
    {
        if (isset($this->configuration[$fileReference]['fileReference']) && trim($this->configuration[$fileReference]['fileReference']) !== '') {
            return (string)$this->configuration[$fileReference]['fileReference'];
        }
        throw new \InvalidArgumentException(sprintf('Invalid file reference configuration for the current file (%s)', $fileReference), 1307293693);
    }
 
    public function ‪getLocalizedLabelsPathPattern(string $fileReference): string
    {
        if (empty($this->configuration[$fileReference]['localizedLabelsPathPattern'])) {
            throw new \InvalidArgumentException(sprintf('Invalid file reference configuration for the current file (%s)', $fileReference), 1635863703);
        }
 
        return (string)$this->configuration[$fileReference]['localizedLabelsPathPattern'];
    }
 
    public function ‪getSupportedExtensions()
    {
        return ‪$this->supportedExtensions;
    }
}