class.ilCachedLanguage.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
require_once "./Services/GlobalCache/classes/class.ilGlobalCache.php";
 
class ilCachedLanguage
{
    protected \ilGlobalCache $global_cache;
    protected bool $loaded = false;
    protected string $language_key = "en";
    protected array $translations = array();
    protected static array $instances = array();
 
    protected function __construct(string $language_key)
    {
        $this->setLanguageKey($language_key);
        $this->global_cache = ilGlobalCache::getInstance(ilGlobalCache::COMP_CLNG);
        $this->readFromCache();
        if (!$this->getLoaded()) {
            $this->readFromDB();
            $this->writeToCache();
            $this->setLoaded(true);
        }
    }
 
    public function isActive(): bool
    {
        return $this->global_cache->isActive();
    }
 
    protected function readFromCache(): void
    {
        if ($this->global_cache->isActive()) {
            $translations = $this->global_cache->get("translations_" . $this->getLanguageKey());
            if (is_array($translations)) {
                $this->setTranslations($translations);
                $this->setLoaded(true);
            }
        }
    }
 
    public function writeToCache(): void
    {
        if ($this->global_cache->isActive()) {
            $this->global_cache->set("translations_" . $this->getLanguageKey(), $this->getTranslations());
        }
    }
 
    public function deleteInCache(): void
    {
        if ($this->global_cache->isActive()) {
            $this->global_cache->delete("translations_" . $this->getLanguageKey());
            $this->setLoaded(false);
        }
    }
 
    protected function readFromDB(): void
    {
        global $DIC;
        $ilDB = $DIC->database();
 
        $q = 'SELECT module, lang_array FROM lng_modules WHERE lang_key = %s';
        $res = $ilDB->queryF($q, array( "text" ), array( $this->getLanguageKey() ));
        $translations = array();
        while ($set = $ilDB->fetchObject($res)) {
            try {
                $lang_array = unserialize($set->lang_array, ['allowed_classes' => false]);
            } catch (Throwable $t) {
                continue;
            }
            if (is_array($lang_array)) {
                $translations[$set->module] = $lang_array;
            }
        }
        $this->setTranslations($translations);
    }
 
    public static function getInstance($key): self
    {
        if (!isset(self::$instances[$key])) {
            self::$instances[$key] = new self($key);
        }
 
        return self::$instances[$key];
    }
 
    public function flush(): void
    {
        if ($this->global_cache->isActive()) {
            $this->global_cache->flush();
        }
        $this->readFromDB();
        $this->writeToCache();
    }
 
    public function setLanguageKey(string $language_key): void
    {
        $this->language_key = $language_key;
    }
 
    public function getLanguageKey(): string
    {
        return $this->language_key;
    }
 
    public function setLoaded(bool $loaded): void
    {
        $this->loaded = $loaded;
    }
 
    public function getLoaded(): bool
    {
        return $this->loaded;
    }
 
    public function setTranslations(array $translations): void
    {
        $this->translations = $translations;
    }
 
    public function getTranslations(): array
    {
        return $this->translations;
    }
}