5 use Gettext\GettextTranslator
;
7 use Gettext\Translations
;
8 use Gettext\Translator
;
9 use Gettext\TranslatorInterface
;
10 use Shaarli\Config\ConfigManager
;
15 * Load Shaarli translations using 'gettext/gettext'.
16 * This class allows to either use PHP gettext extension, or a PHP implementation of gettext,
17 * with a fixed language, or dynamically using autoLocale().
19 * Translation files PO/MO files follow gettext standard and must be placed under:
20 * <translation path>/<language>/LC_MESSAGES/<domain>.[po|mo]
23 * - gettext extension is faster
24 * - gettext is very system dependent (PHP extension, the locale must be installed, and web server reloaded)
28 * - auto: use default setting (PHP implementation)
29 * - php: use PHP implementation
30 * - gettext: use gettext wrapper
31 * - translation.language:
32 * - auto: use autoLocale() and the language change according to user HTTP headers
33 * - fixed language: e.g. 'fr'
34 * - translation.extensions:
35 * - domain => translation_path: allow plugins and themes to extend the defaut extension
36 * The domain must be unique, and translation path must be relative, and contains the tree mentioned above.
43 * Core translations domain
45 const DEFAULT_DOMAIN
= 'shaarli';
48 * @var TranslatorInterface
50 protected $translator;
63 * Languages constructor.
65 * @param string $language lang determined by autoLocale(), can be overridden.
66 * @param ConfigManager $conf instance.
68 public function __construct($language, $conf)
71 $confLanguage = $this->conf
->get('translation.language', 'auto');
72 if ($confLanguage === 'auto' || ! $this->isValidLanguage($confLanguage)) {
73 $this->language
= substr($language, 0, 5);
75 $this->language
= $confLanguage;
78 if (! extension_loaded('gettext')
79 || in_array($this->conf
->get('translation.mode', 'auto'), ['auto', 'php'])
81 $this->initPhpTranslator();
83 $this->initGettextTranslator();
86 // Register default functions (e.g. '__()') to use our Translator
87 $this->translator
->register();
91 * Initialize the translator using php gettext extension (gettext dependency act as a wrapper).
93 protected function initGettextTranslator ()
95 $this->translator
= new GettextTranslator();
96 $this->translator
->setLanguage($this->language
);
97 $this->translator
->loadDomain(self
::DEFAULT_DOMAIN
, 'inc/languages');
99 foreach ($this->conf
->get('translation.extensions', []) as $domain => $translationPath) {
100 if ($domain !== self
::DEFAULT_DOMAIN
) {
101 $this->translator
->loadDomain($domain, $translationPath, false);
107 * Initialize the translator using a PHP implementation of gettext.
109 * Note that if language po file doesn't exist, errors are ignored (e.g. not installed language).
111 protected function initPhpTranslator()
113 $this->translator
= new Translator();
114 $translations = new Translations();
117 /** @var Translations $translations */
118 $translations = $translations->addFromPoFile('inc/languages/'. $this->language
.'/LC_MESSAGES/shaarli.po');
119 $translations->setDomain('shaarli');
120 $this->translator
->loadTranslations($translations);
121 } catch (\InvalidArgumentException
$e) {}
124 // Extension translations (plugins, themes, etc.).
125 foreach ($this->conf
->get('translation.extensions', []) as $domain => $translationPath) {
126 if ($domain === self
::DEFAULT_DOMAIN
) {
131 /** @var Translations $extension */
132 $extension = Translations
::fromPoFile($translationPath . $this->language
.'/LC_MESSAGES/'. $domain .'.po');
133 $extension->setDomain($domain);
134 $this->translator
->loadTranslations($extension);
135 } catch (\InvalidArgumentException
$e) {}
140 * Checks if a language string is valid.
142 * @param string $language e.g. 'fr' or 'en_US'
144 * @return bool true if valid, false otherwise
146 protected function isValidLanguage($language)
148 return preg_match('/^[a-z]{2}(_[A-Z]{2})?/', $language) === 1;
152 * Get the list of available languages for Shaarli.
154 * @return array List of available languages, with their label.
156 public static function getAvailableLanguages()
159 'auto' => t('Automatic'),
160 'en' => t('English'),