bibliotheca-php/webclient/lib/i18n.class.php

<?php
/**
 * Bibliotheca
 *
 * Copyright 2018-2024 Johannes Keßler
 *
 * This program is free software: you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation, either version 3 of the License, or
 *  (at your option) any later version.
 *
 *  This program is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with this program.  If not, see http://www.gnu.org/licenses/gpl-3.0.
 */

class I18n {
    /**
     * @var string The iso 3 lang code
     */
    private string $_iso3 = 'eng';

    /**
     * @var string The iso 2 lang code
     */
    private string $_iso2 = 'en';

    /**
     * @var array The loaded lang information from the file
     */
    private array $_langData = array();

    /**
     * @var array The fallback lang data.
     */
    private array $_langDataFallback = array();

    /**
     * Translation constructor.
     */
    public function __construct() {
        // load fallback
        $this->_langDataFallback = parse_ini_file(PATH_ABSOLUTE.'/i18n/eng.ini');
        if(!$this->_langDataFallback) {
            Summoner::sysLog('[ERROR] Missing fallback language file!');
        }

        if(defined('FRONTEND_LANGUAGE')) {
            $this->_iso3 = FRONTEND_LANGUAGE['iso3'];
            $this->_iso2 = FRONTEND_LANGUAGE['iso2'];
            $_langFile = PATH_ABSOLUTE.'/i18n/'.$this->_iso3.'.ini';
            if(file_exists($_langFile)) {
                $_langData = parse_ini_file($_langFile);
                if($_langData !== false) {
                    $this->_langData = $_langData;
                }
            }
        }
        else {
            $this->_langData = $this->_langDataFallback;
        }
    }

    public function twoCharLang(): string {
        return $this->_iso2;
    }

    /**
     * Return text for given key for currently loaded lang
     * uses vsprintf or sprintf for placeholders in key
     *
     * @param string $key
     * @param mixed $replace
     * @return string
     */
    public function t(string $key, mixed $replace=''): string {
        $ret = $key;
        $_langWorkWith = $this->_langData;
        if(isset($this->_langData[$key])) {
            $ret = $this->_langData[$key];
        } elseif(!DEBUG && isset($this->_langDataFallback[$key])) {
            $ret = $this->_langDataFallback[$key];
            $_langWorkWith = $this->_langDataFallback;
        }

        // the value is another key
        // the parse_ini_file interpolation with ${} does not work with existing values from the file itself
        if(str_starts_with($ret, "reuse.")) {
            $_ret = str_replace("reuse.","",$ret);
            if(isset($_langWorkWith[$_ret])) {
                $ret = $_langWorkWith[$_ret];
            }
        }

        if(!empty($replace)) {
            if(is_array($replace)) {
                $ret = vsprintf($ret, $replace);
            } else {
                $ret = sprintf($ret, $replace);
            }
        }
        return $ret;
    }
}