看板初始化提交

2026-06-01 21:23:12 -07:00
commit 27411ebedc
1827 changed files with 192340 additions and 0 deletions
@@ -0,0 +1,214 @@
+<?php
+
+namespace Kanboard\Core;
+
+/**
+ * Translator class
+ *
+ * @package core
+ * @author  Frederic Guillot
+ */
+class Translator
+{
+    /**
+     * Locale
+     *
+     * @static
+     * @access public
+     * @var array
+     */
+    public static $locales = array();
+
+    /**
+     * Instance
+     *
+     * @static
+     * @access private
+     * @var Translator
+     */
+    private static $instance = null;
+
+    /**
+     * Get instance
+     *
+     * @static
+     * @access public
+     * @return Translator
+     */
+    public static function getInstance()
+    {
+        if (self::$instance === null) {
+            self::$instance = new self;
+        }
+
+        return self::$instance;
+    }
+
+    /**
+     * Get a translation
+     *
+     * $translator->translate('I have %d kids', 5);
+     *
+     * @access public
+     * @param  string   $identifier       Default string
+     * @return string
+     */
+    public function translate($identifier)
+    {
+        $args = func_get_args();
+
+        array_shift($args);
+        array_unshift($args, $this->get($identifier, $identifier));
+
+        foreach ($args as &$arg) {
+            $arg = htmlspecialchars((string) $arg, ENT_QUOTES, 'UTF-8', false);
+        }
+
+        return call_user_func_array(
+            'sprintf',
+            $args
+        );
+    }
+
+    /**
+     * Get a translation with no HTML escaping
+     *
+     * $translator->translateNoEscaping('I have %d kids', 5);
+     *
+     * @access public
+     * @param  string   $identifier       Default string
+     * @return string
+     */
+    public function translateNoEscaping($identifier)
+    {
+        $args = func_get_args();
+
+        array_shift($args);
+        array_unshift($args, $this->get($identifier, $identifier));
+
+        return call_user_func_array(
+            'sprintf',
+            $args
+        );
+    }
+
+    /**
+     * Get a formatted number
+     *
+     * $translator->number(1234.56);
+     *
+     * @access public
+     * @param  float    $number   Number to format
+     * @return string
+     */
+    public function number($number)
+    {
+        return number_format(
+            $number,
+            $this->get('number.decimals', 2),
+            $this->get('number.decimals_separator', '.'),
+            $this->get('number.thousands_separator', ',')
+        );
+    }
+
+    /**
+     * Get a formatted currency number
+     *
+     * $translator->currency(1234.56);
+     *
+     * @access public
+     * @param  float    $amount   Number to format
+     * @return string
+     */
+    public function currency($amount)
+    {
+        $position = $this->get('currency.position', 'before');
+        $symbol = $this->get('currency.symbol', '$');
+        $str = '';
+
+        if ($position === 'before') {
+            $str .= $symbol;
+        }
+
+        $str .= $this->number($amount);
+
+        if ($position === 'after') {
+            $str .= ' '.$symbol;
+        }
+
+        return $str;
+    }
+
+    /**
+     * Get an identifier from the translations or return the default
+     *
+     * @access public
+     * @param  string   $identifier   Locale identifier
+     * @param  string   $default      Default value
+     * @return string
+     */
+    public function get($identifier, $default = '')
+    {
+        if (isset(self::$locales[$identifier])) {
+            return self::$locales[$identifier];
+        } else {
+            return $default;
+        }
+    }
+
+    /**
+     * Load translations
+     *
+     * @static
+     * @access public
+     * @param  string   $languageCode   Locale code: fr_FR
+     * @param  string   $localeDir      Locale folder
+     * @return boolean  True if the translation file has been loaded
+     */
+    public static function load($languageCode, $localeDir = '')
+    {
+        if (! preg_match('/^[a-z]{2}(_[a-zA-Z]{2,4}(_[a-zA-Z]{2,4})?)?$/', $languageCode)) {
+            return false;
+        }
+
+        if ($localeDir === '') {
+            $localeDir = self::getDefaultFolder();
+        }
+
+        $baseDir = realpath($localeDir);
+        if ($baseDir === false) {
+            return false;
+        }
+
+        $realFilePath = realpath(implode(DIRECTORY_SEPARATOR, [$localeDir, $languageCode, 'translations.php']));
+
+        if ($realFilePath !== false && strpos($realFilePath, $baseDir) === 0) {
+            self::$locales = array_merge(self::$locales, require($realFilePath));
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * Clear locales stored in memory
+     *
+     * @static
+     * @access public
+     */
+    public static function unload()
+    {
+        self::$locales = array();
+    }
+
+    /**
+     * Get default locales folder
+     *
+     * @access public
+     * @return string
+     */
+    public static function getDefaultFolder()
+    {
+        return implode(DIRECTORY_SEPARATOR, array(__DIR__, '..', 'Locale'));
+    }
+}