nextcloud / server

lib/private/L10N/Factory.php

Indentation +658 added lines, -658 removed lines

@@ -24,662 +24,662 @@
  * A factory that generates language instances
  */
 class Factory implements IFactory {
-	/** @var string */
-	protected $requestLanguage = '';
-
-	/**
-	 * cached instances
-	 * @var array Structure: Lang => App => \OCP\IL10N
-	 */
-	protected $instances = [];
-
-	/**
-	 * @var array Structure: App => string[]
-	 */
-	protected $availableLanguages = [];
-
-	/**
-	 * @var array
-	 */
-	protected $localeCache = [];
-
-	/**
-	 * @var array
-	 */
-	protected $availableLocales = [];
-
-	/**
-	 * @var array Structure: string => callable
-	 */
-	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'
-	];
-
-	/**
-	 * Keep in sync with `build/translation-checker.php`
-	 */
-	public const RTL_LANGUAGES = [
-		'ar', // Arabic
-		'fa', // Persian
-		'he', // Hebrew
-		'ps', // Pashto,
-		'ug', // 'Uyghurche / Uyghur
-		'ur_PK', // Urdu
-	];
-
-	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');
-	}
-
-	/**
-	 * Get a language instance
-	 *
-	 * @param string $app
-	 * @param string|null $lang
-	 * @param string|null $locale
-	 * @return \OCP\IL10N
-	 */
-	public function get($app, $lang = null, $locale = null) {
-		return new LazyL10N(function () use ($app, $lang, $locale) {
-			$app = $this->appManager->cleanAppId($app);
-			$lang = $this->cleanLanguage($lang);
-			$forceLang = $this->cleanLanguage($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;
-			}
-
-			$lang = $this->validateLanguage($app, $lang);
-
-			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];
-		});
-	}
-
-	/**
-	 * Remove some invalid characters before using a string as a language
-	 *
-	 * @psalm-taint-escape callable
-	 * @psalm-taint-escape cookie
-	 * @psalm-taint-escape file
-	 * @psalm-taint-escape has_quotes
-	 * @psalm-taint-escape header
-	 * @psalm-taint-escape html
-	 * @psalm-taint-escape include
-	 * @psalm-taint-escape ldap
-	 * @psalm-taint-escape shell
-	 * @psalm-taint-escape sql
-	 * @psalm-taint-escape unserialize
-	 */
-	private function cleanLanguage(?string $lang): ?string {
-		if ($lang === null) {
-			return null;
-		}
-		$lang = preg_replace('/[^a-zA-Z0-9.;,=-]/', '', $lang);
-		return str_replace('..', '', $lang);
-	}
-
-	/**
-	 * Check that $lang is an existing language and not null, otherwise return the language to use instead
-	 *
-	 * @psalm-taint-escape callable
-	 * @psalm-taint-escape cookie
-	 * @psalm-taint-escape file
-	 * @psalm-taint-escape has_quotes
-	 * @psalm-taint-escape header
-	 * @psalm-taint-escape html
-	 * @psalm-taint-escape include
-	 * @psalm-taint-escape ldap
-	 * @psalm-taint-escape shell
-	 * @psalm-taint-escape sql
-	 * @psalm-taint-escape unserialize
-	 */
-	private function validateLanguage(string $app, ?string $lang): string {
-		if ($lang === null || !$this->languageExists($app, $lang)) {
-			return $this->findLanguage($app);
-		} else {
-			return $lang;
-		}
-	}
-
-	/**
-	 * Find the best language
-	 *
-	 * @param string|null $appId App id or null for core
-	 *
-	 * @return string language If nothing works it returns 'en'
-	 */
-	public function findLanguage(?string $appId = null): string {
-		// Step 1: Forced language always has precedence over anything else
-		$forceLang = $this->cleanLanguage($this->request->getParam('forceLanguage')) ?? $this->config->getSystemValue('force_language', false);
-		if (is_string($forceLang)) {
-			$this->requestLanguage = $forceLang;
-		}
-
-		// Step 2: Return cached language
-		if ($this->requestLanguage !== '' && $this->languageExists($appId, $this->requestLanguage)) {
-			return $this->requestLanguage;
-		}
-
-		/**
-		 * Step 3: At this point Nextcloud might not yet be installed and thus the lookup
-		 * in the preferences table might fail. For this reason we need to check
-		 * whether the instance has already been installed
-		 *
-		 * @link https://github.com/owncloud/core/issues/21955
-		 */
-		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;
-			}
-		}
-
-		// Step 4: Check the request headers
-		try {
-			// Try to get the language from the Request
-			$lang = $this->getLanguageFromRequest($appId);
-			if ($userId !== null && $appId === null && !$userLang) {
-				$this->config->setUserValue($userId, 'core', 'lang', $lang);
-			}
-			return $lang;
-		} catch (LanguageNotFoundException $e) {
-			// Finding language from request failed fall back to default language
-			$defaultLanguage = $this->config->getSystemValue('default_language', false);
-			if ($defaultLanguage !== false && $this->languageExists($appId, $defaultLanguage)) {
-				return $defaultLanguage;
-			}
-		}
-
-		// Step 5: fall back to English
-		return 'en';
-	}
-
-	public function findGenericLanguage(?string $appId = null): string {
-		// Step 1: Forced language always has precedence over anything else
-		$forcedLanguage = $this->cleanLanguage($this->request->getParam('forceLanguage')) ?? $this->config->getSystemValue('force_language', false);
-		if ($forcedLanguage !== false) {
-			return $forcedLanguage;
-		}
-
-		// Step 2: Check if we have a default language
-		$defaultLanguage = $this->config->getSystemValue('default_language', false);
-		if ($defaultLanguage !== false && $this->languageExists($appId, $defaultLanguage)) {
-			return $defaultLanguage;
-		}
-
-		// Step 3: fall back to English
-		return 'en';
-	}
-
-	/**
-	 * find the best locale
-	 *
-	 * @param string $lang
-	 * @return null|string
-	 */
-	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;
-		}
-
-		// Default : use system default locale
-		$defaultLocale = $this->config->getSystemValue('default_locale', false);
-		if ($defaultLocale !== false && $this->localeExists($defaultLocale)) {
-			return $defaultLocale;
-		}
-
-		// If no user locale set, use lang as locale
-		if ($lang !== null && $this->localeExists($lang)) {
-			return $lang;
-		}
-
-		// At last, return USA
-		return 'en_US';
-	}
-
-	/**
-	 * find the matching lang from the locale
-	 *
-	 * @param string $app
-	 * @param string $locale
-	 * @return null|string
-	 */
-	public function findLanguageFromLocale(string $app = 'core', ?string $locale = null) {
-		if ($this->languageExists($app, $locale)) {
-			return $locale;
-		}
-
-		// Try to split e.g: fr_FR => fr
-		$locale = explode('_', $locale)[0];
-		if ($this->languageExists($app, $locale)) {
-			return $locale;
-		}
-	}
-
-	/**
-	 * Find all available languages for an app
-	 *
-	 * @param string|null $app App id or null for core
-	 * @return string[] an array of available languages
-	 */
-	public function findAvailableLanguages($app = null): array {
-		$key = $app;
-		if ($key === null) {
-			$key = 'null';
-		}
-
-		if ($availableLanguages = $this->cache->get($key)) {
-			$this->availableLanguages[$key] = $availableLanguages;
-		}
-
-		// also works with null as key
-		if (!empty($this->availableLanguages[$key])) {
-			return $this->availableLanguages[$key];
-		}
-
-		$available = ['en']; //english is always available
-		$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);
-					}
-				}
-			}
-		}
-
-		// merge with translations from theme
-		$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;
-	}
-
-	/**
-	 * @return array|mixed
-	 */
-	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;
-	}
-
-	/**
-	 * @param string|null $app App id or null for core
-	 * @param string $lang
-	 * @return bool
-	 */
-	public function languageExists($app, $lang) {
-		if ($lang === 'en') { //english is always available
-			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);
-	}
-
-	/**
-	 * Return the language to use when sending something to a user
-	 *
-	 * @param IUser|null $user
-	 * @return string
-	 * @since 20.0.0
-	 */
-	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;
-			}
-
-			$forcedLanguage = $this->cleanLanguage($this->request->getParam('forceLanguage'));
-			if ($forcedLanguage !== null) {
-				return $forcedLanguage;
-			}
-
-			// Use language from request
-			if ($this->userSession->getUser() instanceof IUser
-				&& $user->getUID() === $this->userSession->getUser()->getUID()) {
-				try {
-					return $this->getLanguageFromRequest();
-				} catch (LanguageNotFoundException $e) {
-				}
-			}
-		}
-
-		return $this->cleanLanguage($this->request->getParam('forceLanguage')) ?? $this->config->getSystemValueString('default_language', 'en');
-	}
-
-	/**
-	 * @param string $locale
-	 * @return bool
-	 */
-	public function localeExists($locale) {
-		if ($locale === 'en') { //english is always available
-			return true;
-		}
-
-		if ($this->localeCache === []) {
-			$locales = $this->findAvailableLocales();
-			foreach ($locales as $l) {
-				$this->localeCache[$l['code']] = true;
-			}
-		}
-
-		return isset($this->localeCache[$locale]);
-	}
-
-	/**
-	 * @throws LanguageNotFoundException
-	 */
-	private function getLanguageFromRequest(?string $app = null): string {
-		$header = $this->cleanLanguage($this->request->getHeader('ACCEPT_LANGUAGE'));
-		if ($header !== '') {
-			$available = $this->findAvailableLanguages($app);
-
-			// E.g. make sure that 'de' is before 'de_DE'.
-			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;
-					}
-				}
-
-				// Fallback from de_De to de
-				foreach ($available as $available_language) {
-					if ($preferred_language_parts[0] === $available_language) {
-						return $available_language;
-					}
-				}
-			}
-		}
-
-		throw new LanguageNotFoundException();
-	}
-
-	/**
-	 * if default language is set to de_DE (formal German) this should be
-	 * preferred to 'de' (non-formal German) if possible
-	 */
-	protected function respectDefaultLanguage(?string $app, string $lang): string {
-		$result = $lang;
-		$defaultLanguage = $this->config->getSystemValue('default_language', false);
-
-		// use formal version of german ("Sie" instead of "Du") if the default
-		// language is set to 'de_DE' if possible
-		if (
-			is_string($defaultLanguage)
-			&& strtolower($lang) === 'de'
-			&& strtolower($defaultLanguage) === 'de_de'
-			&& $this->languageExists($app, 'de_DE')
-		) {
-			$result = 'de_DE';
-		}
-
-		return $result;
-	}
-
-	/**
-	 * Checks if $sub is a subdirectory of $parent
-	 *
-	 * @param string $sub
-	 * @param string $parent
-	 * @return bool
-	 */
-	private function isSubDirectory($sub, $parent) {
-		// Check whether $sub contains no ".."
-		if (str_contains($sub, '..')) {
-			return false;
-		}
-
-		// Check whether $sub is a subdirectory of $parent
-		if (str_starts_with($sub, $parent)) {
-			return true;
-		}
-
-		return false;
-	}
-
-	/**
-	 * Get a list of language files that should be loaded
-	 *
-	 * @return string[]
-	 */
-	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)
-		) {
-			// load the translations file
-			$languageFiles[] = $transFile;
-		}
-
-		// merge with translations from theme
-		$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;
-	}
-
-	/**
-	 * find the l10n directory
-	 *
-	 * @param string $app App id or empty string for core
-	 * @return string directory
-	 */
-	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) {
-				/* App not found, continue */
-			}
-		}
-		return $this->serverRoot . '/core/l10n/';
-	}
-
-	/**
-	 * @inheritDoc
-	 */
-	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);
-			// TRANSLATORS this is the language name for the language switcher in the personal settings and should be the localized version
-			$potentialName = $l->t('__language_name__');
-			if ($l->getLanguageCode() === $lang && $potentialName[0] !== '_') { //first check if the language name is in the translation file
-				$ln = [
-					'code' => $lang,
-					'name' => $potentialName
-				];
-			} elseif ($lang === 'en') {
-				$ln = [
-					'code' => $lang,
-					'name' => 'English (US)'
-				];
-			} else { //fallback to language code
-				$ln = [
-					'code' => $lang,
-					'name' => $lang
-				];
-			}
-
-			// put appropriate languages into appropriate arrays, to print them sorted
-			// common languages -> divider -> other languages
-			if (in_array($lang, self::COMMON_LANGUAGE_CODES)) {
-				$commonLanguages[array_search($lang, self::COMMON_LANGUAGE_CODES)] = $ln;
-			} else {
-				$otherLanguages[] = $ln;
-			}
-		}
-
-		ksort($commonLanguages);
-
-		// sort now by displayed language not the iso-code
-		usort($otherLanguages, function ($a, $b) {
-			if ($a['code'] === $a['name'] && $b['code'] !== $b['name']) {
-				// If a doesn't have a name, but b does, list b before a
-				return 1;
-			}
-			if ($a['code'] !== $a['name'] && $b['code'] === $b['name']) {
-				// If a does have a name, but b doesn't, list a before b
-				return -1;
-			}
-			// Otherwise compare the names
-			return strcmp($a['name'], $b['name']);
-		});
-
-		return [
-			// reset indexes
-			'commonLanguages' => array_values($commonLanguages),
-			'otherLanguages' => $otherLanguages
-		];
-	}
+    /** @var string */
+    protected $requestLanguage = '';
+
+    /**
+     * cached instances
+     * @var array Structure: Lang => App => \OCP\IL10N
+     */
+    protected $instances = [];
+
+    /**
+     * @var array Structure: App => string[]
+     */
+    protected $availableLanguages = [];
+
+    /**
+     * @var array
+     */
+    protected $localeCache = [];
+
+    /**
+     * @var array
+     */
+    protected $availableLocales = [];
+
+    /**
+     * @var array Structure: string => callable
+     */
+    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'
+    ];
+
+    /**
+     * Keep in sync with `build/translation-checker.php`
+     */
+    public const RTL_LANGUAGES = [
+        'ar', // Arabic
+        'fa', // Persian
+        'he', // Hebrew
+        'ps', // Pashto,
+        'ug', // 'Uyghurche / Uyghur
+        'ur_PK', // Urdu
+    ];
+
+    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');
+    }
+
+    /**
+     * Get a language instance
+     *
+     * @param string $app
+     * @param string|null $lang
+     * @param string|null $locale
+     * @return \OCP\IL10N
+     */
+    public function get($app, $lang = null, $locale = null) {
+        return new LazyL10N(function () use ($app, $lang, $locale) {
+            $app = $this->appManager->cleanAppId($app);
+            $lang = $this->cleanLanguage($lang);
+            $forceLang = $this->cleanLanguage($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;
+            }
+
+            $lang = $this->validateLanguage($app, $lang);
+
+            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];
+        });
+    }
+
+    /**
+     * Remove some invalid characters before using a string as a language
+     *
+     * @psalm-taint-escape callable
+     * @psalm-taint-escape cookie
+     * @psalm-taint-escape file
+     * @psalm-taint-escape has_quotes
+     * @psalm-taint-escape header
+     * @psalm-taint-escape html
+     * @psalm-taint-escape include
+     * @psalm-taint-escape ldap
+     * @psalm-taint-escape shell
+     * @psalm-taint-escape sql
+     * @psalm-taint-escape unserialize
+     */
+    private function cleanLanguage(?string $lang): ?string {
+        if ($lang === null) {
+            return null;
+        }
+        $lang = preg_replace('/[^a-zA-Z0-9.;,=-]/', '', $lang);
+        return str_replace('..', '', $lang);
+    }
+
+    /**
+     * Check that $lang is an existing language and not null, otherwise return the language to use instead
+     *
+     * @psalm-taint-escape callable
+     * @psalm-taint-escape cookie
+     * @psalm-taint-escape file
+     * @psalm-taint-escape has_quotes
+     * @psalm-taint-escape header
+     * @psalm-taint-escape html
+     * @psalm-taint-escape include
+     * @psalm-taint-escape ldap
+     * @psalm-taint-escape shell
+     * @psalm-taint-escape sql
+     * @psalm-taint-escape unserialize
+     */
+    private function validateLanguage(string $app, ?string $lang): string {
+        if ($lang === null || !$this->languageExists($app, $lang)) {
+            return $this->findLanguage($app);
+        } else {
+            return $lang;
+        }
+    }
+
+    /**
+     * Find the best language
+     *
+     * @param string|null $appId App id or null for core
+     *
+     * @return string language If nothing works it returns 'en'
+     */
+    public function findLanguage(?string $appId = null): string {
+        // Step 1: Forced language always has precedence over anything else
+        $forceLang = $this->cleanLanguage($this->request->getParam('forceLanguage')) ?? $this->config->getSystemValue('force_language', false);
+        if (is_string($forceLang)) {
+            $this->requestLanguage = $forceLang;
+        }
+
+        // Step 2: Return cached language
+        if ($this->requestLanguage !== '' && $this->languageExists($appId, $this->requestLanguage)) {
+            return $this->requestLanguage;
+        }
+
+        /**
+         * Step 3: At this point Nextcloud might not yet be installed and thus the lookup
+         * in the preferences table might fail. For this reason we need to check
+         * whether the instance has already been installed
+         *
+         * @link https://github.com/owncloud/core/issues/21955
+         */
+        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;
+            }
+        }
+
+        // Step 4: Check the request headers
+        try {
+            // Try to get the language from the Request
+            $lang = $this->getLanguageFromRequest($appId);
+            if ($userId !== null && $appId === null && !$userLang) {
+                $this->config->setUserValue($userId, 'core', 'lang', $lang);
+            }
+            return $lang;
+        } catch (LanguageNotFoundException $e) {
+            // Finding language from request failed fall back to default language
+            $defaultLanguage = $this->config->getSystemValue('default_language', false);
+            if ($defaultLanguage !== false && $this->languageExists($appId, $defaultLanguage)) {
+                return $defaultLanguage;
+            }
+        }
+
+        // Step 5: fall back to English
+        return 'en';
+    }
+
+    public function findGenericLanguage(?string $appId = null): string {
+        // Step 1: Forced language always has precedence over anything else
+        $forcedLanguage = $this->cleanLanguage($this->request->getParam('forceLanguage')) ?? $this->config->getSystemValue('force_language', false);
+        if ($forcedLanguage !== false) {
+            return $forcedLanguage;
+        }
+
+        // Step 2: Check if we have a default language
+        $defaultLanguage = $this->config->getSystemValue('default_language', false);
+        if ($defaultLanguage !== false && $this->languageExists($appId, $defaultLanguage)) {
+            return $defaultLanguage;
+        }
+
+        // Step 3: fall back to English
+        return 'en';
+    }
+
+    /**
+     * find the best locale
+     *
+     * @param string $lang
+     * @return null|string
+     */
+    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;
+        }
+
+        // Default : use system default locale
+        $defaultLocale = $this->config->getSystemValue('default_locale', false);
+        if ($defaultLocale !== false && $this->localeExists($defaultLocale)) {
+            return $defaultLocale;
+        }
+
+        // If no user locale set, use lang as locale
+        if ($lang !== null && $this->localeExists($lang)) {
+            return $lang;
+        }
+
+        // At last, return USA
+        return 'en_US';
+    }
+
+    /**
+     * find the matching lang from the locale
+     *
+     * @param string $app
+     * @param string $locale
+     * @return null|string
+     */
+    public function findLanguageFromLocale(string $app = 'core', ?string $locale = null) {
+        if ($this->languageExists($app, $locale)) {
+            return $locale;
+        }
+
+        // Try to split e.g: fr_FR => fr
+        $locale = explode('_', $locale)[0];
+        if ($this->languageExists($app, $locale)) {
+            return $locale;
+        }
+    }
+
+    /**
+     * Find all available languages for an app
+     *
+     * @param string|null $app App id or null for core
+     * @return string[] an array of available languages
+     */
+    public function findAvailableLanguages($app = null): array {
+        $key = $app;
+        if ($key === null) {
+            $key = 'null';
+        }
+
+        if ($availableLanguages = $this->cache->get($key)) {
+            $this->availableLanguages[$key] = $availableLanguages;
+        }
+
+        // also works with null as key
+        if (!empty($this->availableLanguages[$key])) {
+            return $this->availableLanguages[$key];
+        }
+
+        $available = ['en']; //english is always available
+        $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);
+                    }
+                }
+            }
+        }
+
+        // merge with translations from theme
+        $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;
+    }
+
+    /**
+     * @return array|mixed
+     */
+    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;
+    }
+
+    /**
+     * @param string|null $app App id or null for core
+     * @param string $lang
+     * @return bool
+     */
+    public function languageExists($app, $lang) {
+        if ($lang === 'en') { //english is always available
+            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);
+    }
+
+    /**
+     * Return the language to use when sending something to a user
+     *
+     * @param IUser|null $user
+     * @return string
+     * @since 20.0.0
+     */
+    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;
+            }
+
+            $forcedLanguage = $this->cleanLanguage($this->request->getParam('forceLanguage'));
+            if ($forcedLanguage !== null) {
+                return $forcedLanguage;
+            }
+
+            // Use language from request
+            if ($this->userSession->getUser() instanceof IUser
+                && $user->getUID() === $this->userSession->getUser()->getUID()) {
+                try {
+                    return $this->getLanguageFromRequest();
+                } catch (LanguageNotFoundException $e) {
+                }
+            }
+        }
+
+        return $this->cleanLanguage($this->request->getParam('forceLanguage')) ?? $this->config->getSystemValueString('default_language', 'en');
+    }
+
+    /**
+     * @param string $locale
+     * @return bool
+     */
+    public function localeExists($locale) {
+        if ($locale === 'en') { //english is always available
+            return true;
+        }
+
+        if ($this->localeCache === []) {
+            $locales = $this->findAvailableLocales();
+            foreach ($locales as $l) {
+                $this->localeCache[$l['code']] = true;
+            }
+        }
+
+        return isset($this->localeCache[$locale]);
+    }
+
+    /**
+     * @throws LanguageNotFoundException
+     */
+    private function getLanguageFromRequest(?string $app = null): string {
+        $header = $this->cleanLanguage($this->request->getHeader('ACCEPT_LANGUAGE'));
+        if ($header !== '') {
+            $available = $this->findAvailableLanguages($app);
+
+            // E.g. make sure that 'de' is before 'de_DE'.
+            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;
+                    }
+                }
+
+                // Fallback from de_De to de
+                foreach ($available as $available_language) {
+                    if ($preferred_language_parts[0] === $available_language) {
+                        return $available_language;
+                    }
+                }
+            }
+        }
+
+        throw new LanguageNotFoundException();
+    }
+
+    /**
+     * if default language is set to de_DE (formal German) this should be
+     * preferred to 'de' (non-formal German) if possible
+     */
+    protected function respectDefaultLanguage(?string $app, string $lang): string {
+        $result = $lang;
+        $defaultLanguage = $this->config->getSystemValue('default_language', false);
+
+        // use formal version of german ("Sie" instead of "Du") if the default
+        // language is set to 'de_DE' if possible
+        if (
+            is_string($defaultLanguage)
+            && strtolower($lang) === 'de'
+            && strtolower($defaultLanguage) === 'de_de'
+            && $this->languageExists($app, 'de_DE')
+        ) {
+            $result = 'de_DE';
+        }
+
+        return $result;
+    }
+
+    /**
+     * Checks if $sub is a subdirectory of $parent
+     *
+     * @param string $sub
+     * @param string $parent
+     * @return bool
+     */
+    private function isSubDirectory($sub, $parent) {
+        // Check whether $sub contains no ".."
+        if (str_contains($sub, '..')) {
+            return false;
+        }
+
+        // Check whether $sub is a subdirectory of $parent
+        if (str_starts_with($sub, $parent)) {
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * Get a list of language files that should be loaded
+     *
+     * @return string[]
+     */
+    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)
+        ) {
+            // load the translations file
+            $languageFiles[] = $transFile;
+        }
+
+        // merge with translations from theme
+        $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;
+    }
+
+    /**
+     * find the l10n directory
+     *
+     * @param string $app App id or empty string for core
+     * @return string directory
+     */
+    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) {
+                /* App not found, continue */
+            }
+        }
+        return $this->serverRoot . '/core/l10n/';
+    }
+
+    /**
+     * @inheritDoc
+     */
+    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);
+            // TRANSLATORS this is the language name for the language switcher in the personal settings and should be the localized version
+            $potentialName = $l->t('__language_name__');
+            if ($l->getLanguageCode() === $lang && $potentialName[0] !== '_') { //first check if the language name is in the translation file
+                $ln = [
+                    'code' => $lang,
+                    'name' => $potentialName
+                ];
+            } elseif ($lang === 'en') {
+                $ln = [
+                    'code' => $lang,
+                    'name' => 'English (US)'
+                ];
+            } else { //fallback to language code
+                $ln = [
+                    'code' => $lang,
+                    'name' => $lang
+                ];
+            }
+
+            // put appropriate languages into appropriate arrays, to print them sorted
+            // common languages -> divider -> other languages
+            if (in_array($lang, self::COMMON_LANGUAGE_CODES)) {
+                $commonLanguages[array_search($lang, self::COMMON_LANGUAGE_CODES)] = $ln;
+            } else {
+                $otherLanguages[] = $ln;
+            }
+        }
+
+        ksort($commonLanguages);
+
+        // sort now by displayed language not the iso-code
+        usort($otherLanguages, function ($a, $b) {
+            if ($a['code'] === $a['name'] && $b['code'] !== $b['name']) {
+                // If a doesn't have a name, but b does, list b before a
+                return 1;
+            }
+            if ($a['code'] !== $a['name'] && $b['code'] === $b['name']) {
+                // If a does have a name, but b doesn't, list a before b
+                return -1;
+            }
+            // Otherwise compare the names
+            return strcmp($a['name'], $b['name']);
+        });
+
+        return [
+            // reset indexes
+            'commonLanguages' => array_values($commonLanguages),
+            'otherLanguages' => $otherLanguages
+        ];
+    }
 }

