123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663 |
- <?php
- declare(strict_types=1);
- namespace OC\L10N;
- use OCP\App\AppPathNotFoundException;
- use OCP\App\IAppManager;
- use OCP\ICache;
- use OCP\ICacheFactory;
- use OCP\IConfig;
- use OCP\IRequest;
- use OCP\IUser;
- use OCP\IUserSession;
- use OCP\L10N\IFactory;
- use OCP\L10N\ILanguageIterator;
- use function is_null;
- class Factory implements IFactory {
-
- protected $requestLanguage = '';
-
- protected $instances = [];
-
- protected $availableLanguages = [];
-
- protected $localeCache = [];
-
- protected $availableLocales = [];
-
- protected $pluralFunctions = [];
- public const COMMON_LANGUAGE_CODES = [
- 'en', 'es', 'fr', 'de', 'de_DE', 'ja', 'ar', 'ru', 'nl', 'it',
- 'pt_BR', 'pt_PT', 'da', 'fi_FI', 'nb_NO', 'sv', 'tr', 'zh_CN', 'ko'
- ];
-
- public const RTL_LANGUAGES = [
- 'ar',
- 'fa',
- 'he',
- 'ps',
- 'ug',
- 'ur_PK',
- ];
- private ICache $cache;
- public function __construct(
- protected IConfig $config,
- protected IRequest $request,
- protected IUserSession $userSession,
- ICacheFactory $cacheFactory,
- protected string $serverRoot,
- protected IAppManager $appManager,
- ) {
- $this->cache = $cacheFactory->createLocal('L10NFactory');
- }
-
- public function get($app, $lang = null, $locale = null) {
- return new LazyL10N(function () use ($app, $lang, $locale) {
- $app = $this->appManager->cleanAppId($app);
- if ($lang !== null) {
- $lang = str_replace(['\0', '/', '\\', '..'], '', $lang);
- }
- $forceLang = $this->request->getParam('forceLanguage') ?? $this->config->getSystemValue('force_language', false);
- if (is_string($forceLang)) {
- $lang = $forceLang;
- }
- $forceLocale = $this->config->getSystemValue('force_locale', false);
- if (is_string($forceLocale)) {
- $locale = $forceLocale;
- }
- if ($lang === null || !$this->languageExists($app, $lang)) {
- $lang = $this->findLanguage($app);
- }
- if ($locale === null || !$this->localeExists($locale)) {
- $locale = $this->findLocale($lang);
- }
- if (!isset($this->instances[$lang][$app])) {
- $this->instances[$lang][$app] = new L10N(
- $this,
- $app,
- $lang,
- $locale,
- $this->getL10nFilesForApp($app, $lang)
- );
- }
- return $this->instances[$lang][$app];
- });
- }
-
- public function findLanguage(?string $appId = null): string {
-
- $forceLang = $this->request->getParam('forceLanguage') ?? $this->config->getSystemValue('force_language', false);
- if (is_string($forceLang)) {
- $this->requestLanguage = $forceLang;
- }
-
- if ($this->requestLanguage !== '' && $this->languageExists($appId, $this->requestLanguage)) {
- return $this->requestLanguage;
- }
-
- if ($this->config->getSystemValueBool('installed', false)) {
- $userId = !is_null($this->userSession->getUser()) ? $this->userSession->getUser()->getUID() : null;
- if (!is_null($userId)) {
- $userLang = $this->config->getUserValue($userId, 'core', 'lang', null);
- } else {
- $userLang = null;
- }
- } else {
- $userId = null;
- $userLang = null;
- }
- if ($userLang) {
- $this->requestLanguage = $userLang;
- if ($this->languageExists($appId, $userLang)) {
- return $userLang;
- }
- }
-
- try {
-
- $lang = $this->getLanguageFromRequest($appId);
- if ($userId !== null && $appId === null && !$userLang) {
- $this->config->setUserValue($userId, 'core', 'lang', $lang);
- }
- return $lang;
- } catch (LanguageNotFoundException $e) {
-
- $defaultLanguage = $this->config->getSystemValue('default_language', false);
- if ($defaultLanguage !== false && $this->languageExists($appId, $defaultLanguage)) {
- return $defaultLanguage;
- }
- }
-
- return 'en';
- }
- public function findGenericLanguage(?string $appId = null): string {
-
- $forcedLanguage = $this->request->getParam('forceLanguage') ?? $this->config->getSystemValue('force_language', false);
- if ($forcedLanguage !== false) {
- return $forcedLanguage;
- }
-
- $defaultLanguage = $this->config->getSystemValue('default_language', false);
- if ($defaultLanguage !== false && $this->languageExists($appId, $defaultLanguage)) {
- return $defaultLanguage;
- }
-
- if (!$this->config->getSystemValueBool('installed', false)) {
- return 'en';
- }
-
- $user = $this->userSession->getUser();
- if ($user !== null) {
- $userLang = $this->config->getUserValue($user->getUID(), 'core', 'lang', null);
- if ($userLang !== null) {
- return $userLang;
- }
- }
-
- try {
- return $this->getLanguageFromRequest($appId);
- } catch (LanguageNotFoundException $e) {
-
- }
-
- return 'en';
- }
-
- public function findLocale($lang = null) {
- $forceLocale = $this->config->getSystemValue('force_locale', false);
- if (is_string($forceLocale) && $this->localeExists($forceLocale)) {
- return $forceLocale;
- }
- if ($this->config->getSystemValueBool('installed', false)) {
- $userId = $this->userSession->getUser() !== null ? $this->userSession->getUser()->getUID() : null;
- $userLocale = null;
- if ($userId !== null) {
- $userLocale = $this->config->getUserValue($userId, 'core', 'locale', null);
- }
- } else {
- $userId = null;
- $userLocale = null;
- }
- if ($userLocale && $this->localeExists($userLocale)) {
- return $userLocale;
- }
-
- $defaultLocale = $this->config->getSystemValue('default_locale', false);
- if ($defaultLocale !== false && $this->localeExists($defaultLocale)) {
- return $defaultLocale;
- }
-
- if ($lang !== null && $this->localeExists($lang)) {
- return $lang;
- }
-
- return 'en_US';
- }
-
- public function findLanguageFromLocale(string $app = 'core', ?string $locale = null) {
- if ($this->languageExists($app, $locale)) {
- return $locale;
- }
-
- $locale = explode('_', $locale)[0];
- if ($this->languageExists($app, $locale)) {
- return $locale;
- }
- }
-
- public function findAvailableLanguages($app = null): array {
- $key = $app;
- if ($key === null) {
- $key = 'null';
- }
- if ($availableLanguages = $this->cache->get($key)) {
- $this->availableLanguages[$key] = $availableLanguages;
- }
-
- if (!empty($this->availableLanguages[$key])) {
- return $this->availableLanguages[$key];
- }
- $available = ['en'];
- $dir = $this->findL10nDir($app);
- if (is_dir($dir)) {
- $files = scandir($dir);
- if ($files !== false) {
- foreach ($files as $file) {
- if (str_ends_with($file, '.json') && !str_starts_with($file, 'l10n')) {
- $available[] = substr($file, 0, -5);
- }
- }
- }
- }
-
- $theme = $this->config->getSystemValueString('theme');
- if (!empty($theme)) {
- $themeDir = $this->serverRoot . '/themes/' . $theme . substr($dir, strlen($this->serverRoot));
- if (is_dir($themeDir)) {
- $files = scandir($themeDir);
- if ($files !== false) {
- foreach ($files as $file) {
- if (str_ends_with($file, '.json') && !str_starts_with($file, 'l10n')) {
- $available[] = substr($file, 0, -5);
- }
- }
- }
- }
- }
- $this->availableLanguages[$key] = $available;
- $this->cache->set($key, $available, 60);
- return $available;
- }
-
- public function findAvailableLocales() {
- if (!empty($this->availableLocales)) {
- return $this->availableLocales;
- }
- $localeData = file_get_contents(\OC::$SERVERROOT . '/resources/locales.json');
- $this->availableLocales = \json_decode($localeData, true);
- return $this->availableLocales;
- }
-
- public function languageExists($app, $lang) {
- if ($lang === 'en') {
- return true;
- }
- $languages = $this->findAvailableLanguages($app);
- return in_array($lang, $languages);
- }
- public function getLanguageDirection(string $language): string {
- if (in_array($language, self::RTL_LANGUAGES, true)) {
- return 'rtl';
- }
- return 'ltr';
- }
- public function getLanguageIterator(?IUser $user = null): ILanguageIterator {
- $user = $user ?? $this->userSession->getUser();
- if ($user === null) {
- throw new \RuntimeException('Failed to get an IUser instance');
- }
- return new LanguageIterator($user, $this->config);
- }
-
- public function getUserLanguage(?IUser $user = null): string {
- $language = $this->config->getSystemValue('force_language', false);
- if ($language !== false) {
- return $language;
- }
- if ($user instanceof IUser) {
- $language = $this->config->getUserValue($user->getUID(), 'core', 'lang', null);
- if ($language !== null) {
- return $language;
- }
- if (($forcedLanguage = $this->request->getParam('forceLanguage')) !== null) {
- return $forcedLanguage;
- }
-
- if ($this->userSession->getUser() instanceof IUser &&
- $user->getUID() === $this->userSession->getUser()->getUID()) {
- try {
- return $this->getLanguageFromRequest();
- } catch (LanguageNotFoundException $e) {
- }
- }
- }
- return $this->request->getParam('forceLanguage') ?? $this->config->getSystemValueString('default_language', 'en');
- }
-
- public function localeExists($locale) {
- if ($locale === 'en') {
- return true;
- }
- if ($this->localeCache === []) {
- $locales = $this->findAvailableLocales();
- foreach ($locales as $l) {
- $this->localeCache[$l['code']] = true;
- }
- }
- return isset($this->localeCache[$locale]);
- }
-
- private function getLanguageFromRequest(?string $app = null): string {
- $header = $this->request->getHeader('ACCEPT_LANGUAGE');
- if ($header !== '') {
- $available = $this->findAvailableLanguages($app);
-
- sort($available);
- $preferences = preg_split('/,\s*/', strtolower($header));
- foreach ($preferences as $preference) {
- [$preferred_language] = explode(';', $preference);
- $preferred_language = str_replace('-', '_', $preferred_language);
- $preferred_language_parts = explode('_', $preferred_language);
- foreach ($available as $available_language) {
- if ($preferred_language === strtolower($available_language)) {
- return $this->respectDefaultLanguage($app, $available_language);
- }
- if (strtolower($available_language) === $preferred_language_parts[0] . '_' . end($preferred_language_parts)) {
- return $available_language;
- }
- }
-
- foreach ($available as $available_language) {
- if (substr($preferred_language, 0, 2) === $available_language) {
- return $available_language;
- }
- }
- }
- }
- throw new LanguageNotFoundException();
- }
-
- protected function respectDefaultLanguage(?string $app, string $lang): string {
- $result = $lang;
- $defaultLanguage = $this->config->getSystemValue('default_language', false);
-
-
- if (
- is_string($defaultLanguage) &&
- strtolower($lang) === 'de' &&
- strtolower($defaultLanguage) === 'de_de' &&
- $this->languageExists($app, 'de_DE')
- ) {
- $result = 'de_DE';
- }
- return $result;
- }
-
- private function isSubDirectory($sub, $parent) {
-
- if (str_contains($sub, '..')) {
- return false;
- }
-
- if (str_starts_with($sub, $parent)) {
- return true;
- }
- return false;
- }
-
- private function getL10nFilesForApp(string $app, string $lang): array {
- $languageFiles = [];
- $i18nDir = $this->findL10nDir($app);
- $transFile = strip_tags($i18nDir) . strip_tags($lang) . '.json';
- if (($this->isSubDirectory($transFile, $this->serverRoot . '/core/l10n/')
- || $this->isSubDirectory($transFile, $this->serverRoot . '/lib/l10n/')
- || $this->isSubDirectory($transFile, $this->appManager->getAppPath($app) . '/l10n/'))
- && file_exists($transFile)
- ) {
-
- $languageFiles[] = $transFile;
- }
-
- $theme = $this->config->getSystemValueString('theme');
- if (!empty($theme)) {
- $transFile = $this->serverRoot . '/themes/' . $theme . substr($transFile, strlen($this->serverRoot));
- if (file_exists($transFile)) {
- $languageFiles[] = $transFile;
- }
- }
- return $languageFiles;
- }
-
- protected function findL10nDir($app = null) {
- if (in_array($app, ['core', 'lib'])) {
- if (file_exists($this->serverRoot . '/' . $app . '/l10n/')) {
- return $this->serverRoot . '/' . $app . '/l10n/';
- }
- } elseif ($app) {
- try {
- return $this->appManager->getAppPath($app) . '/l10n/';
- } catch (AppPathNotFoundException) {
-
- }
- }
- return $this->serverRoot . '/core/l10n/';
- }
-
- public function getLanguages(): array {
- $forceLanguage = $this->config->getSystemValue('force_language', false);
- if ($forceLanguage !== false) {
- $l = $this->get('lib', $forceLanguage);
- $potentialName = $l->t('__language_name__');
- return [
- 'commonLanguages' => [[
- 'code' => $forceLanguage,
- 'name' => $potentialName,
- ]],
- 'otherLanguages' => [],
- ];
- }
- $languageCodes = $this->findAvailableLanguages();
- $reduceToLanguages = $this->config->getSystemValue('reduce_to_languages', []);
- if (!empty($reduceToLanguages)) {
- $languageCodes = array_intersect($languageCodes, $reduceToLanguages);
- }
- $commonLanguages = [];
- $otherLanguages = [];
- foreach ($languageCodes as $lang) {
- $l = $this->get('lib', $lang);
-
- $potentialName = $l->t('__language_name__');
- if ($l->getLanguageCode() === $lang && $potentialName[0] !== '_') {
- $ln = [
- 'code' => $lang,
- 'name' => $potentialName
- ];
- } elseif ($lang === 'en') {
- $ln = [
- 'code' => $lang,
- 'name' => 'English (US)'
- ];
- } else {
- $ln = [
- 'code' => $lang,
- 'name' => $lang
- ];
- }
-
-
- if (in_array($lang, self::COMMON_LANGUAGE_CODES)) {
- $commonLanguages[array_search($lang, self::COMMON_LANGUAGE_CODES)] = $ln;
- } else {
- $otherLanguages[] = $ln;
- }
- }
- ksort($commonLanguages);
-
- usort($otherLanguages, function ($a, $b) {
- if ($a['code'] === $a['name'] && $b['code'] !== $b['name']) {
-
- return 1;
- }
- if ($a['code'] !== $a['name'] && $b['code'] === $b['name']) {
-
- return -1;
- }
-
- return strcmp($a['name'], $b['name']);
- });
- return [
-
- 'commonLanguages' => array_values($commonLanguages),
- 'otherLanguages' => $otherLanguages
- ];
- }
- }
|