Spacing +16 added lines, -16 removed lines

@@ -92,7 +92,7 @@ 
 	 * @return \OCP\IL10N
 	 */
 	public function get($app, $lang = null, $locale = null) {
-		return new LazyL10N(function () use ($app, $lang, $locale) {
+		return new LazyL10N(function() use ($app, $lang, $locale) {
 			$app = $this->appManager->cleanAppId($app);
 			$lang = $this->cleanLanguage($lang);
 			$forceLang = $this->cleanLanguage($this->request->getParam('forceLanguage')) ?? $this->config->getSystemValue('force_language', false);
@@ -198,7 +198,7 @@ 
 		 * @link https://github.com/owncloud/core/issues/21955
 		 */
 		if ($this->config->getSystemValueBool('installed', false)) {
-			$userId = !is_null($this->userSession->getUser()) ? $this->userSession->getUser()->getUID() :  null;
+			$userId = !is_null($this->userSession->getUser()) ? $this->userSession->getUser()->getUID() : null;
 			if (!is_null($userId)) {
 				$userLang = $this->config->getUserValue($userId, 'core', 'lang', null);
 			} else {
@@ -265,7 +265,7 @@ 
 		}
 
 		if ($this->config->getSystemValueBool('installed', false)) {
-			$userId = $this->userSession->getUser() !== null ? $this->userSession->getUser()->getUID() :  null;
+			$userId = $this->userSession->getUser() !== null ? $this->userSession->getUser()->getUID() : null;
 			$userLocale = null;
 			if ($userId !== null) {
 				$userLocale = $this->config->getUserValue($userId, 'core', 'locale', null);
@@ -350,7 +350,7 @@ 
 		// merge with translations from theme
 		$theme = $this->config->getSystemValueString('theme');
 		if (!empty($theme)) {
-			$themeDir = $this->serverRoot . '/themes/' . $theme . substr($dir, strlen($this->serverRoot));
+			$themeDir = $this->serverRoot.'/themes/'.$theme.substr($dir, strlen($this->serverRoot));
 
 			if (is_dir($themeDir)) {
 				$files = scandir($themeDir);
@@ -377,7 +377,7 @@ 
 			return $this->availableLocales;
 		}
 
-		$localeData = file_get_contents(\OC::$SERVERROOT . '/resources/locales.json');
+		$localeData = file_get_contents(\OC::$SERVERROOT.'/resources/locales.json');
 		$this->availableLocales = \json_decode($localeData, true);
 
 		return $this->availableLocales;
@@ -490,7 +490,7 @@ 
 					if ($preferred_language === strtolower($available_language)) {
 						return $this->respectDefaultLanguage($app, $available_language);
 					}
-					if (strtolower($available_language) === $preferred_language_parts[0] . '_' . end($preferred_language_parts)) {
+					if (strtolower($available_language) === $preferred_language_parts[0].'_'.end($preferred_language_parts)) {
 						return $available_language;
 					}
 				}
@@ -559,11 +559,11 @@ 
 		$languageFiles = [];
 
 		$i18nDir = $this->findL10nDir($app);
-		$transFile = strip_tags($i18nDir) . strip_tags($lang) . '.json';
+		$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/'))
+		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)
 		) {
 			// load the translations file
@@ -573,7 +573,7 @@ 
 		// merge with translations from theme
 		$theme = $this->config->getSystemValueString('theme');
 		if (!empty($theme)) {
-			$transFile = $this->serverRoot . '/themes/' . $theme . substr($transFile, strlen($this->serverRoot));
+			$transFile = $this->serverRoot.'/themes/'.$theme.substr($transFile, strlen($this->serverRoot));
 			if (file_exists($transFile)) {
 				$languageFiles[] = $transFile;
 			}
@@ -590,17 +590,17 @@ 
 	 */
 	protected function findL10nDir($app = null) {
 		if (in_array($app, ['core', 'lib'])) {
-			if (file_exists($this->serverRoot . '/' . $app . '/l10n/')) {
-				return $this->serverRoot . '/' . $app . '/l10n/';
+			if (file_exists($this->serverRoot.'/'.$app.'/l10n/')) {
+				return $this->serverRoot.'/'.$app.'/l10n/';
 			}
 		} elseif ($app) {
 			try {
-				return $this->appManager->getAppPath($app) . '/l10n/';
+				return $this->appManager->getAppPath($app).'/l10n/';
 			} catch (AppPathNotFoundException) {
 				/* App not found, continue */
 			}
 		}
-		return $this->serverRoot . '/core/l10n/';
+		return $this->serverRoot.'/core/l10n/';
 	}
 
 	/**
@@ -663,7 +663,7 @@ 
 		ksort($commonLanguages);
 
 		// sort now by displayed language not the iso-code
-		usort($otherLanguages, function ($a, $b) {
+		usort($otherLanguages, function($a, $b) {
 			if ($a['code'] === $a['name'] && $b['code'] !== $b['name']) {
 				// If a doesn't have a name, but b does, list b before a
 				return 1;

tests/lib/L10N/FactoryTest.php

Indentation +754 added lines, -754 removed lines

@@ -25,758 +25,758 @@
 use Test\TestCase;
 
 class FactoryTest extends TestCase {
-	/** @var IConfig|MockObject */
-	protected $config;
-
-	/** @var IRequest|MockObject */
-	protected $request;
-
-	/** @var IUserSession|MockObject */
-	protected $userSession;
-
-	/** @var ICacheFactory|MockObject */
-	protected $cacheFactory;
-
-	/** @var string */
-	protected $serverRoot;
-
-	/** @var IAppManager|MockObject */
-	protected IAppManager $appManager;
-
-	protected function setUp(): void {
-		parent::setUp();
-
-		$this->config = $this->createMock(IConfig::class);
-		$this->request = $this->createMock(IRequest::class);
-		$this->userSession = $this->createMock(IUserSession::class);
-		$this->cacheFactory = $this->createMock(ICacheFactory::class);
-		$this->appManager = $this->createMock(IAppManager::class);
-
-		$this->serverRoot = \OC::$SERVERROOT;
-
-		$this->config
-			->method('getSystemValueBool')
-			->willReturnMap([
-				['installed', false, true],
-			]);
-	}
-
-	/**
-	 * @param string[] $methods
-	 * @param bool $mockRequestGetHeaderMethod
-	 *
-	 * @return Factory|MockObject
-	 */
-	protected function getFactory(array $methods = [], $mockRequestGetHeaderMethod = false) {
-		if ($mockRequestGetHeaderMethod) {
-			$this->request->expects(self::any())
-				->method('getHeader')
-				->willReturn('');
-		}
-
-		if (!empty($methods)) {
-			return $this->getMockBuilder(Factory::class)
-				->setConstructorArgs([
-					$this->config,
-					$this->request,
-					$this->userSession,
-					$this->cacheFactory,
-					$this->serverRoot,
-					$this->appManager,
-				])
-				->onlyMethods($methods)
-				->getMock();
-		}
-
-		return new Factory($this->config, $this->request, $this->userSession, $this->cacheFactory, $this->serverRoot, $this->appManager);
-	}
-
-	public static function dataCleanLanguage(): array {
-		return [
-			'null shortcut' => [null, null],
-			'default language' => ['de', 'de'],
-			'malicious language' => ['de/../fr', 'defr'],
-			'request language' => ['kab;q=0.8,ka;q=0.7,de;q=0.6', 'kab;q=0.8,ka;q=0.7,de;q=0.6'],
-		];
-	}
-
-	#[DataProvider('dataCleanLanguage')]
-	public function testCleanLanguage(?string $lang, ?string $expected): void {
-		$factory = $this->getFactory();
-		$this->assertSame($expected, self::invokePrivate($factory, 'cleanLanguage', [$lang]));
-	}
-
-	public static function dataFindAvailableLanguages(): array {
-		return [
-			[null],
-			['files'],
-		];
-	}
-
-	public function testFindLanguageWithExistingRequestLanguageAndNoApp(): void {
-		$factory = $this->getFactory(['languageExists']);
-		$this->invokePrivate($factory, 'requestLanguage', ['de']);
-		$factory->expects(self::once())
-			->method('languageExists')
-			->with(null, 'de')
-			->willReturn(true);
-
-		self::assertSame('de', $factory->findLanguage());
-	}
-
-	public function testFindLanguageWithExistingRequestLanguageAndApp(): void {
-		$factory = $this->getFactory(['languageExists']);
-		$this->invokePrivate($factory, 'requestLanguage', ['de']);
-		$factory->expects(self::once())
-			->method('languageExists')
-			->with('MyApp', 'de')
-			->willReturn(true);
-
-		self::assertSame('de', $factory->findLanguage('MyApp'));
-	}
-
-	public function testFindLanguageWithNotExistingRequestLanguageAndExistingStoredUserLanguage(): void {
-		$factory = $this->getFactory(['languageExists']);
-		$this->invokePrivate($factory, 'requestLanguage', ['de']);
-		$factory->expects($this->exactly(2))
-			->method('languageExists')
-			->willReturnMap([
-				['MyApp', 'de', false],
-				['MyApp', 'jp', true],
-			]);
-		$this->config
-			->expects($this->exactly(1))
-			->method('getSystemValue')
-			->willReturnMap([
-				['force_language', false, false],
-			]);
-		$user = $this->createMock(IUser::class);
-		$user->expects(self::once())
-			->method('getUID')
-			->willReturn('MyUserUid');
-		$this->userSession
-			->expects(self::exactly(2))
-			->method('getUser')
-			->willReturn($user);
-		$this->config
-			->expects(self::once())
-			->method('getUserValue')
-			->with('MyUserUid', 'core', 'lang', null)
-			->willReturn('jp');
-
-		self::assertSame('jp', $factory->findLanguage('MyApp'));
-	}
-
-	public function testFindLanguageWithNotExistingRequestLanguageAndNotExistingStoredUserLanguage(): void {
-		$factory = $this->getFactory(['languageExists'], true);
-		$this->invokePrivate($factory, 'requestLanguage', ['de']);
-		$factory->expects($this->exactly(3))
-			->method('languageExists')
-			->willReturnMap([
-				['MyApp', 'de', false],
-				['MyApp', 'jp', false],
-				['MyApp', 'es', true],
-			]);
-		$this->config
-			->expects($this->exactly(2))
-			->method('getSystemValue')
-			->willReturnMap([
-				['force_language', false, false],
-				['default_language', false, 'es']
-			]);
-		$user = $this->createMock(IUser::class);
-		$user->expects(self::once())
-			->method('getUID')
-			->willReturn('MyUserUid');
-		$this->userSession
-			->expects(self::exactly(2))
-			->method('getUser')
-			->willReturn($user);
-		$this->config
-			->expects(self::once())
-			->method('getUserValue')
-			->with('MyUserUid', 'core', 'lang', null)
-			->willReturn('jp');
-
-		self::assertSame('es', $factory->findLanguage('MyApp'));
-	}
-
-	public function testFindLanguageWithNotExistingRequestLanguageAndNotExistingStoredUserLanguageAndNotExistingDefault(): void {
-		$factory = $this->getFactory(['languageExists'], true);
-		$this->invokePrivate($factory, 'requestLanguage', ['de']);
-		$factory->expects($this->exactly(3))
-			->method('languageExists')
-			->willReturnMap([
-				['MyApp', 'de', false],
-				['MyApp', 'jp', false],
-				['MyApp', 'es', false],
-			]);
-		$this->config
-			->expects($this->exactly(2))
-			->method('getSystemValue')
-			->willReturnMap([
-				['force_language', false, false],
-				['default_language', false, 'es']
-			]);
-		$user = $this->createMock(IUser::class);
-		$user->expects(self::once())
-			->method('getUID')
-			->willReturn('MyUserUid');
-		$this->userSession
-			->expects(self::exactly(2))
-			->method('getUser')
-			->willReturn($user);
-		$this->config
-			->expects(self::once())
-			->method('getUserValue')
-			->with('MyUserUid', 'core', 'lang', null)
-			->willReturn('jp');
-		$this->config
-			->expects(self::never())
-			->method('setUserValue');
-
-		self::assertSame('en', $factory->findLanguage('MyApp'));
-	}
-
-	public function testFindLanguageWithNotExistingRequestLanguageAndNotExistingStoredUserLanguageAndNotExistingDefaultAndNoAppInScope(): void {
-		$factory = $this->getFactory(['languageExists'], true);
-		$this->invokePrivate($factory, 'requestLanguage', ['de']);
-		$factory->expects($this->exactly(3))
-			->method('languageExists')
-			->willReturnMap([
-				['MyApp', 'de', false],
-				['MyApp', 'jp', false],
-				['MyApp', 'es', false],
-			]);
-		$this->config
-			->expects($this->exactly(2))
-			->method('getSystemValue')
-			->willReturnMap([
-				['force_language', false, false],
-				['default_language', false, 'es']
-			]);
-		$user = $this->createMock(IUser::class);
-		$user->expects(self::once())
-			->method('getUID')
-			->willReturn('MyUserUid');
-		$this->userSession
-			->expects(self::exactly(2))
-			->method('getUser')
-			->willReturn($user);
-		$this->config
-			->expects(self::once())
-			->method('getUserValue')
-			->with('MyUserUid', 'core', 'lang', null)
-			->willReturn('jp');
-		$this->config
-			->expects(self::never())
-			->method('setUserValue')
-			->with('MyUserUid', 'core', 'lang', 'en');
-
-
-		self::assertSame('en', $factory->findLanguage('MyApp'));
-	}
-
-	public function testFindLanguageWithForcedLanguage(): void {
-		$factory = $this->getFactory(['languageExists']);
-		$this->config
-			->expects($this->once())
-			->method('getSystemValue')
-			->with('force_language', false)
-			->willReturn('de');
-
-		$factory->expects($this->once())
-			->method('languageExists')
-			->with('MyApp', 'de')
-			->willReturn(true);
-
-		self::assertSame('de', $factory->findLanguage('MyApp'));
-	}
-
-	/**
-	 * @param string|null $app
-	 */
-	#[\PHPUnit\Framework\Attributes\DataProvider('dataFindAvailableLanguages')]
-	public function testFindAvailableLanguages($app): void {
-		$factory = $this->getFactory(['findL10nDir']);
-		$factory->expects(self::once())
-			->method('findL10nDir')
-			->with($app)
-			->willReturn(\OC::$SERVERROOT . '/tests/data/l10n/');
-
-		self::assertEqualsCanonicalizing(['cs', 'de', 'en', 'ru'], $factory->findAvailableLanguages($app));
-	}
-
-	public static function dataLanguageExists(): array {
-		return [
-			[null, 'en', [], true],
-			[null, 'de', [], false],
-			[null, 'de', ['ru'], false],
-			[null, 'de', ['ru', 'de'], true],
-			['files', 'en', [], true],
-			['files', 'de', [], false],
-			['files', 'de', ['ru'], false],
-			['files', 'de', ['de', 'ru'], true],
-		];
-	}
-
-	public function testFindAvailableLanguagesWithThemes(): void {
-		$this->serverRoot .= '/tests/data';
-		$app = 'files';
-
-		$factory = $this->getFactory(['findL10nDir']);
-		$factory->expects(self::once())
-			->method('findL10nDir')
-			->with($app)
-			->willReturn($this->serverRoot . '/apps/files/l10n/');
-		$this->config
-			->expects(self::once())
-			->method('getSystemValueString')
-			->with('theme')
-			->willReturn('abc');
-
-		self::assertEqualsCanonicalizing(['en', 'zz'], $factory->findAvailableLanguages($app));
-	}
-
-	/**
-	 *
-	 * @param string|null $app
-	 * @param string $lang
-	 * @param string[] $availableLanguages
-	 * @param string $expected
-	 */
-	#[\PHPUnit\Framework\Attributes\DataProvider('dataLanguageExists')]
-	public function testLanguageExists($app, $lang, array $availableLanguages, $expected): void {
-		$factory = $this->getFactory(['findAvailableLanguages']);
-		$factory->expects(($lang === 'en') ? self::never() : self::once())
-			->method('findAvailableLanguages')
-			->with($app)
-			->willReturn($availableLanguages);
-
-		self::assertSame($expected, $factory->languageExists($app, $lang));
-	}
-
-	public static function dataSetLanguageFromRequest(): array {
-		return [
-			// Language is available
-			[null, 'de', ['de'], 'de'],
-			[null, 'de,en', ['de'], 'de'],
-			[null, 'de-DE,en-US;q=0.8,en;q=0.6', ['de'], 'de'],
-			// Language is not available
-			[null, 'de', ['ru'], new LanguageNotFoundException()],
-			[null, 'de,en', ['ru', 'en'], 'en'],
-			[null, 'de-DE,en-US;q=0.8,en;q=0.6', ['ru', 'en'], 'en'],
-
-			// Don't fall back from kab (Kabyle) to ka (Georgian) - Unless specifically requested
-			[null, 'kab;q=0.8,en;q=0.6', ['ka', 'en'], 'en'],
-			[null, 'kab;q=0.8,de;q=0.6', ['ka', 'en', 'de'], 'de'],
-			[null, 'kab;q=0.8,de;q=0.7,ka;q=0.6', ['ka', 'en', 'de'], 'de'],
-			[null, 'kab;q=0.8,ka;q=0.7,de;q=0.6', ['ka', 'en', 'de'], 'ka'],
-
-			// Language for app
-			['files_pdfviewer', 'de', ['de'], 'de'],
-			['files_pdfviewer', 'de,en', ['de'], 'de'],
-			['files_pdfviewer', 'de-DE,en-US;q=0.8,en;q=0.6', ['de'], 'de'],
-			// Language for app is not available
-			['files_pdfviewer', 'de', ['ru'], new LanguageNotFoundException()],
-			['files_pdfviewer', 'de,en', ['ru', 'en'], 'en'],
-			['files_pdfviewer', 'de-DE,en-US;q=0.8,en;q=0.6', ['ru', 'en'], 'en'],
-		];
-	}
-
-	/**
-	 *
-	 * @param string|null $app
-	 * @param string $header
-	 * @param string[] $availableLanguages
-	 * @param string $expected
-	 */
-	#[\PHPUnit\Framework\Attributes\DataProvider('dataSetLanguageFromRequest')]
-	public function testGetLanguageFromRequest($app, $header, array $availableLanguages, $expected): void {
-		$factory = $this->getFactory(['findAvailableLanguages', 'respectDefaultLanguage']);
-		$factory->expects(self::once())
-			->method('findAvailableLanguages')
-			->with($app)
-			->willReturn($availableLanguages);
-
-		$factory->expects(self::any())
-			->method('respectDefaultLanguage')->willReturnCallback(function ($app, $lang) {
-				return $lang;
-			});
-
-		$this->request->expects(self::once())
-			->method('getHeader')
-			->with('ACCEPT_LANGUAGE')
-			->willReturn($header);
-
-		if ($expected instanceof LanguageNotFoundException) {
-			$this->expectException(LanguageNotFoundException::class);
-			self::invokePrivate($factory, 'getLanguageFromRequest', [$app]);
-		} else {
-			self::assertSame($expected, self::invokePrivate($factory, 'getLanguageFromRequest', [$app]), 'Asserting returned language');
-		}
-	}
-
-	public static function dataGetL10nFilesForApp(): array {
-		return [
-			['', 'de', [\OC::$SERVERROOT . '/core/l10n/de.json']],
-			['core', 'ru', [\OC::$SERVERROOT . '/core/l10n/ru.json']],
-			['lib', 'ru', [\OC::$SERVERROOT . '/lib/l10n/ru.json']],
-			['settings', 'de', [\OC::$SERVERROOT . '/apps/settings/l10n/de.json']],
-			['files', 'de', [\OC::$SERVERROOT . '/apps/files/l10n/de.json']],
-			['files', '_lang_never_exists_', []],
-			['_app_never_exists_', 'de', [\OC::$SERVERROOT . '/core/l10n/de.json']],
-		];
-	}
-
-	/**
-	 *
-	 * @param string $app
-	 * @param string $expected
-	 */
-	#[\PHPUnit\Framework\Attributes\DataProvider('dataGetL10nFilesForApp')]
-	public function testGetL10nFilesForApp($app, $lang, $expected): void {
-		$factory = $this->getFactory();
-		if (in_array($app, ['settings','files'])) {
-			$this->appManager
-				->method('getAppPath')
-				->with($app)
-				->willReturn(\OC::$SERVERROOT . '/apps/' . $app);
-		} else {
-			$this->appManager
-				->method('getAppPath')
-				->with($app)
-				->willThrowException(new AppPathNotFoundException());
-		}
-		self::assertSame($expected, $this->invokePrivate($factory, 'getL10nFilesForApp', [$app, $lang]));
-	}
-
-	public static function dataFindL10NDir(): array {
-		return [
-			['', \OC::$SERVERROOT . '/core/l10n/'],
-			['core', \OC::$SERVERROOT . '/core/l10n/'],
-			['lib', \OC::$SERVERROOT . '/lib/l10n/'],
-			['settings', \OC::$SERVERROOT . '/apps/settings/l10n/'],
-			['files', \OC::$SERVERROOT . '/apps/files/l10n/'],
-			['_app_never_exists_', \OC::$SERVERROOT . '/core/l10n/'],
-		];
-	}
-
-	/**
-	 *
-	 * @param string $app
-	 * @param string $expected
-	 */
-	#[\PHPUnit\Framework\Attributes\DataProvider('dataFindL10NDir')]
-	public function testFindL10NDir($app, $expected): void {
-		$factory = $this->getFactory();
-		if (in_array($app, ['settings','files'])) {
-			$this->appManager
-				->method('getAppPath')
-				->with($app)
-				->willReturn(\OC::$SERVERROOT . '/apps/' . $app);
-		} else {
-			$this->appManager
-				->method('getAppPath')
-				->with($app)
-				->willThrowException(new AppPathNotFoundException());
-		}
-		self::assertSame($expected, $this->invokePrivate($factory, 'findL10nDir', [$app]));
-	}
-
-	public static function dataFindLanguage(): array {
-		return [
-			// Not logged in
-			[false, [], 'en'],
-			[false, ['fr'], 'fr'],
-			[false, ['de', 'fr'], 'de'],
-			[false, ['nl', 'de', 'fr'], 'de'],
-
-			[true, [], 'en'],
-			[true, ['fr'], 'fr'],
-			[true, ['de', 'fr'], 'de'],
-			[true, ['nl', 'de', 'fr'], 'nl'],
-		];
-	}
-
-	/**
-	 *
-	 * @param bool $loggedIn
-	 * @param array $availableLang
-	 * @param string $expected
-	 */
-	#[\PHPUnit\Framework\Attributes\DataProvider('dataFindLanguage')]
-	public function testFindLanguage($loggedIn, $availableLang, $expected): void {
-		$userLang = 'nl';
-		$browserLang = 'de';
-		$defaultLang = 'fr';
-
-		$this->config->expects(self::any())
-			->method('getSystemValue')
-			->willReturnCallback(function ($var, $default) use ($defaultLang) {
-				if ($var === 'default_language') {
-					return $defaultLang;
-				} else {
-					return $default;
-				}
-			});
-
-		if ($loggedIn) {
-			$user = $this->createMock(IUser::class);
-			$user->expects(self::any())
-				->method('getUID')
-				->willReturn('MyUserUid');
-			$this->userSession
-				->expects(self::any())
-				->method('getUser')
-				->willReturn($user);
-			$this->config->expects(self::any())
-				->method('getUserValue')
-				->with('MyUserUid', 'core', 'lang', null)
-				->willReturn($userLang);
-		} else {
-			$this->userSession
-				->expects(self::any())
-				->method('getUser')
-				->willReturn(null);
-		}
-
-		$this->request->expects(self::any())
-			->method('getHeader')
-			->with($this->equalTo('ACCEPT_LANGUAGE'))
-			->willReturn($browserLang);
-
-		$factory = $this->getFactory(['languageExists', 'findAvailableLanguages', 'respectDefaultLanguage']);
-		$factory->expects(self::any())
-			->method('languageExists')
-			->willReturnCallback(function ($app, $lang) use ($availableLang) {
-				return in_array($lang, $availableLang);
-			});
-		$factory->expects(self::any())
-			->method('findAvailableLanguages')
-			->willReturnCallback(function ($app) use ($availableLang) {
-				return $availableLang;
-			});
-		$factory->expects(self::any())
-			->method('respectDefaultLanguage')->willReturnCallback(function ($app, $lang) {
-				return $lang;
-			});
-
-		$lang = $factory->findLanguage();
-
-		self::assertSame($expected, $lang);
-	}
-
-	public function testFindGenericLanguageByRequestParam(): void {
-		$factory = $this->getFactory();
-		$this->request->expects(self::once())
-			->method('getParam')
-			->with('forceLanguage')
-			->willReturn('cz');
-
-		$lang = $factory->findGenericLanguage();
-
-		self::assertSame('cz', $lang);
-	}
-
-	public function testFindGenericLanguageByEnforcedLanguage(): void {
-		$factory = $this->getFactory();
-		$this->request->expects(self::once())
-			->method('getParam')
-			->with('forceLanguage')
-			->willReturn(null);
-		$this->config->expects(self::once())
-			->method('getSystemValue')
-			->with('force_language', false)
-			->willReturn('cz');
-
-		$lang = $factory->findGenericLanguage();
-
-		self::assertSame('cz', $lang);
-	}
-
-	public function testFindGenericLanguageByDefaultLanguage(): void {
-		$factory = $this->getFactory(['languageExists']);
-		$this->request->expects(self::once())
-			->method('getParam')
-			->with('forceLanguage')
-			->willReturn(null);
-		$this->config->expects(self::exactly(2))
-			->method('getSystemValue')
-			->willReturnMap([
-				['force_language', false, false,],
-				['default_language', false, 'cz',],
-			]);
-		$factory->expects(self::once())
-			->method('languageExists')
-			->with(null, 'cz')
-			->willReturn(true);
-
-		$lang = $factory->findGenericLanguage();
-
-		self::assertSame('cz', $lang);
-	}
-
-	public function testFindGenericLanguageByDefaultLanguageNotExists(): void {
-		$factory = $this->getFactory(['languageExists']);
-		$this->request->expects(self::once())
-			->method('getParam')
-			->with('forceLanguage')
-			->willReturn(null);
-		$this->config->expects(self::exactly(2))
-			->method('getSystemValue')
-			->willReturnMap([
-				['force_language', false, false,],
-				['default_language', false, 'cz',],
-			]);
-		$factory->expects(self::once())
-			->method('languageExists')
-			->with(null, 'cz')
-			->willReturn(false);
-
-		$lang = $factory->findGenericLanguage();
-
-		self::assertSame('en', $lang);
-	}
-
-	public function testFindGenericLanguageFallback(): void {
-		$factory = $this->getFactory();
-		$this->request->expects(self::once())
-			->method('getParam')
-			->with('forceLanguage')
-			->willReturn(null);
-		$this->config->expects(self::exactly(2))
-			->method('getSystemValue')
-			->willReturnMap([
-				['force_language', false, false,],
-				['default_language', false, false,],
-			]);
-
-		$lang = $factory->findGenericLanguage();
-
-		self::assertSame('en', $lang);
-	}
-
-	public static function dataTestRespectDefaultLanguage(): array {
-		return [
-			['de', 'de_DE', true, 'de_DE'],
-			['de', 'de', true, 'de'],
-			['de', false, true, 'de'],
-			['fr', 'de_DE', true, 'fr'],
-		];
-	}
-
-	/**
-	 * test if we respect default language if possible
-	 *
-	 *
-	 * @param string $lang
-	 * @param string $defaultLanguage
-	 * @param bool $langExists
-	 * @param string $expected
-	 */
-	#[\PHPUnit\Framework\Attributes\DataProvider('dataTestRespectDefaultLanguage')]
-	public function testRespectDefaultLanguage($lang, $defaultLanguage, $langExists, $expected): void {
-		$factory = $this->getFactory(['languageExists']);
-		$factory->expects(self::any())
-			->method('languageExists')->willReturn($langExists);
-		$this->config->expects(self::any())
-			->method('getSystemValue')->with('default_language', false)->willReturn($defaultLanguage);
-
-		$result = $this->invokePrivate($factory, 'respectDefaultLanguage', ['app', $lang]);
-		self::assertSame($expected, $result);
-	}
-
-	public static function dataTestReduceToLanguages(): array {
-		return [
-			['en', ['en', 'de', 'fr', 'it', 'es'], ['en', 'fr', 'de'], ['en', 'fr', 'de']],
-			['en', ['en', 'de', 'fr', 'it', 'es'], ['en', 'de'], ['en', 'de']],
-			['en', ['en', 'de', 'fr', 'it', 'es'], [], ['de', 'en', 'es', 'fr', 'it']],
-		];
-	}
-
-	/**
-	 * test
-	 * - if available languages set can be reduced by configuration
-	 * - if available languages set is not reduced to an empty set if
-	 *   the reduce config is an empty set
-	 *
-	 *
-	 * @param string $lang
-	 * @param array $availableLanguages
-	 * @param array $reducedLanguageSet
-	 * @param array $expected
-	 */
-	#[\PHPUnit\Framework\Attributes\DataProvider('dataTestReduceToLanguages')]
-	public function testReduceLanguagesByConfiguration(string $lang, array $availableLanguages, array $reducedLanguageSet, array $expected): void {
-		$factory = $this->getFactory(['findAvailableLanguages', 'languageExists']);
-		$factory->expects(self::any())
-			->method('languageExists')->willReturn(true);
-		$factory->expects(self::any())
-			->method('findAvailableLanguages')
-			->willReturnCallback(function ($app) use ($availableLanguages) {
-				return $availableLanguages;
-			});
-
-		$this->config
-			->method('getSystemValue')
-			->willReturnMap([
-				['force_language', false, false],
-				['default_language', false, $lang],
-				['reduce_to_languages', [], $reducedLanguageSet]
-			]);
-
-		$result = $this->invokePrivate($factory, 'getLanguages');
-		$commonLanguagesCodes = array_map(function ($lang) {
-			return $lang['code'];
-		}, $result['commonLanguages']);
-
-		self::assertEqualsCanonicalizing($expected, $commonLanguagesCodes);
-	}
-
-	public static function languageIteratorRequestProvider(): array {
-		return [
-			[ true, true],
-			[ false, true],
-			[ false, false],
-		];
-	}
-
-	#[\PHPUnit\Framework\Attributes\DataProvider('languageIteratorRequestProvider')]
-	public function testGetLanguageIterator(bool $hasSession, bool $mockUser): void {
-		$factory = $this->getFactory();
-		$user = null;
-
-		if (!$mockUser) {
-			$matcher = $this->userSession->expects(self::once())
-				->method('getUser');
-
-			if ($hasSession) {
-				$matcher->willReturn($this->createMock(IUser::class));
-			} else {
-				$this->expectException(\RuntimeException::class);
-			}
-		} else {
-			$user = $this->createMock(IUser::class);
-		}
-
-		$iterator = $factory->getLanguageIterator($user);
-		self::assertInstanceOf(ILanguageIterator::class, $iterator);
-	}
-
-	public static function dataGetLanguageDirection(): array {
-		return [
-			['en', 'ltr'],
-			['de', 'ltr'],
-			['fa', 'rtl'],
-			['ar', 'rtl']
-		];
-	}
-
-	#[\PHPUnit\Framework\Attributes\DataProvider('dataGetLanguageDirection')]
-	public function testGetLanguageDirection(string $language, string $expectedDirection) {
-		$factory = $this->getFactory();
-
-		self::assertEquals($expectedDirection, $factory->getLanguageDirection($language));
-	}
+    /** @var IConfig|MockObject */
+    protected $config;
+
+    /** @var IRequest|MockObject */
+    protected $request;
+
+    /** @var IUserSession|MockObject */
+    protected $userSession;
+
+    /** @var ICacheFactory|MockObject */
+    protected $cacheFactory;
+
+    /** @var string */
+    protected $serverRoot;
+
+    /** @var IAppManager|MockObject */
+    protected IAppManager $appManager;
+
+    protected function setUp(): void {
+        parent::setUp();
+
+        $this->config = $this->createMock(IConfig::class);
+        $this->request = $this->createMock(IRequest::class);
+        $this->userSession = $this->createMock(IUserSession::class);
+        $this->cacheFactory = $this->createMock(ICacheFactory::class);
+        $this->appManager = $this->createMock(IAppManager::class);
+
+        $this->serverRoot = \OC::$SERVERROOT;
+
+        $this->config
+            ->method('getSystemValueBool')
+            ->willReturnMap([
+                ['installed', false, true],
+            ]);
+    }
+
+    /**
+     * @param string[] $methods
+     * @param bool $mockRequestGetHeaderMethod
+     *
+     * @return Factory|MockObject
+     */
+    protected function getFactory(array $methods = [], $mockRequestGetHeaderMethod = false) {
+        if ($mockRequestGetHeaderMethod) {
+            $this->request->expects(self::any())
+                ->method('getHeader')
+                ->willReturn('');
+        }
+
+        if (!empty($methods)) {
+            return $this->getMockBuilder(Factory::class)
+                ->setConstructorArgs([
+                    $this->config,
+                    $this->request,
+                    $this->userSession,
+                    $this->cacheFactory,
+                    $this->serverRoot,
+                    $this->appManager,
+                ])
+                ->onlyMethods($methods)
+                ->getMock();
+        }
+
+        return new Factory($this->config, $this->request, $this->userSession, $this->cacheFactory, $this->serverRoot, $this->appManager);
+    }
+
+    public static function dataCleanLanguage(): array {
+        return [
+            'null shortcut' => [null, null],
+            'default language' => ['de', 'de'],
+            'malicious language' => ['de/../fr', 'defr'],
+            'request language' => ['kab;q=0.8,ka;q=0.7,de;q=0.6', 'kab;q=0.8,ka;q=0.7,de;q=0.6'],
+        ];
+    }
+
+    #[DataProvider('dataCleanLanguage')]
+    public function testCleanLanguage(?string $lang, ?string $expected): void {
+        $factory = $this->getFactory();
+        $this->assertSame($expected, self::invokePrivate($factory, 'cleanLanguage', [$lang]));
+    }
+
+    public static function dataFindAvailableLanguages(): array {
+        return [
+            [null],
+            ['files'],
+        ];
+    }
+
+    public function testFindLanguageWithExistingRequestLanguageAndNoApp(): void {
+        $factory = $this->getFactory(['languageExists']);
+        $this->invokePrivate($factory, 'requestLanguage', ['de']);
+        $factory->expects(self::once())
+            ->method('languageExists')
+            ->with(null, 'de')
+            ->willReturn(true);
+
+        self::assertSame('de', $factory->findLanguage());
+    }
+
+    public function testFindLanguageWithExistingRequestLanguageAndApp(): void {
+        $factory = $this->getFactory(['languageExists']);
+        $this->invokePrivate($factory, 'requestLanguage', ['de']);
+        $factory->expects(self::once())
+            ->method('languageExists')
+            ->with('MyApp', 'de')
+            ->willReturn(true);
+
+        self::assertSame('de', $factory->findLanguage('MyApp'));
+    }
+
+    public function testFindLanguageWithNotExistingRequestLanguageAndExistingStoredUserLanguage(): void {
+        $factory = $this->getFactory(['languageExists']);
+        $this->invokePrivate($factory, 'requestLanguage', ['de']);
+        $factory->expects($this->exactly(2))
+            ->method('languageExists')
+            ->willReturnMap([
+                ['MyApp', 'de', false],
+                ['MyApp', 'jp', true],
+            ]);
+        $this->config
+            ->expects($this->exactly(1))
+            ->method('getSystemValue')
+            ->willReturnMap([
+                ['force_language', false, false],
+            ]);
+        $user = $this->createMock(IUser::class);
+        $user->expects(self::once())
+            ->method('getUID')
+            ->willReturn('MyUserUid');
+        $this->userSession
+            ->expects(self::exactly(2))
+            ->method('getUser')
+            ->willReturn($user);
+        $this->config
+            ->expects(self::once())
+            ->method('getUserValue')
+            ->with('MyUserUid', 'core', 'lang', null)
+            ->willReturn('jp');
+
+        self::assertSame('jp', $factory->findLanguage('MyApp'));
+    }
+
+    public function testFindLanguageWithNotExistingRequestLanguageAndNotExistingStoredUserLanguage(): void {
+        $factory = $this->getFactory(['languageExists'], true);
+        $this->invokePrivate($factory, 'requestLanguage', ['de']);
+        $factory->expects($this->exactly(3))
+            ->method('languageExists')
+            ->willReturnMap([
+                ['MyApp', 'de', false],
+                ['MyApp', 'jp', false],
+                ['MyApp', 'es', true],
+            ]);
+        $this->config
+            ->expects($this->exactly(2))
+            ->method('getSystemValue')
+            ->willReturnMap([
+                ['force_language', false, false],
+                ['default_language', false, 'es']
+            ]);
+        $user = $this->createMock(IUser::class);
+        $user->expects(self::once())
+            ->method('getUID')
+            ->willReturn('MyUserUid');
+        $this->userSession
+            ->expects(self::exactly(2))
+            ->method('getUser')
+            ->willReturn($user);
+        $this->config
+            ->expects(self::once())
+            ->method('getUserValue')
+            ->with('MyUserUid', 'core', 'lang', null)
+            ->willReturn('jp');
+
+        self::assertSame('es', $factory->findLanguage('MyApp'));
+    }
+
+    public function testFindLanguageWithNotExistingRequestLanguageAndNotExistingStoredUserLanguageAndNotExistingDefault(): void {
+        $factory = $this->getFactory(['languageExists'], true);
+        $this->invokePrivate($factory, 'requestLanguage', ['de']);
+        $factory->expects($this->exactly(3))
+            ->method('languageExists')
+            ->willReturnMap([
+                ['MyApp', 'de', false],
+                ['MyApp', 'jp', false],
+                ['MyApp', 'es', false],
+            ]);
+        $this->config
+            ->expects($this->exactly(2))
+            ->method('getSystemValue')
+            ->willReturnMap([
+                ['force_language', false, false],
+                ['default_language', false, 'es']
+            ]);
+        $user = $this->createMock(IUser::class);
+        $user->expects(self::once())
+            ->method('getUID')
+            ->willReturn('MyUserUid');
+        $this->userSession
+            ->expects(self::exactly(2))
+            ->method('getUser')
+            ->willReturn($user);
+        $this->config
+            ->expects(self::once())
+            ->method('getUserValue')
+            ->with('MyUserUid', 'core', 'lang', null)
+            ->willReturn('jp');
+        $this->config
+            ->expects(self::never())
+            ->method('setUserValue');
+
+        self::assertSame('en', $factory->findLanguage('MyApp'));
+    }
+
+    public function testFindLanguageWithNotExistingRequestLanguageAndNotExistingStoredUserLanguageAndNotExistingDefaultAndNoAppInScope(): void {
+        $factory = $this->getFactory(['languageExists'], true);
+        $this->invokePrivate($factory, 'requestLanguage', ['de']);
+        $factory->expects($this->exactly(3))
+            ->method('languageExists')
+            ->willReturnMap([
+                ['MyApp', 'de', false],
+                ['MyApp', 'jp', false],
+                ['MyApp', 'es', false],
+            ]);
+        $this->config
+            ->expects($this->exactly(2))
+            ->method('getSystemValue')
+            ->willReturnMap([
+                ['force_language', false, false],
+                ['default_language', false, 'es']
+            ]);
+        $user = $this->createMock(IUser::class);
+        $user->expects(self::once())
+            ->method('getUID')
+            ->willReturn('MyUserUid');
+        $this->userSession
+            ->expects(self::exactly(2))
+            ->method('getUser')
+            ->willReturn($user);
+        $this->config
+            ->expects(self::once())
+            ->method('getUserValue')
+            ->with('MyUserUid', 'core', 'lang', null)
+            ->willReturn('jp');
+        $this->config
+            ->expects(self::never())
+            ->method('setUserValue')
+            ->with('MyUserUid', 'core', 'lang', 'en');
+
+
+        self::assertSame('en', $factory->findLanguage('MyApp'));
+    }
+
+    public function testFindLanguageWithForcedLanguage(): void {
+        $factory = $this->getFactory(['languageExists']);
+        $this->config
+            ->expects($this->once())
+            ->method('getSystemValue')
+            ->with('force_language', false)
+            ->willReturn('de');
+
+        $factory->expects($this->once())
+            ->method('languageExists')
+            ->with('MyApp', 'de')
+            ->willReturn(true);
+
+        self::assertSame('de', $factory->findLanguage('MyApp'));
+    }
+
+    /**
+     * @param string|null $app
+     */
+    #[\PHPUnit\Framework\Attributes\DataProvider('dataFindAvailableLanguages')]
+    public function testFindAvailableLanguages($app): void {
+        $factory = $this->getFactory(['findL10nDir']);
+        $factory->expects(self::once())
+            ->method('findL10nDir')
+            ->with($app)
+            ->willReturn(\OC::$SERVERROOT . '/tests/data/l10n/');
+
+        self::assertEqualsCanonicalizing(['cs', 'de', 'en', 'ru'], $factory->findAvailableLanguages($app));
+    }
+
+    public static function dataLanguageExists(): array {
+        return [
+            [null, 'en', [], true],
+            [null, 'de', [], false],
+            [null, 'de', ['ru'], false],
+            [null, 'de', ['ru', 'de'], true],
+            ['files', 'en', [], true],
+            ['files', 'de', [], false],
+            ['files', 'de', ['ru'], false],
+            ['files', 'de', ['de', 'ru'], true],
+        ];
+    }
+
+    public function testFindAvailableLanguagesWithThemes(): void {
+        $this->serverRoot .= '/tests/data';
+        $app = 'files';
+
+        $factory = $this->getFactory(['findL10nDir']);
+        $factory->expects(self::once())
+            ->method('findL10nDir')
+            ->with($app)
+            ->willReturn($this->serverRoot . '/apps/files/l10n/');
+        $this->config
+            ->expects(self::once())
+            ->method('getSystemValueString')
+            ->with('theme')
+            ->willReturn('abc');
+
+        self::assertEqualsCanonicalizing(['en', 'zz'], $factory->findAvailableLanguages($app));
+    }
+
+    /**
+     *
+     * @param string|null $app
+     * @param string $lang
+     * @param string[] $availableLanguages
+     * @param string $expected
+     */
+    #[\PHPUnit\Framework\Attributes\DataProvider('dataLanguageExists')]
+    public function testLanguageExists($app, $lang, array $availableLanguages, $expected): void {
+        $factory = $this->getFactory(['findAvailableLanguages']);
+        $factory->expects(($lang === 'en') ? self::never() : self::once())
+            ->method('findAvailableLanguages')
+            ->with($app)
+            ->willReturn($availableLanguages);
+
+        self::assertSame($expected, $factory->languageExists($app, $lang));
+    }
+
+    public static function dataSetLanguageFromRequest(): array {
+        return [
+            // Language is available
+            [null, 'de', ['de'], 'de'],
+            [null, 'de,en', ['de'], 'de'],
+            [null, 'de-DE,en-US;q=0.8,en;q=0.6', ['de'], 'de'],
+            // Language is not available
+            [null, 'de', ['ru'], new LanguageNotFoundException()],
+            [null, 'de,en', ['ru', 'en'], 'en'],
+            [null, 'de-DE,en-US;q=0.8,en;q=0.6', ['ru', 'en'], 'en'],
+
+            // Don't fall back from kab (Kabyle) to ka (Georgian) - Unless specifically requested
+            [null, 'kab;q=0.8,en;q=0.6', ['ka', 'en'], 'en'],
+            [null, 'kab;q=0.8,de;q=0.6', ['ka', 'en', 'de'], 'de'],
+            [null, 'kab;q=0.8,de;q=0.7,ka;q=0.6', ['ka', 'en', 'de'], 'de'],
+            [null, 'kab;q=0.8,ka;q=0.7,de;q=0.6', ['ka', 'en', 'de'], 'ka'],
+
+            // Language for app
+            ['files_pdfviewer', 'de', ['de'], 'de'],
+            ['files_pdfviewer', 'de,en', ['de'], 'de'],
+            ['files_pdfviewer', 'de-DE,en-US;q=0.8,en;q=0.6', ['de'], 'de'],
+            // Language for app is not available
+            ['files_pdfviewer', 'de', ['ru'], new LanguageNotFoundException()],
+            ['files_pdfviewer', 'de,en', ['ru', 'en'], 'en'],
+            ['files_pdfviewer', 'de-DE,en-US;q=0.8,en;q=0.6', ['ru', 'en'], 'en'],
+        ];
+    }
+
+    /**
+     *
+     * @param string|null $app
+     * @param string $header
+     * @param string[] $availableLanguages
+     * @param string $expected
+     */
+    #[\PHPUnit\Framework\Attributes\DataProvider('dataSetLanguageFromRequest')]
+    public function testGetLanguageFromRequest($app, $header, array $availableLanguages, $expected): void {
+        $factory = $this->getFactory(['findAvailableLanguages', 'respectDefaultLanguage']);
+        $factory->expects(self::once())
+            ->method('findAvailableLanguages')
+            ->with($app)
+            ->willReturn($availableLanguages);
+
+        $factory->expects(self::any())
+            ->method('respectDefaultLanguage')->willReturnCallback(function ($app, $lang) {
+                return $lang;
+            });
+
+        $this->request->expects(self::once())
+            ->method('getHeader')
+            ->with('ACCEPT_LANGUAGE')
+            ->willReturn($header);
+
+        if ($expected instanceof LanguageNotFoundException) {
+            $this->expectException(LanguageNotFoundException::class);
+            self::invokePrivate($factory, 'getLanguageFromRequest', [$app]);
+        } else {
+            self::assertSame($expected, self::invokePrivate($factory, 'getLanguageFromRequest', [$app]), 'Asserting returned language');
+        }
+    }
+
+    public static function dataGetL10nFilesForApp(): array {
+        return [
+            ['', 'de', [\OC::$SERVERROOT . '/core/l10n/de.json']],
+            ['core', 'ru', [\OC::$SERVERROOT . '/core/l10n/ru.json']],
+            ['lib', 'ru', [\OC::$SERVERROOT . '/lib/l10n/ru.json']],
+            ['settings', 'de', [\OC::$SERVERROOT . '/apps/settings/l10n/de.json']],
+            ['files', 'de', [\OC::$SERVERROOT . '/apps/files/l10n/de.json']],
+            ['files', '_lang_never_exists_', []],
+            ['_app_never_exists_', 'de', [\OC::$SERVERROOT . '/core/l10n/de.json']],
+        ];
+    }
+
+    /**
+     *
+     * @param string $app
+     * @param string $expected
+     */
+    #[\PHPUnit\Framework\Attributes\DataProvider('dataGetL10nFilesForApp')]
+    public function testGetL10nFilesForApp($app, $lang, $expected): void {
+        $factory = $this->getFactory();
+        if (in_array($app, ['settings','files'])) {
+            $this->appManager
+                ->method('getAppPath')
+                ->with($app)
+                ->willReturn(\OC::$SERVERROOT . '/apps/' . $app);
+        } else {
+            $this->appManager
+                ->method('getAppPath')
+                ->with($app)
+                ->willThrowException(new AppPathNotFoundException());
+        }
+        self::assertSame($expected, $this->invokePrivate($factory, 'getL10nFilesForApp', [$app, $lang]));
+    }
+
+    public static function dataFindL10NDir(): array {
+        return [
+            ['', \OC::$SERVERROOT . '/core/l10n/'],
+            ['core', \OC::$SERVERROOT . '/core/l10n/'],
+            ['lib', \OC::$SERVERROOT . '/lib/l10n/'],
+            ['settings', \OC::$SERVERROOT . '/apps/settings/l10n/'],
+            ['files', \OC::$SERVERROOT . '/apps/files/l10n/'],
+            ['_app_never_exists_', \OC::$SERVERROOT . '/core/l10n/'],
+        ];
+    }
+
+    /**
+     *
+     * @param string $app
+     * @param string $expected
+     */
+    #[\PHPUnit\Framework\Attributes\DataProvider('dataFindL10NDir')]
+    public function testFindL10NDir($app, $expected): void {
+        $factory = $this->getFactory();
+        if (in_array($app, ['settings','files'])) {
+            $this->appManager
+                ->method('getAppPath')
+                ->with($app)
+                ->willReturn(\OC::$SERVERROOT . '/apps/' . $app);
+        } else {
+            $this->appManager
+                ->method('getAppPath')
+                ->with($app)
+                ->willThrowException(new AppPathNotFoundException());
+        }
+        self::assertSame($expected, $this->invokePrivate($factory, 'findL10nDir', [$app]));
+    }
+
+    public static function dataFindLanguage(): array {
+        return [
+            // Not logged in
+            [false, [], 'en'],
+            [false, ['fr'], 'fr'],
+            [false, ['de', 'fr'], 'de'],
+            [false, ['nl', 'de', 'fr'], 'de'],
+
+            [true, [], 'en'],
+            [true, ['fr'], 'fr'],
+            [true, ['de', 'fr'], 'de'],
+            [true, ['nl', 'de', 'fr'], 'nl'],
+        ];
+    }
+
+    /**
+     *
+     * @param bool $loggedIn
+     * @param array $availableLang
+     * @param string $expected
+     */
+    #[\PHPUnit\Framework\Attributes\DataProvider('dataFindLanguage')]
+    public function testFindLanguage($loggedIn, $availableLang, $expected): void {
+        $userLang = 'nl';
+        $browserLang = 'de';
+        $defaultLang = 'fr';
+
+        $this->config->expects(self::any())
+            ->method('getSystemValue')
+            ->willReturnCallback(function ($var, $default) use ($defaultLang) {
+                if ($var === 'default_language') {
+                    return $defaultLang;
+                } else {
+                    return $default;
+                }
+            });
+
+        if ($loggedIn) {
+            $user = $this->createMock(IUser::class);
+            $user->expects(self::any())
+                ->method('getUID')
+                ->willReturn('MyUserUid');
+            $this->userSession
+                ->expects(self::any())
+                ->method('getUser')
+                ->willReturn($user);
+            $this->config->expects(self::any())
+                ->method('getUserValue')
+                ->with('MyUserUid', 'core', 'lang', null)
+                ->willReturn($userLang);
+        } else {
+            $this->userSession
+                ->expects(self::any())
+                ->method('getUser')
+                ->willReturn(null);
+        }
+
+        $this->request->expects(self::any())
+            ->method('getHeader')
+            ->with($this->equalTo('ACCEPT_LANGUAGE'))
+            ->willReturn($browserLang);
+
+        $factory = $this->getFactory(['languageExists', 'findAvailableLanguages', 'respectDefaultLanguage']);
+        $factory->expects(self::any())
+            ->method('languageExists')
+            ->willReturnCallback(function ($app, $lang) use ($availableLang) {
+                return in_array($lang, $availableLang);
+            });
+        $factory->expects(self::any())
+            ->method('findAvailableLanguages')
+            ->willReturnCallback(function ($app) use ($availableLang) {
+                return $availableLang;
+            });
+        $factory->expects(self::any())
+            ->method('respectDefaultLanguage')->willReturnCallback(function ($app, $lang) {
+                return $lang;
+            });
+
+        $lang = $factory->findLanguage();
+
+        self::assertSame($expected, $lang);
+    }
+
+    public function testFindGenericLanguageByRequestParam(): void {
+        $factory = $this->getFactory();
+        $this->request->expects(self::once())
+            ->method('getParam')
+            ->with('forceLanguage')
+            ->willReturn('cz');
+
+        $lang = $factory->findGenericLanguage();
+
+        self::assertSame('cz', $lang);
+    }
+
+    public function testFindGenericLanguageByEnforcedLanguage(): void {
+        $factory = $this->getFactory();
+        $this->request->expects(self::once())
+            ->method('getParam')
+            ->with('forceLanguage')
+            ->willReturn(null);
+        $this->config->expects(self::once())
+            ->method('getSystemValue')
+            ->with('force_language', false)
+            ->willReturn('cz');
+
+        $lang = $factory->findGenericLanguage();
+
+        self::assertSame('cz', $lang);
+    }
+
+    public function testFindGenericLanguageByDefaultLanguage(): void {
+        $factory = $this->getFactory(['languageExists']);
+        $this->request->expects(self::once())
+            ->method('getParam')
+            ->with('forceLanguage')
+            ->willReturn(null);
+        $this->config->expects(self::exactly(2))
+            ->method('getSystemValue')
+            ->willReturnMap([
+                ['force_language', false, false,],
+                ['default_language', false, 'cz',],
+            ]);
+        $factory->expects(self::once())
+            ->method('languageExists')
+            ->with(null, 'cz')
+            ->willReturn(true);
+
+        $lang = $factory->findGenericLanguage();
+
+        self::assertSame('cz', $lang);
+    }
+
+    public function testFindGenericLanguageByDefaultLanguageNotExists(): void {
+        $factory = $this->getFactory(['languageExists']);
+        $this->request->expects(self::once())
+            ->method('getParam')
+            ->with('forceLanguage')
+            ->willReturn(null);
+        $this->config->expects(self::exactly(2))
+            ->method('getSystemValue')
+            ->willReturnMap([
+                ['force_language', false, false,],
+                ['default_language', false, 'cz',],
+            ]);
+        $factory->expects(self::once())
+            ->method('languageExists')
+            ->with(null, 'cz')
+            ->willReturn(false);
+
+        $lang = $factory->findGenericLanguage();
+
+        self::assertSame('en', $lang);
+    }
+
+    public function testFindGenericLanguageFallback(): void {
+        $factory = $this->getFactory();
+        $this->request->expects(self::once())
+            ->method('getParam')
+            ->with('forceLanguage')
+            ->willReturn(null);
+        $this->config->expects(self::exactly(2))
+            ->method('getSystemValue')
+            ->willReturnMap([
+                ['force_language', false, false,],
+                ['default_language', false, false,],
+            ]);
+
+        $lang = $factory->findGenericLanguage();
+
+        self::assertSame('en', $lang);
+    }
+
+    public static function dataTestRespectDefaultLanguage(): array {
+        return [
+            ['de', 'de_DE', true, 'de_DE'],
+            ['de', 'de', true, 'de'],
+            ['de', false, true, 'de'],
+            ['fr', 'de_DE', true, 'fr'],
+        ];
+    }
+
+    /**
+     * test if we respect default language if possible
+     *
+     *
+     * @param string $lang
+     * @param string $defaultLanguage
+     * @param bool $langExists
+     * @param string $expected
+     */
+    #[\PHPUnit\Framework\Attributes\DataProvider('dataTestRespectDefaultLanguage')]
+    public function testRespectDefaultLanguage($lang, $defaultLanguage, $langExists, $expected): void {
+        $factory = $this->getFactory(['languageExists']);
+        $factory->expects(self::any())
+            ->method('languageExists')->willReturn($langExists);
+        $this->config->expects(self::any())
+            ->method('getSystemValue')->with('default_language', false)->willReturn($defaultLanguage);
+
+        $result = $this->invokePrivate($factory, 'respectDefaultLanguage', ['app', $lang]);
+        self::assertSame($expected, $result);
+    }
+
+    public static function dataTestReduceToLanguages(): array {
+        return [
+            ['en', ['en', 'de', 'fr', 'it', 'es'], ['en', 'fr', 'de'], ['en', 'fr', 'de']],
+            ['en', ['en', 'de', 'fr', 'it', 'es'], ['en', 'de'], ['en', 'de']],
+            ['en', ['en', 'de', 'fr', 'it', 'es'], [], ['de', 'en', 'es', 'fr', 'it']],
+        ];
+    }
+
+    /**
+     * test
+     * - if available languages set can be reduced by configuration
+     * - if available languages set is not reduced to an empty set if
+     *   the reduce config is an empty set
+     *
+     *
+     * @param string $lang
+     * @param array $availableLanguages
+     * @param array $reducedLanguageSet
+     * @param array $expected
+     */
+    #[\PHPUnit\Framework\Attributes\DataProvider('dataTestReduceToLanguages')]
+    public function testReduceLanguagesByConfiguration(string $lang, array $availableLanguages, array $reducedLanguageSet, array $expected): void {
+        $factory = $this->getFactory(['findAvailableLanguages', 'languageExists']);
+        $factory->expects(self::any())
+            ->method('languageExists')->willReturn(true);
+        $factory->expects(self::any())
+            ->method('findAvailableLanguages')
+            ->willReturnCallback(function ($app) use ($availableLanguages) {
+                return $availableLanguages;
+            });
+
+        $this->config
+            ->method('getSystemValue')
+            ->willReturnMap([
+                ['force_language', false, false],
+                ['default_language', false, $lang],
+                ['reduce_to_languages', [], $reducedLanguageSet]
+            ]);
+
+        $result = $this->invokePrivate($factory, 'getLanguages');
+        $commonLanguagesCodes = array_map(function ($lang) {
+            return $lang['code'];
+        }, $result['commonLanguages']);
+
+        self::assertEqualsCanonicalizing($expected, $commonLanguagesCodes);
+    }
+
+    public static function languageIteratorRequestProvider(): array {
+        return [
+            [ true, true],
+            [ false, true],
+            [ false, false],
+        ];
+    }
+
+    #[\PHPUnit\Framework\Attributes\DataProvider('languageIteratorRequestProvider')]
+    public function testGetLanguageIterator(bool $hasSession, bool $mockUser): void {
+        $factory = $this->getFactory();
+        $user = null;
+
+        if (!$mockUser) {
+            $matcher = $this->userSession->expects(self::once())
+                ->method('getUser');
+
+            if ($hasSession) {
+                $matcher->willReturn($this->createMock(IUser::class));
+            } else {
+                $this->expectException(\RuntimeException::class);
+            }
+        } else {
+            $user = $this->createMock(IUser::class);
+        }
+
+        $iterator = $factory->getLanguageIterator($user);
+        self::assertInstanceOf(ILanguageIterator::class, $iterator);
+    }
+
+    public static function dataGetLanguageDirection(): array {
+        return [
+            ['en', 'ltr'],
+            ['de', 'ltr'],
+            ['fa', 'rtl'],
+            ['ar', 'rtl']
+        ];
+    }
+
+    #[\PHPUnit\Framework\Attributes\DataProvider('dataGetLanguageDirection')]
+    public function testGetLanguageDirection(string $language, string $expectedDirection) {
+        $factory = $this->getFactory();
+
+        self::assertEquals($expectedDirection, $factory->getLanguageDirection($language));
+    }
 }