nextcloud / server

lib/public/IUser.php

Indentation +299 added lines, -299 removed lines

@@ -15,303 +15,303 @@
  * @since 8.0.0
  */
 interface IUser {
-	/**
-	 * @since 32.0.0
-	 */
-	public const MAX_USERID_LENGTH = 64;
-
-	/**
-	 * get the user id
-	 *
-	 * @return string
-	 * @since 8.0.0
-	 */
-	public function getUID();
-
-	/**
-	 * get the display name for the user, if no specific display name is set it will fallback to the user id
-	 *
-	 * @return string
-	 * @since 8.0.0
-	 */
-	public function getDisplayName();
-
-	/**
-	 * set the display name for the user
-	 *
-	 * @param string $displayName
-	 * @return bool
-	 * @since 8.0.0
-	 *
-	 * @since 25.0.0 Throw InvalidArgumentException
-	 * @throws \InvalidArgumentException
-	 */
-	public function setDisplayName($displayName);
-
-	/**
-	 * returns the timestamp of the user's last login or 0 if the user did never
-	 * login
-	 *
-	 * @return int
-	 * @since 8.0.0
-	 */
-	public function getLastLogin(): int;
-
-	/**
-	 * Returns the timestamp of the user's first login, 0 if the user did never login, or -1 if the data is unknown (first login was on an older version)
-	 *
-	 * @since 31.0.0
-	 */
-	public function getFirstLogin(): int;
-
-	/**
-	 * Updates the timestamp of the most recent login of this user (and first login if needed)
-	 *
-	 * @return bool whether this is the first login
-	 * @since 8.0.0
-	 */
-	public function updateLastLoginTimestamp(): bool;
-
-	/**
-	 * Delete the user
-	 *
-	 * @return bool
-	 * @since 8.0.0
-	 */
-	public function delete();
-
-	/**
-	 * Set the password of the user
-	 *
-	 * @param string $password
-	 * @param string $recoveryPassword for the encryption app to reset encryption keys
-	 * @return bool
-	 * @since 8.0.0
-	 */
-	public function setPassword($password, $recoveryPassword = null);
-
-	/**
-	 * Get the password hash of the user
-	 *
-	 * @return ?string the password hash hashed by `\OCP\Security\IHasher::hash()`
-	 * @since 30.0.0
-	 */
-	public function getPasswordHash(): ?string;
-
-	/**
-	 * Set the password hash of the user
-	 *
-	 * @param string $passwordHash the password hash hashed by `\OCP\Security\IHasher::hash()`
-	 * @throws InvalidArgumentException when `$passwordHash` is not a valid hash
-	 * @since 30.0.0
-	 */
-	public function setPasswordHash(string $passwordHash): bool;
-
-	/**
-	 * get the users home folder to mount
-	 *
-	 * @return string
-	 * @since 8.0.0
-	 */
-	public function getHome();
-
-	/**
-	 * Get the name of the backend class the user is connected with
-	 *
-	 * @return string
-	 * @since 8.0.0
-	 */
-	public function getBackendClassName();
-
-	/**
-	 * Get the backend for the current user object
-	 * @return ?UserInterface
-	 * @since 15.0.0
-	 */
-	public function getBackend();
-
-	/**
-	 * check if the backend allows the user to change their avatar on Personal page
-	 *
-	 * @return bool
-	 * @since 8.0.0
-	 */
-	public function canChangeAvatar();
-
-	/**
-	 * check if the backend supports changing passwords
-	 *
-	 * @return bool
-	 * @since 8.0.0
-	 */
-	public function canChangePassword();
-
-	/**
-	 * check if the backend supports changing display names
-	 *
-	 * @return bool
-	 * @since 8.0.0
-	 */
-	public function canChangeDisplayName();
-
-	/**
-	 * Check if the backend supports changing email
-	 *
-	 * @since 32.0.0
-	 */
-	public function canChangeEmail(): bool;
-
-	/**
-	 * check if the user is enabled
-	 *
-	 * @return bool
-	 * @since 8.0.0
-	 */
-	public function isEnabled();
-
-	/**
-	 * set the enabled status for the user
-	 *
-	 * @param bool $enabled
-	 * @since 8.0.0
-	 */
-	public function setEnabled(bool $enabled = true);
-
-	/**
-	 * get the user's email address
-	 *
-	 * @return string|null
-	 * @since 9.0.0
-	 */
-	public function getEMailAddress();
-
-	/**
-	 * get the user's system email address
-	 *
-	 * The system mail address may be read only and may be set from different
-	 * sources like LDAP, SAML or simply the admin.
-	 *
-	 * Use this getter only when the system address is needed. For picking the
-	 * proper address to e.g. send a mail to, use getEMailAddress().
-	 *
-	 * @return string|null
-	 * @since 23.0.0
-	 */
-	public function getSystemEMailAddress(): ?string;
-
-	/**
-	 * get the user's preferred email address
-	 *
-	 * The primary mail address may be set be the user to specify a different
-	 * email address where mails by Nextcloud are sent to. It is not necessarily
-	 * set.
-	 *
-	 * Use this getter only when the primary address is needed. For picking the
-	 * proper address to e.g. send a mail to, use getEMailAddress().
-	 *
-	 * @return string|null
-	 * @since 23.0.0
-	 */
-	public function getPrimaryEMailAddress(): ?string;
-
-	/**
-	 * get the avatar image if it exists
-	 *
-	 * @param int $size
-	 * @return IImage|null
-	 * @since 9.0.0
-	 */
-	public function getAvatarImage($size);
-
-	/**
-	 * get the federation cloud id
-	 *
-	 * @return string
-	 * @since 9.0.0
-	 */
-	public function getCloudId();
-
-	/**
-	 * set the email address of the user
-	 *
-	 * It is an alias to setSystemEMailAddress()
-	 *
-	 * @param string|null $mailAddress
-	 * @return void
-	 * @since 9.0.0
-	 * @deprecated 23.0.0 use setSystemEMailAddress() or setPrimaryEMailAddress()
-	 */
-	public function setEMailAddress($mailAddress);
-
-	/**
-	 * Set the system email address of the user
-	 *
-	 * This is supposed to be used when the email is set from different sources
-	 * (i.e. other user backends, admin).
-	 *
-	 * @since 23.0.0
-	 */
-	public function setSystemEMailAddress(string $mailAddress): void;
-
-	/**
-	 * Set the primary email address of the user.
-	 *
-	 * This method should be typically called when the user is changing their
-	 * own primary address and is not allowed to change their system email.
-	 *
-	 * The mail address provided here must be already registered as an
-	 * additional mail in the user account and also be verified locally. Also
-	 * an empty string is allowed to delete this preference.
-	 *
-	 * @throws InvalidArgumentException when the provided email address does not
-	 *                                  satisfy constraints.
-	 *
-	 * @since 23.0.0
-	 */
-	public function setPrimaryEMailAddress(string $mailAddress): void;
-
-	/**
-	 * get the users' quota in human readable form. If a specific quota is not
-	 * set for the user, the default value is returned. If a default setting
-	 * was not set otherwise, it is return as 'none', i.e. quota is not limited.
-	 *
-	 * @return string
-	 * @since 9.0.0
-	 */
-	public function getQuota();
-
-	/**
-	 * Get the users' quota in machine readable form. If a specific quota is set
-	 * for the user, then the quota is returned in bytes. Otherwise the default value is returned.
-	 * If a default setting was not set, it is return as `\OCP\Files\FileInfo::SPACE_UNLIMITED`, i.e. quota is not limited.
-	 *
-	 * @since 32.0.0
-	 */
-	public function getQuotaBytes(): int|float;
-
-	/**
-	 * set the users' quota
-	 *
-	 * @param string $quota
-	 * @return void
-	 * @since 9.0.0
-	 */
-	public function setQuota($quota);
-
-	/**
-	 * Get the user's manager UIDs
-	 *
-	 * @since 27.0.0
-	 * @return string[]
-	 */
-	public function getManagerUids(): array;
-
-	/**
-	 * Set the user's manager UIDs
-	 *
-	 * @param string[] $uids UIDs of all managers
-	 * @return void
-	 * @since 27.0.0
-	 */
-	public function setManagerUids(array $uids): void;
+    /**
+     * @since 32.0.0
+     */
+    public const MAX_USERID_LENGTH = 64;
+
+    /**
+     * get the user id
+     *
+     * @return string
+     * @since 8.0.0
+     */
+    public function getUID();
+
+    /**
+     * get the display name for the user, if no specific display name is set it will fallback to the user id
+     *
+     * @return string
+     * @since 8.0.0
+     */
+    public function getDisplayName();
+
+    /**
+     * set the display name for the user
+     *
+     * @param string $displayName
+     * @return bool
+     * @since 8.0.0
+     *
+     * @since 25.0.0 Throw InvalidArgumentException
+     * @throws \InvalidArgumentException
+     */
+    public function setDisplayName($displayName);
+
+    /**
+     * returns the timestamp of the user's last login or 0 if the user did never
+     * login
+     *
+     * @return int
+     * @since 8.0.0
+     */
+    public function getLastLogin(): int;
+
+    /**
+     * Returns the timestamp of the user's first login, 0 if the user did never login, or -1 if the data is unknown (first login was on an older version)
+     *
+     * @since 31.0.0
+     */
+    public function getFirstLogin(): int;
+
+    /**
+     * Updates the timestamp of the most recent login of this user (and first login if needed)
+     *
+     * @return bool whether this is the first login
+     * @since 8.0.0
+     */
+    public function updateLastLoginTimestamp(): bool;
+
+    /**
+     * Delete the user
+     *
+     * @return bool
+     * @since 8.0.0
+     */
+    public function delete();
+
+    /**
+     * Set the password of the user
+     *
+     * @param string $password
+     * @param string $recoveryPassword for the encryption app to reset encryption keys
+     * @return bool
+     * @since 8.0.0
+     */
+    public function setPassword($password, $recoveryPassword = null);
+
+    /**
+     * Get the password hash of the user
+     *
+     * @return ?string the password hash hashed by `\OCP\Security\IHasher::hash()`
+     * @since 30.0.0
+     */
+    public function getPasswordHash(): ?string;
+
+    /**
+     * Set the password hash of the user
+     *
+     * @param string $passwordHash the password hash hashed by `\OCP\Security\IHasher::hash()`
+     * @throws InvalidArgumentException when `$passwordHash` is not a valid hash
+     * @since 30.0.0
+     */
+    public function setPasswordHash(string $passwordHash): bool;
+
+    /**
+     * get the users home folder to mount
+     *
+     * @return string
+     * @since 8.0.0
+     */
+    public function getHome();
+
+    /**
+     * Get the name of the backend class the user is connected with
+     *
+     * @return string
+     * @since 8.0.0
+     */
+    public function getBackendClassName();
+
+    /**
+     * Get the backend for the current user object
+     * @return ?UserInterface
+     * @since 15.0.0
+     */
+    public function getBackend();
+
+    /**
+     * check if the backend allows the user to change their avatar on Personal page
+     *
+     * @return bool
+     * @since 8.0.0
+     */
+    public function canChangeAvatar();
+
+    /**
+     * check if the backend supports changing passwords
+     *
+     * @return bool
+     * @since 8.0.0
+     */
+    public function canChangePassword();
+
+    /**
+     * check if the backend supports changing display names
+     *
+     * @return bool
+     * @since 8.0.0
+     */
+    public function canChangeDisplayName();
+
+    /**
+     * Check if the backend supports changing email
+     *
+     * @since 32.0.0
+     */
+    public function canChangeEmail(): bool;
+
+    /**
+     * check if the user is enabled
+     *
+     * @return bool
+     * @since 8.0.0
+     */
+    public function isEnabled();
+
+    /**
+     * set the enabled status for the user
+     *
+     * @param bool $enabled
+     * @since 8.0.0
+     */
+    public function setEnabled(bool $enabled = true);
+
+    /**
+     * get the user's email address
+     *
+     * @return string|null
+     * @since 9.0.0
+     */
+    public function getEMailAddress();
+
+    /**
+     * get the user's system email address
+     *
+     * The system mail address may be read only and may be set from different
+     * sources like LDAP, SAML or simply the admin.
+     *
+     * Use this getter only when the system address is needed. For picking the
+     * proper address to e.g. send a mail to, use getEMailAddress().
+     *
+     * @return string|null
+     * @since 23.0.0
+     */
+    public function getSystemEMailAddress(): ?string;
+
+    /**
+     * get the user's preferred email address
+     *
+     * The primary mail address may be set be the user to specify a different
+     * email address where mails by Nextcloud are sent to. It is not necessarily
+     * set.
+     *
+     * Use this getter only when the primary address is needed. For picking the
+     * proper address to e.g. send a mail to, use getEMailAddress().
+     *
+     * @return string|null
+     * @since 23.0.0
+     */
+    public function getPrimaryEMailAddress(): ?string;
+
+    /**
+     * get the avatar image if it exists
+     *
+     * @param int $size
+     * @return IImage|null
+     * @since 9.0.0
+     */
+    public function getAvatarImage($size);
+
+    /**
+     * get the federation cloud id
+     *
+     * @return string
+     * @since 9.0.0
+     */
+    public function getCloudId();
+
+    /**
+     * set the email address of the user
+     *
+     * It is an alias to setSystemEMailAddress()
+     *
+     * @param string|null $mailAddress
+     * @return void
+     * @since 9.0.0
+     * @deprecated 23.0.0 use setSystemEMailAddress() or setPrimaryEMailAddress()
+     */
+    public function setEMailAddress($mailAddress);
+
+    /**
+     * Set the system email address of the user
+     *
+     * This is supposed to be used when the email is set from different sources
+     * (i.e. other user backends, admin).
+     *
+     * @since 23.0.0
+     */
+    public function setSystemEMailAddress(string $mailAddress): void;
+
+    /**
+     * Set the primary email address of the user.
+     *
+     * This method should be typically called when the user is changing their
+     * own primary address and is not allowed to change their system email.
+     *
+     * The mail address provided here must be already registered as an
+     * additional mail in the user account and also be verified locally. Also
+     * an empty string is allowed to delete this preference.
+     *
+     * @throws InvalidArgumentException when the provided email address does not
+     *                                  satisfy constraints.
+     *
+     * @since 23.0.0
+     */
+    public function setPrimaryEMailAddress(string $mailAddress): void;
+
+    /**
+     * get the users' quota in human readable form. If a specific quota is not
+     * set for the user, the default value is returned. If a default setting
+     * was not set otherwise, it is return as 'none', i.e. quota is not limited.
+     *
+     * @return string
+     * @since 9.0.0
+     */
+    public function getQuota();
+
+    /**
+     * Get the users' quota in machine readable form. If a specific quota is set
+     * for the user, then the quota is returned in bytes. Otherwise the default value is returned.
+     * If a default setting was not set, it is return as `\OCP\Files\FileInfo::SPACE_UNLIMITED`, i.e. quota is not limited.
+     *
+     * @since 32.0.0
+     */
+    public function getQuotaBytes(): int|float;
+
+    /**
+     * set the users' quota
+     *
+     * @param string $quota
+     * @return void
+     * @since 9.0.0
+     */
+    public function setQuota($quota);
+
+    /**
+     * Get the user's manager UIDs
+     *
+     * @since 27.0.0
+     * @return string[]
+     */
+    public function getManagerUids(): array;
+
+    /**
+     * Set the user's manager UIDs
+     *
+     * @param string[] $uids UIDs of all managers
+     * @return void
+     * @since 27.0.0
+     */
+    public function setManagerUids(array $uids): void;
 }

Spacing +1 added lines, -1 removed lines

@@ -287,7 +287,7 @@
 	 *
 	 * @since 32.0.0
 	 */
-	public function getQuotaBytes(): int|float;
+	public function getQuotaBytes(): int | float;
 
 	/**
 	 * set the users' quota

lib/private/legacy/OC_Helper.php

Indentation +385 added lines, -385 removed lines

@@ -32,392 +32,392 @@
  * }
  */
 class OC_Helper {
-	private static $templateManager;
-	private static ?ICacheFactory $cacheFactory = null;
-	private static ?bool $quotaIncludeExternalStorage = null;
-
-	/**
-	 * Recursive copying of folders
-	 * @param string $src source folder
-	 * @param string $dest target folder
-	 * @return void
-	 * @deprecated 32.0.0 - use \OCP\Files\Folder::copy
-	 */
-	public static function copyr($src, $dest) {
-		if (!file_exists($src)) {
-			return;
-		}
-
-		if (is_dir($src)) {
-			if (!is_dir($dest)) {
-				mkdir($dest);
-			}
-			$files = scandir($src);
-			foreach ($files as $file) {
-				if ($file != '.' && $file != '..') {
-					self::copyr("$src/$file", "$dest/$file");
-				}
-			}
-		} else {
-			$validator = \OCP\Server::get(FilenameValidator::class);
-			if (!$validator->isForbidden($src)) {
-				copy($src, $dest);
-			}
-		}
-	}
-
-	/**
-	 * @deprecated 18.0.0
-	 * @return \OC\Files\Type\TemplateManager
-	 */
-	public static function getFileTemplateManager() {
-		if (!self::$templateManager) {
-			self::$templateManager = new \OC\Files\Type\TemplateManager();
-		}
-		return self::$templateManager;
-	}
-
-	/**
-	 * detect if a given program is found in the search PATH
-	 *
-	 * @param string $name
-	 * @param bool $path
-	 * @internal param string $program name
-	 * @internal param string $optional search path, defaults to $PATH
-	 * @return bool true if executable program found in path
-	 * @deprecated 32.0.0 use the \OCP\IBinaryFinder
-	 */
-	public static function canExecute($name, $path = false) {
-		// path defaults to PATH from environment if not set
-		if ($path === false) {
-			$path = getenv('PATH');
-		}
-		// we look for an executable file of that name
-		$exts = [''];
-		$check_fn = 'is_executable';
-		// Default check will be done with $path directories :
-		$dirs = explode(PATH_SEPARATOR, (string)$path);
-		// WARNING : We have to check if open_basedir is enabled :
-		$obd = OC::$server->get(IniGetWrapper::class)->getString('open_basedir');
-		if ($obd != 'none') {
-			$obd_values = explode(PATH_SEPARATOR, $obd);
-			if (count($obd_values) > 0 and $obd_values[0]) {
-				// open_basedir is in effect !
-				// We need to check if the program is in one of these dirs :
-				$dirs = $obd_values;
-			}
-		}
-		foreach ($dirs as $dir) {
-			foreach ($exts as $ext) {
-				if ($check_fn("$dir/$name" . $ext)) {
-					return true;
-				}
-			}
-		}
-		return false;
-	}
-
-	/**
-	 * copy the contents of one stream to another
-	 *
-	 * @param resource $source
-	 * @param resource $target
-	 * @return array the number of bytes copied and result
-	 * @deprecated 5.0.0 - Use \OCP\Files::streamCopy
-	 */
-	public static function streamCopy($source, $target) {
-		return \OCP\Files::streamCopy($source, $target, true);
-	}
-
-	/**
-	 * Adds a suffix to the name in case the file exists
-	 *
-	 * @param string $path
-	 * @param string $filename
-	 * @return string
-	 */
-	public static function buildNotExistingFileName($path, $filename) {
-		$view = \OC\Files\Filesystem::getView();
-		return self::buildNotExistingFileNameForView($path, $filename, $view);
-	}
-
-	/**
-	 * Adds a suffix to the name in case the file exists
-	 *
-	 * @param string $path
-	 * @param string $filename
-	 * @return string
-	 */
-	public static function buildNotExistingFileNameForView($path, $filename, \OC\Files\View $view) {
-		if ($path === '/') {
-			$path = '';
-		}
-		if ($pos = strrpos($filename, '.')) {
-			$name = substr($filename, 0, $pos);
-			$ext = substr($filename, $pos);
-		} else {
-			$name = $filename;
-			$ext = '';
-		}
-
-		$newpath = $path . '/' . $filename;
-		if ($view->file_exists($newpath)) {
-			if (preg_match_all('/\((\d+)\)/', $name, $matches, PREG_OFFSET_CAPTURE)) {
-				//Replace the last "(number)" with "(number+1)"
-				$last_match = count($matches[0]) - 1;
-				$counter = $matches[1][$last_match][0] + 1;
-				$offset = $matches[0][$last_match][1];
-				$match_length = strlen($matches[0][$last_match][0]);
-			} else {
-				$counter = 2;
-				$match_length = 0;
-				$offset = false;
-			}
-			do {
-				if ($offset) {
-					//Replace the last "(number)" with "(number+1)"
-					$newname = substr_replace($name, '(' . $counter . ')', $offset, $match_length);
-				} else {
-					$newname = $name . ' (' . $counter . ')';
-				}
-				$newpath = $path . '/' . $newname . $ext;
-				$counter++;
-			} while ($view->file_exists($newpath));
-		}
-
-		return $newpath;
-	}
-
-	/**
-	 * Checks if a function is available
-	 *
-	 * @deprecated 25.0.0 use \OCP\Util::isFunctionEnabled instead
-	 */
-	public static function is_function_enabled(string $function_name): bool {
-		return Util::isFunctionEnabled($function_name);
-	}
-
-	/**
-	 * Try to find a program
-	 * @deprecated 25.0.0 Use \OCP\IBinaryFinder directly
-	 */
-	public static function findBinaryPath(string $program): ?string {
-		$result = Server::get(IBinaryFinder::class)->findBinaryPath($program);
-		return $result !== false ? $result : null;
-	}
-
-	/**
-	 * Calculate the disc space for the given path
-	 *
-	 * BEWARE: this requires that Util::setupFS() was called
-	 * already !
-	 *
-	 * @param string $path
-	 * @param \OCP\Files\FileInfo $rootInfo (optional)
-	 * @param bool $includeMountPoints whether to include mount points in the size calculation
-	 * @param bool $useCache whether to use the cached quota values
-	 * @psalm-suppress LessSpecificReturnStatement Legacy code outputs weird types - manually validated that they are correct
-	 * @return StorageInfo
-	 * @throws \OCP\Files\NotFoundException
-	 */
-	public static function getStorageInfo($path, $rootInfo = null, $includeMountPoints = true, $useCache = true) {
-		if (!self::$cacheFactory) {
-			self::$cacheFactory = Server::get(ICacheFactory::class);
-		}
-		$memcache = self::$cacheFactory->createLocal('storage_info');
-
-		// return storage info without adding mount points
-		if (self::$quotaIncludeExternalStorage === null) {
-			self::$quotaIncludeExternalStorage = \OC::$server->getSystemConfig()->getValue('quota_include_external_storage', false);
-		}
-
-		$view = Filesystem::getView();
-		if (!$view) {
-			throw new \OCP\Files\NotFoundException();
-		}
-		$fullPath = Filesystem::normalizePath($view->getAbsolutePath($path));
-
-		$cacheKey = $fullPath . '::' . ($includeMountPoints ? 'include' : 'exclude');
-		if ($useCache) {
-			$cached = $memcache->get($cacheKey);
-			if ($cached) {
-				return $cached;
-			}
-		}
-
-		if (!$rootInfo) {
-			$rootInfo = \OC\Files\Filesystem::getFileInfo($path, self::$quotaIncludeExternalStorage ? 'ext' : false);
-		}
-		if (!$rootInfo instanceof \OCP\Files\FileInfo) {
-			throw new \OCP\Files\NotFoundException('The root directory of the user\'s files is missing');
-		}
-		$used = $rootInfo->getSize($includeMountPoints);
-		if ($used < 0) {
-			$used = 0.0;
-		}
-		/** @var int|float $quota */
-		$quota = \OCP\Files\FileInfo::SPACE_UNLIMITED;
-		$mount = $rootInfo->getMountPoint();
-		$storage = $mount->getStorage();
-		$sourceStorage = $storage;
-		if ($storage->instanceOfStorage('\OCA\Files_Sharing\SharedStorage')) {
-			self::$quotaIncludeExternalStorage = false;
-		}
-		if (self::$quotaIncludeExternalStorage) {
-			if ($storage->instanceOfStorage('\OC\Files\Storage\Home')
-				|| $storage->instanceOfStorage('\OC\Files\ObjectStore\HomeObjectStoreStorage')
-			) {
-				/** @var \OC\Files\Storage\Home $storage */
-				$user = $storage->getUser();
-			} else {
-				$user = \OC::$server->getUserSession()->getUser();
-			}
-			$quota = $user?->getQuotaBytes() ?? \OCP\Files\FileInfo::SPACE_UNKNOWN;
-			if ($quota !== \OCP\Files\FileInfo::SPACE_UNLIMITED) {
-				// always get free space / total space from root + mount points
-				return self::getGlobalStorageInfo($quota, $user, $mount);
-			}
-		}
-
-		// TODO: need a better way to get total space from storage
-		if ($sourceStorage->instanceOfStorage('\OC\Files\Storage\Wrapper\Quota')) {
-			/** @var \OC\Files\Storage\Wrapper\Quota $storage */
-			$quota = $sourceStorage->getQuota();
-		}
-		try {
-			$free = $sourceStorage->free_space($rootInfo->getInternalPath());
-			if (is_bool($free)) {
-				$free = 0.0;
-			}
-		} catch (\Exception $e) {
-			if ($path === '') {
-				throw $e;
-			}
-			/** @var LoggerInterface $logger */
-			$logger = \OC::$server->get(LoggerInterface::class);
-			$logger->warning('Error while getting quota info, using root quota', ['exception' => $e]);
-			$rootInfo = self::getStorageInfo('');
-			$memcache->set($cacheKey, $rootInfo, 5 * 60);
-			return $rootInfo;
-		}
-		if ($free >= 0) {
-			$total = $free + $used;
-		} else {
-			$total = $free; //either unknown or unlimited
-		}
-		if ($total > 0) {
-			if ($quota > 0 && $total > $quota) {
-				$total = $quota;
-			}
-			// prevent division by zero or error codes (negative values)
-			$relative = round(($used / $total) * 10000) / 100;
-		} else {
-			$relative = 0;
-		}
-
-		/*
+    private static $templateManager;
+    private static ?ICacheFactory $cacheFactory = null;
+    private static ?bool $quotaIncludeExternalStorage = null;
+
+    /**
+     * Recursive copying of folders
+     * @param string $src source folder
+     * @param string $dest target folder
+     * @return void
+     * @deprecated 32.0.0 - use \OCP\Files\Folder::copy
+     */
+    public static function copyr($src, $dest) {
+        if (!file_exists($src)) {
+            return;
+        }
+
+        if (is_dir($src)) {
+            if (!is_dir($dest)) {
+                mkdir($dest);
+            }
+            $files = scandir($src);
+            foreach ($files as $file) {
+                if ($file != '.' && $file != '..') {
+                    self::copyr("$src/$file", "$dest/$file");
+                }
+            }
+        } else {
+            $validator = \OCP\Server::get(FilenameValidator::class);
+            if (!$validator->isForbidden($src)) {
+                copy($src, $dest);
+            }
+        }
+    }
+
+    /**
+     * @deprecated 18.0.0
+     * @return \OC\Files\Type\TemplateManager
+     */
+    public static function getFileTemplateManager() {
+        if (!self::$templateManager) {
+            self::$templateManager = new \OC\Files\Type\TemplateManager();
+        }
+        return self::$templateManager;
+    }
+
+    /**
+     * detect if a given program is found in the search PATH
+     *
+     * @param string $name
+     * @param bool $path
+     * @internal param string $program name
+     * @internal param string $optional search path, defaults to $PATH
+     * @return bool true if executable program found in path
+     * @deprecated 32.0.0 use the \OCP\IBinaryFinder
+     */
+    public static function canExecute($name, $path = false) {
+        // path defaults to PATH from environment if not set
+        if ($path === false) {
+            $path = getenv('PATH');
+        }
+        // we look for an executable file of that name
+        $exts = [''];
+        $check_fn = 'is_executable';
+        // Default check will be done with $path directories :
+        $dirs = explode(PATH_SEPARATOR, (string)$path);
+        // WARNING : We have to check if open_basedir is enabled :
+        $obd = OC::$server->get(IniGetWrapper::class)->getString('open_basedir');
+        if ($obd != 'none') {
+            $obd_values = explode(PATH_SEPARATOR, $obd);
+            if (count($obd_values) > 0 and $obd_values[0]) {
+                // open_basedir is in effect !
+                // We need to check if the program is in one of these dirs :
+                $dirs = $obd_values;
+            }
+        }
+        foreach ($dirs as $dir) {
+            foreach ($exts as $ext) {
+                if ($check_fn("$dir/$name" . $ext)) {
+                    return true;
+                }
+            }
+        }
+        return false;
+    }
+
+    /**
+     * copy the contents of one stream to another
+     *
+     * @param resource $source
+     * @param resource $target
+     * @return array the number of bytes copied and result
+     * @deprecated 5.0.0 - Use \OCP\Files::streamCopy
+     */
+    public static function streamCopy($source, $target) {
+        return \OCP\Files::streamCopy($source, $target, true);
+    }
+
+    /**
+     * Adds a suffix to the name in case the file exists
+     *
+     * @param string $path
+     * @param string $filename
+     * @return string
+     */
+    public static function buildNotExistingFileName($path, $filename) {
+        $view = \OC\Files\Filesystem::getView();
+        return self::buildNotExistingFileNameForView($path, $filename, $view);
+    }
+
+    /**
+     * Adds a suffix to the name in case the file exists
+     *
+     * @param string $path
+     * @param string $filename
+     * @return string
+     */
+    public static function buildNotExistingFileNameForView($path, $filename, \OC\Files\View $view) {
+        if ($path === '/') {
+            $path = '';
+        }
+        if ($pos = strrpos($filename, '.')) {
+            $name = substr($filename, 0, $pos);
+            $ext = substr($filename, $pos);
+        } else {
+            $name = $filename;
+            $ext = '';
+        }
+
+        $newpath = $path . '/' . $filename;
+        if ($view->file_exists($newpath)) {
+            if (preg_match_all('/\((\d+)\)/', $name, $matches, PREG_OFFSET_CAPTURE)) {
+                //Replace the last "(number)" with "(number+1)"
+                $last_match = count($matches[0]) - 1;
+                $counter = $matches[1][$last_match][0] + 1;
+                $offset = $matches[0][$last_match][1];
+                $match_length = strlen($matches[0][$last_match][0]);
+            } else {
+                $counter = 2;
+                $match_length = 0;
+                $offset = false;
+            }
+            do {
+                if ($offset) {
+                    //Replace the last "(number)" with "(number+1)"
+                    $newname = substr_replace($name, '(' . $counter . ')', $offset, $match_length);
+                } else {
+                    $newname = $name . ' (' . $counter . ')';
+                }
+                $newpath = $path . '/' . $newname . $ext;
+                $counter++;
+            } while ($view->file_exists($newpath));
+        }
+
+        return $newpath;
+    }
+
+    /**
+     * Checks if a function is available
+     *
+     * @deprecated 25.0.0 use \OCP\Util::isFunctionEnabled instead
+     */
+    public static function is_function_enabled(string $function_name): bool {
+        return Util::isFunctionEnabled($function_name);
+    }
+
+    /**
+     * Try to find a program
+     * @deprecated 25.0.0 Use \OCP\IBinaryFinder directly
+     */
+    public static function findBinaryPath(string $program): ?string {
+        $result = Server::get(IBinaryFinder::class)->findBinaryPath($program);
+        return $result !== false ? $result : null;
+    }
+
+    /**
+     * Calculate the disc space for the given path
+     *
+     * BEWARE: this requires that Util::setupFS() was called
+     * already !
+     *
+     * @param string $path
+     * @param \OCP\Files\FileInfo $rootInfo (optional)
+     * @param bool $includeMountPoints whether to include mount points in the size calculation
+     * @param bool $useCache whether to use the cached quota values
+     * @psalm-suppress LessSpecificReturnStatement Legacy code outputs weird types - manually validated that they are correct
+     * @return StorageInfo
+     * @throws \OCP\Files\NotFoundException
+     */
+    public static function getStorageInfo($path, $rootInfo = null, $includeMountPoints = true, $useCache = true) {
+        if (!self::$cacheFactory) {
+            self::$cacheFactory = Server::get(ICacheFactory::class);
+        }
+        $memcache = self::$cacheFactory->createLocal('storage_info');
+
+        // return storage info without adding mount points
+        if (self::$quotaIncludeExternalStorage === null) {
+            self::$quotaIncludeExternalStorage = \OC::$server->getSystemConfig()->getValue('quota_include_external_storage', false);
+        }
+
+        $view = Filesystem::getView();
+        if (!$view) {
+            throw new \OCP\Files\NotFoundException();
+        }
+        $fullPath = Filesystem::normalizePath($view->getAbsolutePath($path));
+
+        $cacheKey = $fullPath . '::' . ($includeMountPoints ? 'include' : 'exclude');
+        if ($useCache) {
+            $cached = $memcache->get($cacheKey);
+            if ($cached) {
+                return $cached;
+            }
+        }
+
+        if (!$rootInfo) {
+            $rootInfo = \OC\Files\Filesystem::getFileInfo($path, self::$quotaIncludeExternalStorage ? 'ext' : false);
+        }
+        if (!$rootInfo instanceof \OCP\Files\FileInfo) {
+            throw new \OCP\Files\NotFoundException('The root directory of the user\'s files is missing');
+        }
+        $used = $rootInfo->getSize($includeMountPoints);
+        if ($used < 0) {
+            $used = 0.0;
+        }
+        /** @var int|float $quota */
+        $quota = \OCP\Files\FileInfo::SPACE_UNLIMITED;
+        $mount = $rootInfo->getMountPoint();
+        $storage = $mount->getStorage();
+        $sourceStorage = $storage;
+        if ($storage->instanceOfStorage('\OCA\Files_Sharing\SharedStorage')) {
+            self::$quotaIncludeExternalStorage = false;
+        }
+        if (self::$quotaIncludeExternalStorage) {
+            if ($storage->instanceOfStorage('\OC\Files\Storage\Home')
+                || $storage->instanceOfStorage('\OC\Files\ObjectStore\HomeObjectStoreStorage')
+            ) {
+                /** @var \OC\Files\Storage\Home $storage */
+                $user = $storage->getUser();
+            } else {
+                $user = \OC::$server->getUserSession()->getUser();
+            }
+            $quota = $user?->getQuotaBytes() ?? \OCP\Files\FileInfo::SPACE_UNKNOWN;
+            if ($quota !== \OCP\Files\FileInfo::SPACE_UNLIMITED) {
+                // always get free space / total space from root + mount points
+                return self::getGlobalStorageInfo($quota, $user, $mount);
+            }
+        }
+
+        // TODO: need a better way to get total space from storage
+        if ($sourceStorage->instanceOfStorage('\OC\Files\Storage\Wrapper\Quota')) {
+            /** @var \OC\Files\Storage\Wrapper\Quota $storage */
+            $quota = $sourceStorage->getQuota();
+        }
+        try {
+            $free = $sourceStorage->free_space($rootInfo->getInternalPath());
+            if (is_bool($free)) {
+                $free = 0.0;
+            }
+        } catch (\Exception $e) {
+            if ($path === '') {
+                throw $e;
+            }
+            /** @var LoggerInterface $logger */
+            $logger = \OC::$server->get(LoggerInterface::class);
+            $logger->warning('Error while getting quota info, using root quota', ['exception' => $e]);
+            $rootInfo = self::getStorageInfo('');
+            $memcache->set($cacheKey, $rootInfo, 5 * 60);
+            return $rootInfo;
+        }
+        if ($free >= 0) {
+            $total = $free + $used;
+        } else {
+            $total = $free; //either unknown or unlimited
+        }
+        if ($total > 0) {
+            if ($quota > 0 && $total > $quota) {
+                $total = $quota;
+            }
+            // prevent division by zero or error codes (negative values)
+            $relative = round(($used / $total) * 10000) / 100;
+        } else {
+            $relative = 0;
+        }
+
+        /*
 		 * \OCA\Files_Sharing\External\Storage returns the cloud ID as the owner for the storage.
 		 * It is unnecessary to query the user manager for the display name, as it won't have this information.
 		 */
-		$isRemoteShare = $storage->instanceOfStorage(\OCA\Files_Sharing\External\Storage::class);
-
-		$ownerId = $storage->getOwner($path);
-		$ownerDisplayName = '';
-
-		if ($isRemoteShare === false && $ownerId !== false) {
-			$ownerDisplayName = \OC::$server->getUserManager()->getDisplayName($ownerId) ?? '';
-		}
-
-		if (substr_count($mount->getMountPoint(), '/') < 3) {
-			$mountPoint = '';
-		} else {
-			[,,,$mountPoint] = explode('/', $mount->getMountPoint(), 4);
-		}
-
-		$info = [
-			'free' => $free,
-			'used' => $used,
-			'quota' => $quota,
-			'total' => $total,
-			'relative' => $relative,
-			'owner' => $ownerId,
-			'ownerDisplayName' => $ownerDisplayName,
-			'mountType' => $mount->getMountType(),
-			'mountPoint' => trim($mountPoint, '/'),
-		];
-
-		if ($isRemoteShare === false && $ownerId !== false && $path === '/') {
-			// If path is root, store this as last known quota usage for this user
-			\OCP\Server::get(\OCP\IConfig::class)->setUserValue($ownerId, 'files', 'lastSeenQuotaUsage', (string)$relative);
-		}
-
-		$memcache->set($cacheKey, $info, 5 * 60);
-
-		return $info;
-	}
-
-	/**
-	 * Get storage info including all mount points and quota
-	 *
-	 * @psalm-suppress LessSpecificReturnStatement Legacy code outputs weird types - manually validated that they are correct
-	 * @return StorageInfo
-	 */
-	private static function getGlobalStorageInfo(int|float $quota, IUser $user, IMountPoint $mount): array {
-		$rootInfo = \OC\Files\Filesystem::getFileInfo('', 'ext');
-		/** @var int|float $used */
-		$used = $rootInfo['size'];
-		if ($used < 0) {
-			$used = 0.0;
-		}
-
-		$total = $quota;
-		/** @var int|float $free */
-		$free = $quota - $used;
-
-		if ($total > 0) {
-			if ($quota > 0 && $total > $quota) {
-				$total = $quota;
-			}
-			// prevent division by zero or error codes (negative values)
-			$relative = round(($used / $total) * 10000) / 100;
-		} else {
-			$relative = 0.0;
-		}
-
-		if (substr_count($mount->getMountPoint(), '/') < 3) {
-			$mountPoint = '';
-		} else {
-			[,,,$mountPoint] = explode('/', $mount->getMountPoint(), 4);
-		}
-
-		return [
-			'free' => $free,
-			'used' => $used,
-			'total' => $total,
-			'relative' => $relative,
-			'quota' => $quota,
-			'owner' => $user->getUID(),
-			'ownerDisplayName' => $user->getDisplayName(),
-			'mountType' => $mount->getMountType(),
-			'mountPoint' => trim($mountPoint, '/'),
-		];
-	}
-
-	public static function clearStorageInfo(string $absolutePath): void {
-		/** @var ICacheFactory $cacheFactory */
-		$cacheFactory = \OC::$server->get(ICacheFactory::class);
-		$memcache = $cacheFactory->createLocal('storage_info');
-		$cacheKeyPrefix = Filesystem::normalizePath($absolutePath) . '::';
-		$memcache->remove($cacheKeyPrefix . 'include');
-		$memcache->remove($cacheKeyPrefix . 'exclude');
-	}
-
-	/**
-	 * Returns whether the config file is set manually to read-only
-	 * @return bool
-	 * @deprecated 32.0.0 use the `config_is_read_only` system config directly
-	 */
-	public static function isReadOnlyConfigEnabled() {
-		return \OC::$server->getConfig()->getSystemValueBool('config_is_read_only', false);
-	}
+        $isRemoteShare = $storage->instanceOfStorage(\OCA\Files_Sharing\External\Storage::class);
+
+        $ownerId = $storage->getOwner($path);
+        $ownerDisplayName = '';
+
+        if ($isRemoteShare === false && $ownerId !== false) {
+            $ownerDisplayName = \OC::$server->getUserManager()->getDisplayName($ownerId) ?? '';
+        }
+
+        if (substr_count($mount->getMountPoint(), '/') < 3) {
+            $mountPoint = '';
+        } else {
+            [,,,$mountPoint] = explode('/', $mount->getMountPoint(), 4);
+        }
+
+        $info = [
+            'free' => $free,
+            'used' => $used,
+            'quota' => $quota,
+            'total' => $total,
+            'relative' => $relative,
+            'owner' => $ownerId,
+            'ownerDisplayName' => $ownerDisplayName,
+            'mountType' => $mount->getMountType(),
+            'mountPoint' => trim($mountPoint, '/'),
+        ];
+
+        if ($isRemoteShare === false && $ownerId !== false && $path === '/') {
+            // If path is root, store this as last known quota usage for this user
+            \OCP\Server::get(\OCP\IConfig::class)->setUserValue($ownerId, 'files', 'lastSeenQuotaUsage', (string)$relative);
+        }
+
+        $memcache->set($cacheKey, $info, 5 * 60);
+
+        return $info;
+    }
+
+    /**
+     * Get storage info including all mount points and quota
+     *
+     * @psalm-suppress LessSpecificReturnStatement Legacy code outputs weird types - manually validated that they are correct
+     * @return StorageInfo
+     */
+    private static function getGlobalStorageInfo(int|float $quota, IUser $user, IMountPoint $mount): array {
+        $rootInfo = \OC\Files\Filesystem::getFileInfo('', 'ext');
+        /** @var int|float $used */
+        $used = $rootInfo['size'];
+        if ($used < 0) {
+            $used = 0.0;
+        }
+
+        $total = $quota;
+        /** @var int|float $free */
+        $free = $quota - $used;
+
+        if ($total > 0) {
+            if ($quota > 0 && $total > $quota) {
+                $total = $quota;
+            }
+            // prevent division by zero or error codes (negative values)
+            $relative = round(($used / $total) * 10000) / 100;
+        } else {
+            $relative = 0.0;
+        }
+
+        if (substr_count($mount->getMountPoint(), '/') < 3) {
+            $mountPoint = '';
+        } else {
+            [,,,$mountPoint] = explode('/', $mount->getMountPoint(), 4);
+        }
+
+        return [
+            'free' => $free,
+            'used' => $used,
+            'total' => $total,
+            'relative' => $relative,
+            'quota' => $quota,
+            'owner' => $user->getUID(),
+            'ownerDisplayName' => $user->getDisplayName(),
+            'mountType' => $mount->getMountType(),
+            'mountPoint' => trim($mountPoint, '/'),
+        ];
+    }
+
+    public static function clearStorageInfo(string $absolutePath): void {
+        /** @var ICacheFactory $cacheFactory */
+        $cacheFactory = \OC::$server->get(ICacheFactory::class);
+        $memcache = $cacheFactory->createLocal('storage_info');
+        $cacheKeyPrefix = Filesystem::normalizePath($absolutePath) . '::';
+        $memcache->remove($cacheKeyPrefix . 'include');
+        $memcache->remove($cacheKeyPrefix . 'exclude');
+    }
+
+    /**
+     * Returns whether the config file is set manually to read-only
+     * @return bool
+     * @deprecated 32.0.0 use the `config_is_read_only` system config directly
+     */
+    public static function isReadOnlyConfigEnabled() {
+        return \OC::$server->getConfig()->getSystemValueBool('config_is_read_only', false);
+    }
 }

lib/private/legacy/OC_Util.php

Indentation +836 added lines, -836 removed lines

@@ -22,840 +22,840 @@
  * @deprecated 32.0.0 Use \OCP\Util or any appropriate official API instead
  */
 class OC_Util {
-	public static $styles = [];
-	public static $headers = [];
-
-	/**
-	 * Setup the file system
-	 *
-	 * @param string|null $user
-	 * @return boolean
-	 * @description configure the initial filesystem based on the configuration
-	 * @suppress PhanDeprecatedFunction
-	 * @suppress PhanAccessMethodInternal
-	 */
-	public static function setupFS(?string $user = '') {
-		// If we are not forced to load a specific user we load the one that is logged in
-		if ($user === '') {
-			$userObject = \OC::$server->get(\OCP\IUserSession::class)->getUser();
-		} else {
-			$userObject = \OC::$server->get(\OCP\IUserManager::class)->get($user);
-		}
-
-		/** @var SetupManager $setupManager */
-		$setupManager = \OC::$server->get(SetupManager::class);
-
-		if ($userObject) {
-			$setupManager->setupForUser($userObject);
-		} else {
-			$setupManager->setupRoot();
-		}
-		return true;
-	}
-
-	/**
-	 * Check if a password is required for each public link
-	 *
-	 * @param bool $checkGroupMembership Check group membership exclusion
-	 * @return bool
-	 * @deprecated 32.0.0 use OCP\Share\IManager's shareApiLinkEnforcePassword directly
-	 */
-	public static function isPublicLinkPasswordRequired(bool $checkGroupMembership = true) {
-		/** @var IManager $shareManager */
-		$shareManager = \OC::$server->get(IManager::class);
-		return $shareManager->shareApiLinkEnforcePassword($checkGroupMembership);
-	}
-
-	/**
-	 * check if sharing is disabled for the current user
-	 * @param IConfig $config
-	 * @param IGroupManager $groupManager
-	 * @param IUser|null $user
-	 * @return bool
-	 * @deprecated 32.0.0 use OCP\Share\IManager's sharingDisabledForUser directly
-	 */
-	public static function isSharingDisabledForUser(IConfig $config, IGroupManager $groupManager, $user) {
-		/** @var IManager $shareManager */
-		$shareManager = \OC::$server->get(IManager::class);
-		$userId = $user ? $user->getUID() : null;
-		return $shareManager->sharingDisabledForUser($userId);
-	}
-
-	/**
-	 * check if share API enforces a default expire date
-	 *
-	 * @return bool
-	 * @deprecated 32.0.0 use OCP\Share\IManager's shareApiLinkDefaultExpireDateEnforced directly
-	 */
-	public static function isDefaultExpireDateEnforced() {
-		/** @var IManager $shareManager */
-		$shareManager = \OC::$server->get(IManager::class);
-		return $shareManager->shareApiLinkDefaultExpireDateEnforced();
-	}
-
-	/**
-	 * Get the quota of a user
-	 *
-	 * @param IUser|null $user
-	 * @return int|\OCP\Files\FileInfo::SPACE_UNLIMITED|false|float Quota bytes
-	 * @deprecated 9.0.0 - Use \OCP\IUser::getQuota or \OCP\IUser::getQuotaBytes
-	 */
-	public static function getUserQuota(?IUser $user) {
-		if (is_null($user)) {
-			return \OCP\Files\FileInfo::SPACE_UNLIMITED;
-		}
-		$userQuota = $user->getQuota();
-		if ($userQuota === 'none') {
-			return \OCP\Files\FileInfo::SPACE_UNLIMITED;
-		}
-		return \OCP\Util::computerFileSize($userQuota);
-	}
-
-	/**
-	 * copies the skeleton to the users /files
-	 *
-	 * @param string $userId
-	 * @param \OCP\Files\Folder $userDirectory
-	 * @throws \OCP\Files\NotFoundException
-	 * @throws \OCP\Files\NotPermittedException
-	 * @suppress PhanDeprecatedFunction
-	 */
-	public static function copySkeleton($userId, \OCP\Files\Folder $userDirectory) {
-		/** @var LoggerInterface $logger */
-		$logger = \OC::$server->get(LoggerInterface::class);
-
-		$plainSkeletonDirectory = \OC::$server->getConfig()->getSystemValueString('skeletondirectory', \OC::$SERVERROOT . '/core/skeleton');
-		$userLang = \OC::$server->get(IFactory::class)->findLanguage();
-		$skeletonDirectory = str_replace('{lang}', $userLang, $plainSkeletonDirectory);
-
-		if (!file_exists($skeletonDirectory)) {
-			$dialectStart = strpos($userLang, '_');
-			if ($dialectStart !== false) {
-				$skeletonDirectory = str_replace('{lang}', substr($userLang, 0, $dialectStart), $plainSkeletonDirectory);
-			}
-			if ($dialectStart === false || !file_exists($skeletonDirectory)) {
-				$skeletonDirectory = str_replace('{lang}', 'default', $plainSkeletonDirectory);
-			}
-			if (!file_exists($skeletonDirectory)) {
-				$skeletonDirectory = '';
-			}
-		}
-
-		$instanceId = \OC::$server->getConfig()->getSystemValue('instanceid', '');
-
-		if ($instanceId === null) {
-			throw new \RuntimeException('no instance id!');
-		}
-		$appdata = 'appdata_' . $instanceId;
-		if ($userId === $appdata) {
-			throw new \RuntimeException('username is reserved name: ' . $appdata);
-		}
-
-		if (!empty($skeletonDirectory)) {
-			$logger->debug('copying skeleton for ' . $userId . ' from ' . $skeletonDirectory . ' to ' . $userDirectory->getFullPath('/'), ['app' => 'files_skeleton']);
-			self::copyr($skeletonDirectory, $userDirectory);
-			// update the file cache
-			$userDirectory->getStorage()->getScanner()->scan('', \OC\Files\Cache\Scanner::SCAN_RECURSIVE);
-
-			/** @var ITemplateManager $templateManager */
-			$templateManager = \OC::$server->get(ITemplateManager::class);
-			$templateManager->initializeTemplateDirectory(null, $userId);
-		}
-	}
-
-	/**
-	 * copies a directory recursively by using streams
-	 *
-	 * @param string $source
-	 * @param \OCP\Files\Folder $target
-	 * @return void
-	 */
-	public static function copyr($source, \OCP\Files\Folder $target) {
-		$logger = \OCP\Server::get(LoggerInterface::class);
-
-		// Verify if folder exists
-		$dir = opendir($source);
-		if ($dir === false) {
-			$logger->error(sprintf('Could not opendir "%s"', $source), ['app' => 'core']);
-			return;
-		}
-
-		// Copy the files
-		while (false !== ($file = readdir($dir))) {
-			if (!\OC\Files\Filesystem::isIgnoredDir($file)) {
-				if (is_dir($source . '/' . $file)) {
-					$child = $target->newFolder($file);
-					self::copyr($source . '/' . $file, $child);
-				} else {
-					$child = $target->newFile($file);
-					$sourceStream = fopen($source . '/' . $file, 'r');
-					if ($sourceStream === false) {
-						$logger->error(sprintf('Could not fopen "%s"', $source . '/' . $file), ['app' => 'core']);
-						closedir($dir);
-						return;
-					}
-					$child->putContent($sourceStream);
-				}
-			}
-		}
-		closedir($dir);
-	}
-
-	/**
-	 * @deprecated 32.0.0 Call tearDown directly on SetupManager
-	 */
-	public static function tearDownFS(): void {
-		$setupManager = \OCP\Server::get(SetupManager::class);
-		$setupManager->tearDown();
-	}
-
-	/**
-	 * generates a path for JS/CSS files. If no application is provided it will create the path for core.
-	 *
-	 * @param string $application application to get the files from
-	 * @param string $directory directory within this application (css, js, vendor, etc)
-	 * @param ?string $file the file inside of the above folder
-	 */
-	private static function generatePath($application, $directory, $file): string {
-		if (is_null($file)) {
-			$file = $application;
-			$application = '';
-		}
-		if (!empty($application)) {
-			return "$application/$directory/$file";
-		} else {
-			return "$directory/$file";
-		}
-	}
-
-	/**
-	 * add a css file
-	 *
-	 * @param string $application application id
-	 * @param string|null $file filename
-	 * @param bool $prepend prepend the Style to the beginning of the list
-	 * @deprecated 32.0.0 Use \OCP\Util::addStyle
-	 */
-	public static function addStyle($application, $file = null, $prepend = false): void {
-		$path = OC_Util::generatePath($application, 'css', $file);
-		self::addExternalResource($application, $prepend, $path, 'style');
-	}
-
-	/**
-	 * add a css file from the vendor sub folder
-	 *
-	 * @param string $application application id
-	 * @param string|null $file filename
-	 * @param bool $prepend prepend the Style to the beginning of the list
-	 * @deprecated 32.0.0
-	 */
-	public static function addVendorStyle($application, $file = null, $prepend = false): void {
-		$path = OC_Util::generatePath($application, 'vendor', $file);
-		self::addExternalResource($application, $prepend, $path, 'style');
-	}
-
-	/**
-	 * add an external resource css/js file
-	 *
-	 * @param string $application application id
-	 * @param bool $prepend prepend the file to the beginning of the list
-	 * @param string $path
-	 * @param string $type (script or style)
-	 */
-	private static function addExternalResource($application, $prepend, $path, $type = 'script'): void {
-		if ($type === 'style') {
-			if (!in_array($path, self::$styles)) {
-				if ($prepend === true) {
-					array_unshift(self::$styles, $path);
-				} else {
-					self::$styles[] = $path;
-				}
-			}
-		}
-	}
-
-	/**
-	 * Add a custom element to the header
-	 * If $text is null then the element will be written as empty element.
-	 * So use "" to get a closing tag.
-	 * @param string $tag tag name of the element
-	 * @param array $attributes array of attributes for the element
-	 * @param string $text the text content for the element
-	 * @param bool $prepend prepend the header to the beginning of the list
-	 * @deprecated 32.0.0 Use \OCP\Util::addHeader instead
-	 */
-	public static function addHeader($tag, $attributes, $text = null, $prepend = false): void {
-		$header = [
-			'tag' => $tag,
-			'attributes' => $attributes,
-			'text' => $text
-		];
-		if ($prepend === true) {
-			array_unshift(self::$headers, $header);
-		} else {
-			self::$headers[] = $header;
-		}
-	}
-
-	/**
-	 * check if the current server configuration is suitable for ownCloud
-	 *
-	 * @return array arrays with error messages and hints
-	 */
-	public static function checkServer(\OC\SystemConfig $config) {
-		$l = \OC::$server->getL10N('lib');
-		$errors = [];
-		$CONFIG_DATADIRECTORY = $config->getValue('datadirectory', OC::$SERVERROOT . '/data');
-
-		if (!self::needUpgrade($config) && $config->getValue('installed', false)) {
-			// this check needs to be done every time
-			$errors = self::checkDataDirectoryValidity($CONFIG_DATADIRECTORY);
-		}
-
-		// Assume that if checkServer() succeeded before in this session, then all is fine.
-		if (\OC::$server->getSession()->exists('checkServer_succeeded') && \OC::$server->getSession()->get('checkServer_succeeded')) {
-			return $errors;
-		}
-
-		$webServerRestart = false;
-		$setup = \OCP\Server::get(\OC\Setup::class);
-
-		$urlGenerator = \OC::$server->getURLGenerator();
-
-		$availableDatabases = $setup->getSupportedDatabases();
-		if (empty($availableDatabases)) {
-			$errors[] = [
-				'error' => $l->t('No database drivers (sqlite, mysql, or postgresql) installed.'),
-				'hint' => '' //TODO: sane hint
-			];
-			$webServerRestart = true;
-		}
-
-		// Check if config folder is writable.
-		if (!(bool)$config->getValue('config_is_read_only', false)) {
-			if (!is_writable(OC::$configDir) or !is_readable(OC::$configDir)) {
-				$errors[] = [
-					'error' => $l->t('Cannot write into "config" directory.'),
-					'hint' => $l->t('This can usually be fixed by giving the web server write access to the config directory. See %s',
-						[ $urlGenerator->linkToDocs('admin-dir_permissions') ]) . '. '
-						. $l->t('Or, if you prefer to keep config.php file read only, set the option "config_is_read_only" to true in it. See %s',
-							[ $urlGenerator->linkToDocs('admin-config') ])
-				];
-			}
-		}
-
-		// Check if there is a writable install folder.
-		if ($config->getValue('appstoreenabled', true)) {
-			if (OC_App::getInstallPath() === null
-				|| !is_writable(OC_App::getInstallPath())
-				|| !is_readable(OC_App::getInstallPath())
-			) {
-				$errors[] = [
-					'error' => $l->t('Cannot write into "apps" directory.'),
-					'hint' => $l->t('This can usually be fixed by giving the web server write access to the apps directory'
-						. ' or disabling the App Store in the config file.')
-				];
-			}
-		}
-		// Create root dir.
-		if ($config->getValue('installed', false)) {
-			if (!is_dir($CONFIG_DATADIRECTORY)) {
-				$success = @mkdir($CONFIG_DATADIRECTORY);
-				if ($success) {
-					$errors = array_merge($errors, self::checkDataDirectoryPermissions($CONFIG_DATADIRECTORY));
-				} else {
-					$errors[] = [
-						'error' => $l->t('Cannot create "data" directory.'),
-						'hint' => $l->t('This can usually be fixed by giving the web server write access to the root directory. See %s',
-							[$urlGenerator->linkToDocs('admin-dir_permissions')])
-					];
-				}
-			} elseif (!is_writable($CONFIG_DATADIRECTORY) or !is_readable($CONFIG_DATADIRECTORY)) {
-				// is_writable doesn't work for NFS mounts, so try to write a file and check if it exists.
-				$testFile = sprintf('%s/%s.tmp', $CONFIG_DATADIRECTORY, uniqid('data_dir_writability_test_'));
-				$handle = fopen($testFile, 'w');
-				if (!$handle || fwrite($handle, 'Test write operation') === false) {
-					$permissionsHint = $l->t('Permissions can usually be fixed by giving the web server write access to the root directory. See %s.',
-						[$urlGenerator->linkToDocs('admin-dir_permissions')]);
-					$errors[] = [
-						'error' => $l->t('Your data directory is not writable.'),
-						'hint' => $permissionsHint
-					];
-				} else {
-					fclose($handle);
-					unlink($testFile);
-				}
-			} else {
-				$errors = array_merge($errors, self::checkDataDirectoryPermissions($CONFIG_DATADIRECTORY));
-			}
-		}
-
-		if (!OC_Util::isSetLocaleWorking()) {
-			$errors[] = [
-				'error' => $l->t('Setting locale to %s failed.',
-					['en_US.UTF-8/fr_FR.UTF-8/es_ES.UTF-8/de_DE.UTF-8/ru_RU.UTF-8/'
-						. 'pt_BR.UTF-8/it_IT.UTF-8/ja_JP.UTF-8/zh_CN.UTF-8']),
-				'hint' => $l->t('Please install one of these locales on your system and restart your web server.')
-			];
-		}
-
-		// Contains the dependencies that should be checked against
-		// classes = class_exists
-		// functions = function_exists
-		// defined = defined
-		// ini = ini_get
-		// If the dependency is not found the missing module name is shown to the EndUser
-		// When adding new checks always verify that they pass on CI as well
-		$dependencies = [
-			'classes' => [
-				'ZipArchive' => 'zip',
-				'DOMDocument' => 'dom',
-				'XMLWriter' => 'XMLWriter',
-				'XMLReader' => 'XMLReader',
-			],
-			'functions' => [
-				'xml_parser_create' => 'libxml',
-				'mb_strcut' => 'mbstring',
-				'ctype_digit' => 'ctype',
-				'json_encode' => 'JSON',
-				'gd_info' => 'GD',
-				'gzencode' => 'zlib',
-				'simplexml_load_string' => 'SimpleXML',
-				'hash' => 'HASH Message Digest Framework',
-				'curl_init' => 'cURL',
-				'openssl_verify' => 'OpenSSL',
-			],
-			'defined' => [
-				'PDO::ATTR_DRIVER_NAME' => 'PDO'
-			],
-			'ini' => [
-				'default_charset' => 'UTF-8',
-			],
-		];
-		$missingDependencies = [];
-		$invalidIniSettings = [];
-
-		$iniWrapper = \OC::$server->get(IniGetWrapper::class);
-		foreach ($dependencies['classes'] as $class => $module) {
-			if (!class_exists($class)) {
-				$missingDependencies[] = $module;
-			}
-		}
-		foreach ($dependencies['functions'] as $function => $module) {
-			if (!function_exists($function)) {
-				$missingDependencies[] = $module;
-			}
-		}
-		foreach ($dependencies['defined'] as $defined => $module) {
-			if (!defined($defined)) {
-				$missingDependencies[] = $module;
-			}
-		}
-		foreach ($dependencies['ini'] as $setting => $expected) {
-			if (strtolower($iniWrapper->getString($setting)) !== strtolower($expected)) {
-				$invalidIniSettings[] = [$setting, $expected];
-			}
-		}
-
-		foreach ($missingDependencies as $missingDependency) {
-			$errors[] = [
-				'error' => $l->t('PHP module %s not installed.', [$missingDependency]),
-				'hint' => $l->t('Please ask your server administrator to install the module.'),
-			];
-			$webServerRestart = true;
-		}
-		foreach ($invalidIniSettings as $setting) {
-			$errors[] = [
-				'error' => $l->t('PHP setting "%s" is not set to "%s".', [$setting[0], var_export($setting[1], true)]),
-				'hint' => $l->t('Adjusting this setting in php.ini will make Nextcloud run again')
-			];
-			$webServerRestart = true;
-		}
-
-		/**
-		 * The mbstring.func_overload check can only be performed if the mbstring
-		 * module is installed as it will return null if the checking setting is
-		 * not available and thus a check on the boolean value fails.
-		 *
-		 * TODO: Should probably be implemented in the above generic dependency
-		 *       check somehow in the long-term.
-		 */
-		if ($iniWrapper->getBool('mbstring.func_overload') !== null &&
-			$iniWrapper->getBool('mbstring.func_overload') === true) {
-			$errors[] = [
-				'error' => $l->t('<code>mbstring.func_overload</code> is set to <code>%s</code> instead of the expected value <code>0</code>.', [$iniWrapper->getString('mbstring.func_overload')]),
-				'hint' => $l->t('To fix this issue set <code>mbstring.func_overload</code> to <code>0</code> in your php.ini.')
-			];
-		}
-
-		if (!self::isAnnotationsWorking()) {
-			$errors[] = [
-				'error' => $l->t('PHP is apparently set up to strip inline doc blocks. This will make several core apps inaccessible.'),
-				'hint' => $l->t('This is probably caused by a cache/accelerator such as Zend OPcache or eAccelerator.')
-			];
-		}
-
-		if (!\OC::$CLI && $webServerRestart) {
-			$errors[] = [
-				'error' => $l->t('PHP modules have been installed, but they are still listed as missing?'),
-				'hint' => $l->t('Please ask your server administrator to restart the web server.')
-			];
-		}
-
-		foreach (['secret', 'instanceid', 'passwordsalt'] as $requiredConfig) {
-			if ($config->getValue($requiredConfig, '') === '' && !\OC::$CLI && $config->getValue('installed', false)) {
-				$errors[] = [
-					'error' => $l->t('The required %s config variable is not configured in the config.php file.', [$requiredConfig]),
-					'hint' => $l->t('Please ask your server administrator to check the Nextcloud configuration.')
-				];
-			}
-		}
-
-		// Cache the result of this function
-		\OC::$server->getSession()->set('checkServer_succeeded', count($errors) == 0);
-
-		return $errors;
-	}
-
-	/**
-	 * Check for correct file permissions of data directory
-	 *
-	 * @param string $dataDirectory
-	 * @return array arrays with error messages and hints
-	 * @internal
-	 */
-	public static function checkDataDirectoryPermissions($dataDirectory) {
-		if (!\OC::$server->getConfig()->getSystemValueBool('check_data_directory_permissions', true)) {
-			return  [];
-		}
-
-		$perms = substr(decoct(@fileperms($dataDirectory)), -3);
-		if (substr($perms, -1) !== '0') {
-			chmod($dataDirectory, 0770);
-			clearstatcache();
-			$perms = substr(decoct(@fileperms($dataDirectory)), -3);
-			if ($perms[2] !== '0') {
-				$l = \OC::$server->getL10N('lib');
-				return [[
-					'error' => $l->t('Your data directory is readable by other people.'),
-					'hint' => $l->t('Please change the permissions to 0770 so that the directory cannot be listed by other people.'),
-				]];
-			}
-		}
-		return [];
-	}
-
-	/**
-	 * Check that the data directory exists and is valid by
-	 * checking the existence of the ".ncdata" file.
-	 *
-	 * @param string $dataDirectory data directory path
-	 * @return array errors found
-	 * @internal
-	 */
-	public static function checkDataDirectoryValidity($dataDirectory) {
-		$l = \OC::$server->getL10N('lib');
-		$errors = [];
-		if ($dataDirectory[0] !== '/') {
-			$errors[] = [
-				'error' => $l->t('Your data directory must be an absolute path.'),
-				'hint' => $l->t('Check the value of "datadirectory" in your configuration.')
-			];
-		}
-
-		if (!file_exists($dataDirectory . '/.ncdata')) {
-			$errors[] = [
-				'error' => $l->t('Your data directory is invalid.'),
-				'hint' => $l->t('Ensure there is a file called "%1$s" in the root of the data directory. It should have the content: "%2$s"', ['.ncdata', '# Nextcloud data directory']),
-			];
-		}
-		return $errors;
-	}
-
-	/**
-	 * Check if the user is logged in, redirects to home if not. With
-	 * redirect URL parameter to the request URI.
-	 *
-	 * @deprecated 32.0.0
-	 */
-	public static function checkLoggedIn(): void {
-		// Check if we are a user
-		if (!\OC::$server->getUserSession()->isLoggedIn()) {
-			header('Location: ' . \OC::$server->getURLGenerator()->linkToRoute(
-				'core.login.showLoginForm',
-				[
-					'redirect_url' => \OC::$server->getRequest()->getRequestUri(),
-				]
-			)
-			);
-			exit();
-		}
-		// Redirect to 2FA challenge selection if 2FA challenge was not solved yet
-		if (\OC::$server->get(TwoFactorAuthManager::class)->needsSecondFactor(\OC::$server->getUserSession()->getUser())) {
-			header('Location: ' . \OC::$server->getURLGenerator()->linkToRoute('core.TwoFactorChallenge.selectChallenge'));
-			exit();
-		}
-	}
-
-	/**
-	 * Check if the user is a admin, redirects to home if not
-	 *
-	 * @deprecated 32.0.0
-	 */
-	public static function checkAdminUser(): void {
-		self::checkLoggedIn();
-		if (!OC_User::isAdminUser(OC_User::getUser())) {
-			header('Location: ' . \OCP\Util::linkToAbsolute('', 'index.php'));
-			exit();
-		}
-	}
-
-	/**
-	 * Returns the URL of the default page
-	 * based on the system configuration and
-	 * the apps visible for the current user
-	 *
-	 * @return string URL
-	 * @deprecated 32.0.0 use IURLGenerator's linkToDefaultPageUrl directly
-	 */
-	public static function getDefaultPageUrl() {
-		/** @var IURLGenerator $urlGenerator */
-		$urlGenerator = \OC::$server->get(IURLGenerator::class);
-		return $urlGenerator->linkToDefaultPageUrl();
-	}
-
-	/**
-	 * Redirect to the user default page
-	 *
-	 * @deprecated 32.0.0
-	 */
-	public static function redirectToDefaultPage(): void {
-		$location = self::getDefaultPageUrl();
-		header('Location: ' . $location);
-		exit();
-	}
-
-	/**
-	 * get an id unique for this instance
-	 *
-	 * @return string
-	 */
-	public static function getInstanceId(): string {
-		$id = \OC::$server->getSystemConfig()->getValue('instanceid', null);
-		if (is_null($id)) {
-			// We need to guarantee at least one letter in instanceid so it can be used as the session_name
-			$id = 'oc' . \OC::$server->get(ISecureRandom::class)->generate(10, \OCP\Security\ISecureRandom::CHAR_LOWER . \OCP\Security\ISecureRandom::CHAR_DIGITS);
-			\OC::$server->getSystemConfig()->setValue('instanceid', $id);
-		}
-		return $id;
-	}
-
-	/**
-	 * Public function to sanitize HTML
-	 *
-	 * This function is used to sanitize HTML and should be applied on any
-	 * string or array of strings before displaying it on a web page.
-	 *
-	 * @param string|string[] $value
-	 * @return ($value is array ? string[] : string)
-	 * @deprecated 32.0.0 use \OCP\Util::sanitizeHTML instead
-	 */
-	public static function sanitizeHTML($value) {
-		if (is_array($value)) {
-			$value = array_map(function ($value) {
-				return self::sanitizeHTML($value);
-			}, $value);
-		} else {
-			// Specify encoding for PHP<5.4
-			$value = htmlspecialchars((string)$value, ENT_QUOTES, 'UTF-8');
-		}
-		return $value;
-	}
-
-	/**
-	 * Public function to encode url parameters
-	 *
-	 * This function is used to encode path to file before output.
-	 * Encoding is done according to RFC 3986 with one exception:
-	 * Character '/' is preserved as is.
-	 *
-	 * @param string $component part of URI to encode
-	 * @return string
-	 * @deprecated 32.0.0 use \OCP\Util::encodePath instead
-	 */
-	public static function encodePath($component) {
-		$encoded = rawurlencode($component);
-		$encoded = str_replace('%2F', '/', $encoded);
-		return $encoded;
-	}
-
-	/**
-	 * Check if current locale is non-UTF8
-	 *
-	 * @return bool
-	 */
-	private static function isNonUTF8Locale() {
-		if (function_exists('escapeshellcmd')) {
-			return escapeshellcmd('§') === '';
-		} elseif (function_exists('escapeshellarg')) {
-			return escapeshellarg('§') === '\'\'';
-		} else {
-			return preg_match('/utf-?8/i', setlocale(LC_CTYPE, 0)) === 0;
-		}
-	}
-
-	/**
-	 * Check if the setlocale call does not work. This can happen if the right
-	 * local packages are not available on the server.
-	 *
-	 * @internal
-	 */
-	public static function isSetLocaleWorking(): bool {
-		if (self::isNonUTF8Locale()) {
-			// Borrowed from \Patchwork\Utf8\Bootup::initLocale
-			setlocale(LC_ALL, 'C.UTF-8', 'C');
-			setlocale(LC_CTYPE, 'en_US.UTF-8', 'fr_FR.UTF-8', 'es_ES.UTF-8', 'de_DE.UTF-8', 'ru_RU.UTF-8', 'pt_BR.UTF-8', 'it_IT.UTF-8', 'ja_JP.UTF-8', 'zh_CN.UTF-8', '0');
-
-			// Check again
-			if (self::isNonUTF8Locale()) {
-				return false;
-			}
-		}
-
-		return true;
-	}
-
-	/**
-	 * Check if it's possible to get the inline annotations
-	 *
-	 * @internal
-	 */
-	public static function isAnnotationsWorking(): bool {
-		if (PHP_VERSION_ID >= 80300) {
-			/** @psalm-suppress UndefinedMethod */
-			$reflection = \ReflectionMethod::createFromMethodName(__METHOD__);
-		} else {
-			$reflection = new \ReflectionMethod(__METHOD__);
-		}
-		$docs = $reflection->getDocComment();
-
-		return (is_string($docs) && strlen($docs) > 50);
-	}
-
-	/**
-	 * Check if the PHP module fileinfo is loaded.
-	 *
-	 * @internal
-	 */
-	public static function fileInfoLoaded(): bool {
-		return function_exists('finfo_open');
-	}
-
-	/**
-	 * clear all levels of output buffering
-	 *
-	 * @return void
-	 */
-	public static function obEnd() {
-		while (ob_get_level()) {
-			ob_end_clean();
-		}
-	}
-
-	/**
-	 * Checks whether the server is running on Mac OS X
-	 *
-	 * @return bool true if running on Mac OS X, false otherwise
-	 */
-	public static function runningOnMac() {
-		return (strtoupper(substr(PHP_OS, 0, 6)) === 'DARWIN');
-	}
-
-	/**
-	 * Handles the case that there may not be a theme, then check if a "default"
-	 * theme exists and take that one
-	 *
-	 * @return string the theme
-	 */
-	public static function getTheme() {
-		$theme = \OC::$server->getSystemConfig()->getValue('theme', '');
-
-		if ($theme === '') {
-			if (is_dir(OC::$SERVERROOT . '/themes/default')) {
-				$theme = 'default';
-			}
-		}
-
-		return $theme;
-	}
-
-	/**
-	 * Normalize a unicode string
-	 *
-	 * @param string $value a not normalized string
-	 * @return string The normalized string or the input if the normalization failed
-	 */
-	public static function normalizeUnicode(string $value): string {
-		if (Normalizer::isNormalized($value)) {
-			return $value;
-		}
-
-		$normalizedValue = Normalizer::normalize($value);
-		if ($normalizedValue === false) {
-			\OCP\Server::get(LoggerInterface::class)->warning('normalizing failed for "' . $value . '"', ['app' => 'core']);
-			return $value;
-		}
-
-		return $normalizedValue;
-	}
-
-	/**
-	 * Check whether the instance needs to perform an upgrade,
-	 * either when the core version is higher or any app requires
-	 * an upgrade.
-	 *
-	 * @param \OC\SystemConfig $config
-	 * @return bool whether the core or any app needs an upgrade
-	 * @throws \OCP\HintException When the upgrade from the given version is not allowed
-	 * @deprecated 32.0.0 Use \OCP\Util::needUpgrade instead
-	 */
-	public static function needUpgrade(\OC\SystemConfig $config) {
-		if ($config->getValue('installed', false)) {
-			$installedVersion = $config->getValue('version', '0.0.0');
-			$currentVersion = implode('.', \OCP\Util::getVersion());
-			$versionDiff = version_compare($currentVersion, $installedVersion);
-			if ($versionDiff > 0) {
-				return true;
-			} elseif ($config->getValue('debug', false) && $versionDiff < 0) {
-				// downgrade with debug
-				$installedMajor = explode('.', $installedVersion);
-				$installedMajor = $installedMajor[0] . '.' . $installedMajor[1];
-				$currentMajor = explode('.', $currentVersion);
-				$currentMajor = $currentMajor[0] . '.' . $currentMajor[1];
-				if ($installedMajor === $currentMajor) {
-					// Same major, allow downgrade for developers
-					return true;
-				} else {
-					// downgrade attempt, throw exception
-					throw new \OCP\HintException('Downgrading is not supported and is likely to cause unpredictable issues (from ' . $installedVersion . ' to ' . $currentVersion . ')');
-				}
-			} elseif ($versionDiff < 0) {
-				// downgrade attempt, throw exception
-				throw new \OCP\HintException('Downgrading is not supported and is likely to cause unpredictable issues (from ' . $installedVersion . ' to ' . $currentVersion . ')');
-			}
-
-			// also check for upgrades for apps (independently from the user)
-			$apps = \OC_App::getEnabledApps(false, true);
-			$shouldUpgrade = false;
-			foreach ($apps as $app) {
-				if (\OC_App::shouldUpgrade($app)) {
-					$shouldUpgrade = true;
-					break;
-				}
-			}
-			return $shouldUpgrade;
-		} else {
-			return false;
-		}
-	}
+    public static $styles = [];
+    public static $headers = [];
+
+    /**
+     * Setup the file system
+     *
+     * @param string|null $user
+     * @return boolean
+     * @description configure the initial filesystem based on the configuration
+     * @suppress PhanDeprecatedFunction
+     * @suppress PhanAccessMethodInternal
+     */
+    public static function setupFS(?string $user = '') {
+        // If we are not forced to load a specific user we load the one that is logged in
+        if ($user === '') {
+            $userObject = \OC::$server->get(\OCP\IUserSession::class)->getUser();
+        } else {
+            $userObject = \OC::$server->get(\OCP\IUserManager::class)->get($user);
+        }
+
+        /** @var SetupManager $setupManager */
+        $setupManager = \OC::$server->get(SetupManager::class);
+
+        if ($userObject) {
+            $setupManager->setupForUser($userObject);
+        } else {
+            $setupManager->setupRoot();
+        }
+        return true;
+    }
+
+    /**
+     * Check if a password is required for each public link
+     *
+     * @param bool $checkGroupMembership Check group membership exclusion
+     * @return bool
+     * @deprecated 32.0.0 use OCP\Share\IManager's shareApiLinkEnforcePassword directly
+     */
+    public static function isPublicLinkPasswordRequired(bool $checkGroupMembership = true) {
+        /** @var IManager $shareManager */
+        $shareManager = \OC::$server->get(IManager::class);
+        return $shareManager->shareApiLinkEnforcePassword($checkGroupMembership);
+    }
+
+    /**
+     * check if sharing is disabled for the current user
+     * @param IConfig $config
+     * @param IGroupManager $groupManager
+     * @param IUser|null $user
+     * @return bool
+     * @deprecated 32.0.0 use OCP\Share\IManager's sharingDisabledForUser directly
+     */
+    public static function isSharingDisabledForUser(IConfig $config, IGroupManager $groupManager, $user) {
+        /** @var IManager $shareManager */
+        $shareManager = \OC::$server->get(IManager::class);
+        $userId = $user ? $user->getUID() : null;
+        return $shareManager->sharingDisabledForUser($userId);
+    }
+
+    /**
+     * check if share API enforces a default expire date
+     *
+     * @return bool
+     * @deprecated 32.0.0 use OCP\Share\IManager's shareApiLinkDefaultExpireDateEnforced directly
+     */
+    public static function isDefaultExpireDateEnforced() {
+        /** @var IManager $shareManager */
+        $shareManager = \OC::$server->get(IManager::class);
+        return $shareManager->shareApiLinkDefaultExpireDateEnforced();
+    }
+
+    /**
+     * Get the quota of a user
+     *
+     * @param IUser|null $user
+     * @return int|\OCP\Files\FileInfo::SPACE_UNLIMITED|false|float Quota bytes
+     * @deprecated 9.0.0 - Use \OCP\IUser::getQuota or \OCP\IUser::getQuotaBytes
+     */
+    public static function getUserQuota(?IUser $user) {
+        if (is_null($user)) {
+            return \OCP\Files\FileInfo::SPACE_UNLIMITED;
+        }
+        $userQuota = $user->getQuota();
+        if ($userQuota === 'none') {
+            return \OCP\Files\FileInfo::SPACE_UNLIMITED;
+        }
+        return \OCP\Util::computerFileSize($userQuota);
+    }
+
+    /**
+     * copies the skeleton to the users /files
+     *
+     * @param string $userId
+     * @param \OCP\Files\Folder $userDirectory
+     * @throws \OCP\Files\NotFoundException
+     * @throws \OCP\Files\NotPermittedException
+     * @suppress PhanDeprecatedFunction
+     */
+    public static function copySkeleton($userId, \OCP\Files\Folder $userDirectory) {
+        /** @var LoggerInterface $logger */
+        $logger = \OC::$server->get(LoggerInterface::class);
+
+        $plainSkeletonDirectory = \OC::$server->getConfig()->getSystemValueString('skeletondirectory', \OC::$SERVERROOT . '/core/skeleton');
+        $userLang = \OC::$server->get(IFactory::class)->findLanguage();
+        $skeletonDirectory = str_replace('{lang}', $userLang, $plainSkeletonDirectory);
+
+        if (!file_exists($skeletonDirectory)) {
+            $dialectStart = strpos($userLang, '_');
+            if ($dialectStart !== false) {
+                $skeletonDirectory = str_replace('{lang}', substr($userLang, 0, $dialectStart), $plainSkeletonDirectory);
+            }
+            if ($dialectStart === false || !file_exists($skeletonDirectory)) {
+                $skeletonDirectory = str_replace('{lang}', 'default', $plainSkeletonDirectory);
+            }
+            if (!file_exists($skeletonDirectory)) {
+                $skeletonDirectory = '';
+            }
+        }
+
+        $instanceId = \OC::$server->getConfig()->getSystemValue('instanceid', '');
+
+        if ($instanceId === null) {
+            throw new \RuntimeException('no instance id!');
+        }
+        $appdata = 'appdata_' . $instanceId;
+        if ($userId === $appdata) {
+            throw new \RuntimeException('username is reserved name: ' . $appdata);
+        }
+
+        if (!empty($skeletonDirectory)) {
+            $logger->debug('copying skeleton for ' . $userId . ' from ' . $skeletonDirectory . ' to ' . $userDirectory->getFullPath('/'), ['app' => 'files_skeleton']);
+            self::copyr($skeletonDirectory, $userDirectory);
+            // update the file cache
+            $userDirectory->getStorage()->getScanner()->scan('', \OC\Files\Cache\Scanner::SCAN_RECURSIVE);
+
+            /** @var ITemplateManager $templateManager */
+            $templateManager = \OC::$server->get(ITemplateManager::class);
+            $templateManager->initializeTemplateDirectory(null, $userId);
+        }
+    }
+
+    /**
+     * copies a directory recursively by using streams
+     *
+     * @param string $source
+     * @param \OCP\Files\Folder $target
+     * @return void
+     */
+    public static function copyr($source, \OCP\Files\Folder $target) {
+        $logger = \OCP\Server::get(LoggerInterface::class);
+
+        // Verify if folder exists
+        $dir = opendir($source);
+        if ($dir === false) {
+            $logger->error(sprintf('Could not opendir "%s"', $source), ['app' => 'core']);
+            return;
+        }
+
+        // Copy the files
+        while (false !== ($file = readdir($dir))) {
+            if (!\OC\Files\Filesystem::isIgnoredDir($file)) {
+                if (is_dir($source . '/' . $file)) {
+                    $child = $target->newFolder($file);
+                    self::copyr($source . '/' . $file, $child);
+                } else {
+                    $child = $target->newFile($file);
+                    $sourceStream = fopen($source . '/' . $file, 'r');
+                    if ($sourceStream === false) {
+                        $logger->error(sprintf('Could not fopen "%s"', $source . '/' . $file), ['app' => 'core']);
+                        closedir($dir);
+                        return;
+                    }
+                    $child->putContent($sourceStream);
+                }
+            }
+        }
+        closedir($dir);
+    }
+
+    /**
+     * @deprecated 32.0.0 Call tearDown directly on SetupManager
+     */
+    public static function tearDownFS(): void {
+        $setupManager = \OCP\Server::get(SetupManager::class);
+        $setupManager->tearDown();
+    }
+
+    /**
+     * generates a path for JS/CSS files. If no application is provided it will create the path for core.
+     *
+     * @param string $application application to get the files from
+     * @param string $directory directory within this application (css, js, vendor, etc)
+     * @param ?string $file the file inside of the above folder
+     */
+    private static function generatePath($application, $directory, $file): string {
+        if (is_null($file)) {
+            $file = $application;
+            $application = '';
+        }
+        if (!empty($application)) {
+            return "$application/$directory/$file";
+        } else {
+            return "$directory/$file";
+        }
+    }
+
+    /**
+     * add a css file
+     *
+     * @param string $application application id
+     * @param string|null $file filename
+     * @param bool $prepend prepend the Style to the beginning of the list
+     * @deprecated 32.0.0 Use \OCP\Util::addStyle
+     */
+    public static function addStyle($application, $file = null, $prepend = false): void {
+        $path = OC_Util::generatePath($application, 'css', $file);
+        self::addExternalResource($application, $prepend, $path, 'style');
+    }
+
+    /**
+     * add a css file from the vendor sub folder
+     *
+     * @param string $application application id
+     * @param string|null $file filename
+     * @param bool $prepend prepend the Style to the beginning of the list
+     * @deprecated 32.0.0
+     */
+    public static function addVendorStyle($application, $file = null, $prepend = false): void {
+        $path = OC_Util::generatePath($application, 'vendor', $file);
+        self::addExternalResource($application, $prepend, $path, 'style');
+    }
+
+    /**
+     * add an external resource css/js file
+     *
+     * @param string $application application id
+     * @param bool $prepend prepend the file to the beginning of the list
+     * @param string $path
+     * @param string $type (script or style)
+     */
+    private static function addExternalResource($application, $prepend, $path, $type = 'script'): void {
+        if ($type === 'style') {
+            if (!in_array($path, self::$styles)) {
+                if ($prepend === true) {
+                    array_unshift(self::$styles, $path);
+                } else {
+                    self::$styles[] = $path;
+                }
+            }
+        }
+    }
+
+    /**
+     * Add a custom element to the header
+     * If $text is null then the element will be written as empty element.
+     * So use "" to get a closing tag.
+     * @param string $tag tag name of the element
+     * @param array $attributes array of attributes for the element
+     * @param string $text the text content for the element
+     * @param bool $prepend prepend the header to the beginning of the list
+     * @deprecated 32.0.0 Use \OCP\Util::addHeader instead
+     */
+    public static function addHeader($tag, $attributes, $text = null, $prepend = false): void {
+        $header = [
+            'tag' => $tag,
+            'attributes' => $attributes,
+            'text' => $text
+        ];
+        if ($prepend === true) {
+            array_unshift(self::$headers, $header);
+        } else {
+            self::$headers[] = $header;
+        }
+    }
+
+    /**
+     * check if the current server configuration is suitable for ownCloud
+     *
+     * @return array arrays with error messages and hints
+     */
+    public static function checkServer(\OC\SystemConfig $config) {
+        $l = \OC::$server->getL10N('lib');
+        $errors = [];
+        $CONFIG_DATADIRECTORY = $config->getValue('datadirectory', OC::$SERVERROOT . '/data');
+
+        if (!self::needUpgrade($config) && $config->getValue('installed', false)) {
+            // this check needs to be done every time
+            $errors = self::checkDataDirectoryValidity($CONFIG_DATADIRECTORY);
+        }
+
+        // Assume that if checkServer() succeeded before in this session, then all is fine.
+        if (\OC::$server->getSession()->exists('checkServer_succeeded') && \OC::$server->getSession()->get('checkServer_succeeded')) {
+            return $errors;
+        }
+
+        $webServerRestart = false;
+        $setup = \OCP\Server::get(\OC\Setup::class);
+
+        $urlGenerator = \OC::$server->getURLGenerator();
+
+        $availableDatabases = $setup->getSupportedDatabases();
+        if (empty($availableDatabases)) {
+            $errors[] = [
+                'error' => $l->t('No database drivers (sqlite, mysql, or postgresql) installed.'),
+                'hint' => '' //TODO: sane hint
+            ];
+            $webServerRestart = true;
+        }
+
+        // Check if config folder is writable.
+        if (!(bool)$config->getValue('config_is_read_only', false)) {
+            if (!is_writable(OC::$configDir) or !is_readable(OC::$configDir)) {
+                $errors[] = [
+                    'error' => $l->t('Cannot write into "config" directory.'),
+                    'hint' => $l->t('This can usually be fixed by giving the web server write access to the config directory. See %s',
+                        [ $urlGenerator->linkToDocs('admin-dir_permissions') ]) . '. '
+                        . $l->t('Or, if you prefer to keep config.php file read only, set the option "config_is_read_only" to true in it. See %s',
+                            [ $urlGenerator->linkToDocs('admin-config') ])
+                ];
+            }
+        }
+
+        // Check if there is a writable install folder.
+        if ($config->getValue('appstoreenabled', true)) {
+            if (OC_App::getInstallPath() === null
+                || !is_writable(OC_App::getInstallPath())
+                || !is_readable(OC_App::getInstallPath())
+            ) {
+                $errors[] = [
+                    'error' => $l->t('Cannot write into "apps" directory.'),
+                    'hint' => $l->t('This can usually be fixed by giving the web server write access to the apps directory'
+                        . ' or disabling the App Store in the config file.')
+                ];
+            }
+        }
+        // Create root dir.
+        if ($config->getValue('installed', false)) {
+            if (!is_dir($CONFIG_DATADIRECTORY)) {
+                $success = @mkdir($CONFIG_DATADIRECTORY);
+                if ($success) {
+                    $errors = array_merge($errors, self::checkDataDirectoryPermissions($CONFIG_DATADIRECTORY));
+                } else {
+                    $errors[] = [
+                        'error' => $l->t('Cannot create "data" directory.'),
+                        'hint' => $l->t('This can usually be fixed by giving the web server write access to the root directory. See %s',
+                            [$urlGenerator->linkToDocs('admin-dir_permissions')])
+                    ];
+                }
+            } elseif (!is_writable($CONFIG_DATADIRECTORY) or !is_readable($CONFIG_DATADIRECTORY)) {
+                // is_writable doesn't work for NFS mounts, so try to write a file and check if it exists.
+                $testFile = sprintf('%s/%s.tmp', $CONFIG_DATADIRECTORY, uniqid('data_dir_writability_test_'));
+                $handle = fopen($testFile, 'w');
+                if (!$handle || fwrite($handle, 'Test write operation') === false) {
+                    $permissionsHint = $l->t('Permissions can usually be fixed by giving the web server write access to the root directory. See %s.',
+                        [$urlGenerator->linkToDocs('admin-dir_permissions')]);
+                    $errors[] = [
+                        'error' => $l->t('Your data directory is not writable.'),
+                        'hint' => $permissionsHint
+                    ];
+                } else {
+                    fclose($handle);
+                    unlink($testFile);
+                }
+            } else {
+                $errors = array_merge($errors, self::checkDataDirectoryPermissions($CONFIG_DATADIRECTORY));
+            }
+        }
+
+        if (!OC_Util::isSetLocaleWorking()) {
+            $errors[] = [
+                'error' => $l->t('Setting locale to %s failed.',
+                    ['en_US.UTF-8/fr_FR.UTF-8/es_ES.UTF-8/de_DE.UTF-8/ru_RU.UTF-8/'
+                        . 'pt_BR.UTF-8/it_IT.UTF-8/ja_JP.UTF-8/zh_CN.UTF-8']),
+                'hint' => $l->t('Please install one of these locales on your system and restart your web server.')
+            ];
+        }
+
+        // Contains the dependencies that should be checked against
+        // classes = class_exists
+        // functions = function_exists
+        // defined = defined
+        // ini = ini_get
+        // If the dependency is not found the missing module name is shown to the EndUser
+        // When adding new checks always verify that they pass on CI as well
+        $dependencies = [
+            'classes' => [
+                'ZipArchive' => 'zip',
+                'DOMDocument' => 'dom',
+                'XMLWriter' => 'XMLWriter',
+                'XMLReader' => 'XMLReader',
+            ],
+            'functions' => [
+                'xml_parser_create' => 'libxml',
+                'mb_strcut' => 'mbstring',
+                'ctype_digit' => 'ctype',
+                'json_encode' => 'JSON',
+                'gd_info' => 'GD',
+                'gzencode' => 'zlib',
+                'simplexml_load_string' => 'SimpleXML',
+                'hash' => 'HASH Message Digest Framework',
+                'curl_init' => 'cURL',
+                'openssl_verify' => 'OpenSSL',
+            ],
+            'defined' => [
+                'PDO::ATTR_DRIVER_NAME' => 'PDO'
+            ],
+            'ini' => [
+                'default_charset' => 'UTF-8',
+            ],
+        ];
+        $missingDependencies = [];
+        $invalidIniSettings = [];
+
+        $iniWrapper = \OC::$server->get(IniGetWrapper::class);
+        foreach ($dependencies['classes'] as $class => $module) {
+            if (!class_exists($class)) {
+                $missingDependencies[] = $module;
+            }
+        }
+        foreach ($dependencies['functions'] as $function => $module) {
+            if (!function_exists($function)) {
+                $missingDependencies[] = $module;
+            }
+        }
+        foreach ($dependencies['defined'] as $defined => $module) {
+            if (!defined($defined)) {
+                $missingDependencies[] = $module;
+            }
+        }
+        foreach ($dependencies['ini'] as $setting => $expected) {
+            if (strtolower($iniWrapper->getString($setting)) !== strtolower($expected)) {
+                $invalidIniSettings[] = [$setting, $expected];
+            }
+        }
+
+        foreach ($missingDependencies as $missingDependency) {
+            $errors[] = [
+                'error' => $l->t('PHP module %s not installed.', [$missingDependency]),
+                'hint' => $l->t('Please ask your server administrator to install the module.'),
+            ];
+            $webServerRestart = true;
+        }
+        foreach ($invalidIniSettings as $setting) {
+            $errors[] = [
+                'error' => $l->t('PHP setting "%s" is not set to "%s".', [$setting[0], var_export($setting[1], true)]),
+                'hint' => $l->t('Adjusting this setting in php.ini will make Nextcloud run again')
+            ];
+            $webServerRestart = true;
+        }
+
+        /**
+         * The mbstring.func_overload check can only be performed if the mbstring
+         * module is installed as it will return null if the checking setting is
+         * not available and thus a check on the boolean value fails.
+         *
+         * TODO: Should probably be implemented in the above generic dependency
+         *       check somehow in the long-term.
+         */
+        if ($iniWrapper->getBool('mbstring.func_overload') !== null &&
+            $iniWrapper->getBool('mbstring.func_overload') === true) {
+            $errors[] = [
+                'error' => $l->t('<code>mbstring.func_overload</code> is set to <code>%s</code> instead of the expected value <code>0</code>.', [$iniWrapper->getString('mbstring.func_overload')]),
+                'hint' => $l->t('To fix this issue set <code>mbstring.func_overload</code> to <code>0</code> in your php.ini.')
+            ];
+        }
+
+        if (!self::isAnnotationsWorking()) {
+            $errors[] = [
+                'error' => $l->t('PHP is apparently set up to strip inline doc blocks. This will make several core apps inaccessible.'),
+                'hint' => $l->t('This is probably caused by a cache/accelerator such as Zend OPcache or eAccelerator.')
+            ];
+        }
+
+        if (!\OC::$CLI && $webServerRestart) {
+            $errors[] = [
+                'error' => $l->t('PHP modules have been installed, but they are still listed as missing?'),
+                'hint' => $l->t('Please ask your server administrator to restart the web server.')
+            ];
+        }
+
+        foreach (['secret', 'instanceid', 'passwordsalt'] as $requiredConfig) {
+            if ($config->getValue($requiredConfig, '') === '' && !\OC::$CLI && $config->getValue('installed', false)) {
+                $errors[] = [
+                    'error' => $l->t('The required %s config variable is not configured in the config.php file.', [$requiredConfig]),
+                    'hint' => $l->t('Please ask your server administrator to check the Nextcloud configuration.')
+                ];
+            }
+        }
+
+        // Cache the result of this function
+        \OC::$server->getSession()->set('checkServer_succeeded', count($errors) == 0);
+
+        return $errors;
+    }
+
+    /**
+     * Check for correct file permissions of data directory
+     *
+     * @param string $dataDirectory
+     * @return array arrays with error messages and hints
+     * @internal
+     */
+    public static function checkDataDirectoryPermissions($dataDirectory) {
+        if (!\OC::$server->getConfig()->getSystemValueBool('check_data_directory_permissions', true)) {
+            return  [];
+        }
+
+        $perms = substr(decoct(@fileperms($dataDirectory)), -3);
+        if (substr($perms, -1) !== '0') {
+            chmod($dataDirectory, 0770);
+            clearstatcache();
+            $perms = substr(decoct(@fileperms($dataDirectory)), -3);
+            if ($perms[2] !== '0') {
+                $l = \OC::$server->getL10N('lib');
+                return [[
+                    'error' => $l->t('Your data directory is readable by other people.'),
+                    'hint' => $l->t('Please change the permissions to 0770 so that the directory cannot be listed by other people.'),
+                ]];
+            }
+        }
+        return [];
+    }
+
+    /**
+     * Check that the data directory exists and is valid by
+     * checking the existence of the ".ncdata" file.
+     *
+     * @param string $dataDirectory data directory path
+     * @return array errors found
+     * @internal
+     */
+    public static function checkDataDirectoryValidity($dataDirectory) {
+        $l = \OC::$server->getL10N('lib');
+        $errors = [];
+        if ($dataDirectory[0] !== '/') {
+            $errors[] = [
+                'error' => $l->t('Your data directory must be an absolute path.'),
+                'hint' => $l->t('Check the value of "datadirectory" in your configuration.')
+            ];
+        }
+
+        if (!file_exists($dataDirectory . '/.ncdata')) {
+            $errors[] = [
+                'error' => $l->t('Your data directory is invalid.'),
+                'hint' => $l->t('Ensure there is a file called "%1$s" in the root of the data directory. It should have the content: "%2$s"', ['.ncdata', '# Nextcloud data directory']),
+            ];
+        }
+        return $errors;
+    }
+
+    /**
+     * Check if the user is logged in, redirects to home if not. With
+     * redirect URL parameter to the request URI.
+     *
+     * @deprecated 32.0.0
+     */
+    public static function checkLoggedIn(): void {
+        // Check if we are a user
+        if (!\OC::$server->getUserSession()->isLoggedIn()) {
+            header('Location: ' . \OC::$server->getURLGenerator()->linkToRoute(
+                'core.login.showLoginForm',
+                [
+                    'redirect_url' => \OC::$server->getRequest()->getRequestUri(),
+                ]
+            )
+            );
+            exit();
+        }
+        // Redirect to 2FA challenge selection if 2FA challenge was not solved yet
+        if (\OC::$server->get(TwoFactorAuthManager::class)->needsSecondFactor(\OC::$server->getUserSession()->getUser())) {
+            header('Location: ' . \OC::$server->getURLGenerator()->linkToRoute('core.TwoFactorChallenge.selectChallenge'));
+            exit();
+        }
+    }
+
+    /**
+     * Check if the user is a admin, redirects to home if not
+     *
+     * @deprecated 32.0.0
+     */
+    public static function checkAdminUser(): void {
+        self::checkLoggedIn();
+        if (!OC_User::isAdminUser(OC_User::getUser())) {
+            header('Location: ' . \OCP\Util::linkToAbsolute('', 'index.php'));
+            exit();
+        }
+    }
+
+    /**
+     * Returns the URL of the default page
+     * based on the system configuration and
+     * the apps visible for the current user
+     *
+     * @return string URL
+     * @deprecated 32.0.0 use IURLGenerator's linkToDefaultPageUrl directly
+     */
+    public static function getDefaultPageUrl() {
+        /** @var IURLGenerator $urlGenerator */
+        $urlGenerator = \OC::$server->get(IURLGenerator::class);
+        return $urlGenerator->linkToDefaultPageUrl();
+    }
+
+    /**
+     * Redirect to the user default page
+     *
+     * @deprecated 32.0.0
+     */
+    public static function redirectToDefaultPage(): void {
+        $location = self::getDefaultPageUrl();
+        header('Location: ' . $location);
+        exit();
+    }
+
+    /**
+     * get an id unique for this instance
+     *
+     * @return string
+     */
+    public static function getInstanceId(): string {
+        $id = \OC::$server->getSystemConfig()->getValue('instanceid', null);
+        if (is_null($id)) {
+            // We need to guarantee at least one letter in instanceid so it can be used as the session_name
+            $id = 'oc' . \OC::$server->get(ISecureRandom::class)->generate(10, \OCP\Security\ISecureRandom::CHAR_LOWER . \OCP\Security\ISecureRandom::CHAR_DIGITS);
+            \OC::$server->getSystemConfig()->setValue('instanceid', $id);
+        }
+        return $id;
+    }
+
+    /**
+     * Public function to sanitize HTML
+     *
+     * This function is used to sanitize HTML and should be applied on any
+     * string or array of strings before displaying it on a web page.
+     *
+     * @param string|string[] $value
+     * @return ($value is array ? string[] : string)
+     * @deprecated 32.0.0 use \OCP\Util::sanitizeHTML instead
+     */
+    public static function sanitizeHTML($value) {
+        if (is_array($value)) {
+            $value = array_map(function ($value) {
+                return self::sanitizeHTML($value);
+            }, $value);
+        } else {
+            // Specify encoding for PHP<5.4
+            $value = htmlspecialchars((string)$value, ENT_QUOTES, 'UTF-8');
+        }
+        return $value;
+    }
+
+    /**
+     * Public function to encode url parameters
+     *
+     * This function is used to encode path to file before output.
+     * Encoding is done according to RFC 3986 with one exception:
+     * Character '/' is preserved as is.
+     *
+     * @param string $component part of URI to encode
+     * @return string
+     * @deprecated 32.0.0 use \OCP\Util::encodePath instead
+     */
+    public static function encodePath($component) {
+        $encoded = rawurlencode($component);
+        $encoded = str_replace('%2F', '/', $encoded);
+        return $encoded;
+    }
+
+    /**
+     * Check if current locale is non-UTF8
+     *
+     * @return bool
+     */
+    private static function isNonUTF8Locale() {
+        if (function_exists('escapeshellcmd')) {
+            return escapeshellcmd('§') === '';
+        } elseif (function_exists('escapeshellarg')) {
+            return escapeshellarg('§') === '\'\'';
+        } else {
+            return preg_match('/utf-?8/i', setlocale(LC_CTYPE, 0)) === 0;
+        }
+    }
+
+    /**
+     * Check if the setlocale call does not work. This can happen if the right
+     * local packages are not available on the server.
+     *
+     * @internal
+     */
+    public static function isSetLocaleWorking(): bool {
+        if (self::isNonUTF8Locale()) {
+            // Borrowed from \Patchwork\Utf8\Bootup::initLocale
+            setlocale(LC_ALL, 'C.UTF-8', 'C');
+            setlocale(LC_CTYPE, 'en_US.UTF-8', 'fr_FR.UTF-8', 'es_ES.UTF-8', 'de_DE.UTF-8', 'ru_RU.UTF-8', 'pt_BR.UTF-8', 'it_IT.UTF-8', 'ja_JP.UTF-8', 'zh_CN.UTF-8', '0');
+
+            // Check again
+            if (self::isNonUTF8Locale()) {
+                return false;
+            }
+        }
+
+        return true;
+    }
+
+    /**
+     * Check if it's possible to get the inline annotations
+     *
+     * @internal
+     */
+    public static function isAnnotationsWorking(): bool {
+        if (PHP_VERSION_ID >= 80300) {
+            /** @psalm-suppress UndefinedMethod */
+            $reflection = \ReflectionMethod::createFromMethodName(__METHOD__);
+        } else {
+            $reflection = new \ReflectionMethod(__METHOD__);
+        }
+        $docs = $reflection->getDocComment();
+
+        return (is_string($docs) && strlen($docs) > 50);
+    }
+
+    /**
+     * Check if the PHP module fileinfo is loaded.
+     *
+     * @internal
+     */
+    public static function fileInfoLoaded(): bool {
+        return function_exists('finfo_open');
+    }
+
+    /**
+     * clear all levels of output buffering
+     *
+     * @return void
+     */
+    public static function obEnd() {
+        while (ob_get_level()) {
+            ob_end_clean();
+        }
+    }
+
+    /**
+     * Checks whether the server is running on Mac OS X
+     *
+     * @return bool true if running on Mac OS X, false otherwise
+     */
+    public static function runningOnMac() {
+        return (strtoupper(substr(PHP_OS, 0, 6)) === 'DARWIN');
+    }
+
+    /**
+     * Handles the case that there may not be a theme, then check if a "default"
+     * theme exists and take that one
+     *
+     * @return string the theme
+     */
+    public static function getTheme() {
+        $theme = \OC::$server->getSystemConfig()->getValue('theme', '');
+
+        if ($theme === '') {
+            if (is_dir(OC::$SERVERROOT . '/themes/default')) {
+                $theme = 'default';
+            }
+        }
+
+        return $theme;
+    }
+
+    /**
+     * Normalize a unicode string
+     *
+     * @param string $value a not normalized string
+     * @return string The normalized string or the input if the normalization failed
+     */
+    public static function normalizeUnicode(string $value): string {
+        if (Normalizer::isNormalized($value)) {
+            return $value;
+        }
+
+        $normalizedValue = Normalizer::normalize($value);
+        if ($normalizedValue === false) {
+            \OCP\Server::get(LoggerInterface::class)->warning('normalizing failed for "' . $value . '"', ['app' => 'core']);
+            return $value;
+        }
+
+        return $normalizedValue;
+    }
+
+    /**
+     * Check whether the instance needs to perform an upgrade,
+     * either when the core version is higher or any app requires
+     * an upgrade.
+     *
+     * @param \OC\SystemConfig $config
+     * @return bool whether the core or any app needs an upgrade
+     * @throws \OCP\HintException When the upgrade from the given version is not allowed
+     * @deprecated 32.0.0 Use \OCP\Util::needUpgrade instead
+     */
+    public static function needUpgrade(\OC\SystemConfig $config) {
+        if ($config->getValue('installed', false)) {
+            $installedVersion = $config->getValue('version', '0.0.0');
+            $currentVersion = implode('.', \OCP\Util::getVersion());
+            $versionDiff = version_compare($currentVersion, $installedVersion);
+            if ($versionDiff > 0) {
+                return true;
+            } elseif ($config->getValue('debug', false) && $versionDiff < 0) {
+                // downgrade with debug
+                $installedMajor = explode('.', $installedVersion);
+                $installedMajor = $installedMajor[0] . '.' . $installedMajor[1];
+                $currentMajor = explode('.', $currentVersion);
+                $currentMajor = $currentMajor[0] . '.' . $currentMajor[1];
+                if ($installedMajor === $currentMajor) {
+                    // Same major, allow downgrade for developers
+                    return true;
+                } else {
+                    // downgrade attempt, throw exception
+                    throw new \OCP\HintException('Downgrading is not supported and is likely to cause unpredictable issues (from ' . $installedVersion . ' to ' . $currentVersion . ')');
+                }
+            } elseif ($versionDiff < 0) {
+                // downgrade attempt, throw exception
+                throw new \OCP\HintException('Downgrading is not supported and is likely to cause unpredictable issues (from ' . $installedVersion . ' to ' . $currentVersion . ')');
+            }
+
+            // also check for upgrades for apps (independently from the user)
+            $apps = \OC_App::getEnabledApps(false, true);
+            $shouldUpgrade = false;
+            foreach ($apps as $app) {
+                if (\OC_App::shouldUpgrade($app)) {
+                    $shouldUpgrade = true;
+                    break;
+                }
+            }
+            return $shouldUpgrade;
+        } else {
+            return false;
+        }
+    }
 }

lib/private/User/LazyUser.php

Indentation +152 added lines, -152 removed lines

@@ -13,166 +13,166 @@
 use OCP\UserInterface;
 
 class LazyUser implements IUser {
-	private ?IUser $user = null;
-	private string $uid;
-	private ?string $displayName;
-	private IUserManager $userManager;
-	private ?UserInterface $backend;
-
-	public function __construct(string $uid, IUserManager $userManager, ?string $displayName = null, ?UserInterface $backend = null) {
-		$this->uid = $uid;
-		$this->userManager = $userManager;
-		$this->displayName = $displayName;
-		$this->backend = $backend;
-	}
-
-	private function getUser(): IUser {
-		if ($this->user === null) {
-			if ($this->backend) {
-				/** @var \OC\User\Manager $manager */
-				$manager = $this->userManager;
-				$this->user = $manager->getUserObject($this->uid, $this->backend);
-			} else {
-				$this->user = $this->userManager->get($this->uid);
-			}
-		}
-
-		if ($this->user === null) {
-			throw new NoUserException('User not found in backend');
-		}
-
-		return $this->user;
-	}
-
-	public function getUID() {
-		return $this->uid;
-	}
-
-	public function getDisplayName() {
-		if ($this->displayName) {
-			return $this->displayName;
-		}
-
-		return $this->userManager->getDisplayName($this->uid) ?? $this->uid;
-	}
-
-	public function setDisplayName($displayName) {
-		return $this->getUser()->setDisplayName($displayName);
-	}
-
-	public function getLastLogin(): int {
-		return $this->getUser()->getLastLogin();
-	}
-
-	public function getFirstLogin(): int {
-		return $this->getUser()->getFirstLogin();
-	}
-
-	public function updateLastLoginTimestamp(): bool {
-		return $this->getUser()->updateLastLoginTimestamp();
-	}
-
-	public function delete() {
-		return $this->getUser()->delete();
-	}
-
-	public function setPassword($password, $recoveryPassword = null) {
-		return $this->getUser()->setPassword($password, $recoveryPassword);
-	}
-
-	public function getPasswordHash(): ?string {
-		return $this->getUser()->getPasswordHash();
-	}
-
-	public function setPasswordHash(string $passwordHash): bool {
-		return $this->getUser()->setPasswordHash($passwordHash);
-	}
-
-	public function getHome() {
-		return $this->getUser()->getHome();
-	}
-
-	public function getBackendClassName() {
-		return $this->getUser()->getBackendClassName();
-	}
-
-	public function getBackend(): ?UserInterface {
-		return $this->getUser()->getBackend();
-	}
-
-	public function canChangeAvatar() {
-		return $this->getUser()->canChangeAvatar();
-	}
-
-	public function canChangePassword() {
-		return $this->getUser()->canChangePassword();
-	}
-
-	public function canChangeDisplayName() {
-		return $this->getUser()->canChangeDisplayName();
-	}
-
-	public function canChangeEmail(): bool {
-		return $this->getUser()->canChangeEmail();
-	}
-
-	public function isEnabled() {
-		return $this->getUser()->isEnabled();
-	}
-
-	public function setEnabled(bool $enabled = true) {
-		return $this->getUser()->setEnabled($enabled);
-	}
-
-	public function getEMailAddress() {
-		return $this->getUser()->getEMailAddress();
-	}
-
-	public function getSystemEMailAddress(): ?string {
-		return $this->getUser()->getSystemEMailAddress();
-	}
-
-	public function getPrimaryEMailAddress(): ?string {
-		return $this->getUser()->getPrimaryEMailAddress();
-	}
+    private ?IUser $user = null;
+    private string $uid;
+    private ?string $displayName;
+    private IUserManager $userManager;
+    private ?UserInterface $backend;
+
+    public function __construct(string $uid, IUserManager $userManager, ?string $displayName = null, ?UserInterface $backend = null) {
+        $this->uid = $uid;
+        $this->userManager = $userManager;
+        $this->displayName = $displayName;
+        $this->backend = $backend;
+    }
+
+    private function getUser(): IUser {
+        if ($this->user === null) {
+            if ($this->backend) {
+                /** @var \OC\User\Manager $manager */
+                $manager = $this->userManager;
+                $this->user = $manager->getUserObject($this->uid, $this->backend);
+            } else {
+                $this->user = $this->userManager->get($this->uid);
+            }
+        }
+
+        if ($this->user === null) {
+            throw new NoUserException('User not found in backend');
+        }
+
+        return $this->user;
+    }
+
+    public function getUID() {
+        return $this->uid;
+    }
+
+    public function getDisplayName() {
+        if ($this->displayName) {
+            return $this->displayName;
+        }
+
+        return $this->userManager->getDisplayName($this->uid) ?? $this->uid;
+    }
+
+    public function setDisplayName($displayName) {
+        return $this->getUser()->setDisplayName($displayName);
+    }
+
+    public function getLastLogin(): int {
+        return $this->getUser()->getLastLogin();
+    }
+
+    public function getFirstLogin(): int {
+        return $this->getUser()->getFirstLogin();
+    }
+
+    public function updateLastLoginTimestamp(): bool {
+        return $this->getUser()->updateLastLoginTimestamp();
+    }
+
+    public function delete() {
+        return $this->getUser()->delete();
+    }
+
+    public function setPassword($password, $recoveryPassword = null) {
+        return $this->getUser()->setPassword($password, $recoveryPassword);
+    }
+
+    public function getPasswordHash(): ?string {
+        return $this->getUser()->getPasswordHash();
+    }
+
+    public function setPasswordHash(string $passwordHash): bool {
+        return $this->getUser()->setPasswordHash($passwordHash);
+    }
+
+    public function getHome() {
+        return $this->getUser()->getHome();
+    }
+
+    public function getBackendClassName() {
+        return $this->getUser()->getBackendClassName();
+    }
+
+    public function getBackend(): ?UserInterface {
+        return $this->getUser()->getBackend();
+    }
+
+    public function canChangeAvatar() {
+        return $this->getUser()->canChangeAvatar();
+    }
+
+    public function canChangePassword() {
+        return $this->getUser()->canChangePassword();
+    }
+
+    public function canChangeDisplayName() {
+        return $this->getUser()->canChangeDisplayName();
+    }
+
+    public function canChangeEmail(): bool {
+        return $this->getUser()->canChangeEmail();
+    }
+
+    public function isEnabled() {
+        return $this->getUser()->isEnabled();
+    }
+
+    public function setEnabled(bool $enabled = true) {
+        return $this->getUser()->setEnabled($enabled);
+    }
+
+    public function getEMailAddress() {
+        return $this->getUser()->getEMailAddress();
+    }
+
+    public function getSystemEMailAddress(): ?string {
+        return $this->getUser()->getSystemEMailAddress();
+    }
+
+    public function getPrimaryEMailAddress(): ?string {
+        return $this->getUser()->getPrimaryEMailAddress();
+    }
 
-	public function getAvatarImage($size) {
-		return $this->getUser()->getAvatarImage($size);
-	}
+    public function getAvatarImage($size) {
+        return $this->getUser()->getAvatarImage($size);
+    }
 
-	public function getCloudId() {
-		return $this->getUser()->getCloudId();
-	}
+    public function getCloudId() {
+        return $this->getUser()->getCloudId();
+    }
 
-	public function setEMailAddress($mailAddress) {
-		$this->getUser()->setEMailAddress($mailAddress);
-	}
+    public function setEMailAddress($mailAddress) {
+        $this->getUser()->setEMailAddress($mailAddress);
+    }
 
-	public function setSystemEMailAddress(string $mailAddress): void {
-		$this->getUser()->setSystemEMailAddress($mailAddress);
-	}
+    public function setSystemEMailAddress(string $mailAddress): void {
+        $this->getUser()->setSystemEMailAddress($mailAddress);
+    }
 
-	public function setPrimaryEMailAddress(string $mailAddress): void {
-		$this->getUser()->setPrimaryEMailAddress($mailAddress);
-	}
+    public function setPrimaryEMailAddress(string $mailAddress): void {
+        $this->getUser()->setPrimaryEMailAddress($mailAddress);
+    }
 
-	public function getQuota() {
-		return $this->getUser()->getQuota();
-	}
+    public function getQuota() {
+        return $this->getUser()->getQuota();
+    }
 
-	public function getQuotaBytes(): int|float {
-		return $this->getUser()->getQuotaBytes();
-	}
+    public function getQuotaBytes(): int|float {
+        return $this->getUser()->getQuotaBytes();
+    }
 
-	public function setQuota($quota) {
-		$this->getUser()->setQuota($quota);
-	}
+    public function setQuota($quota) {
+        $this->getUser()->setQuota($quota);
+    }
 
-	public function getManagerUids(): array {
-		return $this->getUser()->getManagerUids();
-	}
+    public function getManagerUids(): array {
+        return $this->getUser()->getManagerUids();
+    }
 
-	public function setManagerUids(array $uids): void {
-		$this->getUser()->setManagerUids($uids);
-	}
+    public function setManagerUids(array $uids): void {
+        $this->getUser()->setManagerUids($uids);
+    }
 }

Spacing +1 added lines, -1 removed lines

@@ -160,7 +160,7 @@
 		return $this->getUser()->getQuota();
 	}
 
-	public function getQuotaBytes(): int|float {
+	public function getQuotaBytes(): int | float {
 		return $this->getUser()->getQuotaBytes();
 	}
 

lib/private/User/User.php

Indentation +624 added lines, -624 removed lines

@@ -44,628 +44,628 @@
 use function json_encode;
 
 class User implements IUser {
-	private const CONFIG_KEY_MANAGERS = 'manager';
-
-	private IConfig $config;
-	private IURLGenerator $urlGenerator;
-
-	/** @var IAccountManager */
-	protected $accountManager;
-
-	/** @var string|null */
-	private $displayName;
-
-	/** @var bool|null */
-	private $enabled;
-
-	/** @var Emitter|Manager|null */
-	private $emitter;
-
-	/** @var string */
-	private $home;
-
-	private ?int $lastLogin = null;
-	private ?int $firstLogin = null;
-
-	/** @var IAvatarManager */
-	private $avatarManager;
-
-	public function __construct(
-		private string $uid,
-		private ?UserInterface $backend,
-		private IEventDispatcher $dispatcher,
-		$emitter = null,
-		?IConfig $config = null,
-		$urlGenerator = null,
-	) {
-		$this->emitter = $emitter;
-		$this->config = $config ?? \OCP\Server::get(IConfig::class);
-		$this->urlGenerator = $urlGenerator ?? \OCP\Server::get(IURLGenerator::class);
-	}
-
-	/**
-	 * get the user id
-	 *
-	 * @return string
-	 */
-	public function getUID() {
-		return $this->uid;
-	}
-
-	/**
-	 * get the display name for the user, if no specific display name is set it will fallback to the user id
-	 *
-	 * @return string
-	 */
-	public function getDisplayName() {
-		if ($this->displayName === null) {
-			$displayName = '';
-			if ($this->backend && $this->backend->implementsActions(Backend::GET_DISPLAYNAME)) {
-				// get display name and strip whitespace from the beginning and end of it
-				$backendDisplayName = $this->backend->getDisplayName($this->uid);
-				if (is_string($backendDisplayName)) {
-					$displayName = trim($backendDisplayName);
-				}
-			}
-
-			if (!empty($displayName)) {
-				$this->displayName = $displayName;
-			} else {
-				$this->displayName = $this->uid;
-			}
-		}
-		return $this->displayName;
-	}
-
-	/**
-	 * set the displayname for the user
-	 *
-	 * @param string $displayName
-	 * @return bool
-	 *
-	 * @since 25.0.0 Throw InvalidArgumentException
-	 * @throws \InvalidArgumentException
-	 */
-	public function setDisplayName($displayName) {
-		$displayName = trim($displayName);
-		$oldDisplayName = $this->getDisplayName();
-		if ($this->backend->implementsActions(Backend::SET_DISPLAYNAME) && !empty($displayName) && $displayName !== $oldDisplayName) {
-			/** @var ISetDisplayNameBackend $backend */
-			$backend = $this->backend;
-			$result = $backend->setDisplayName($this->uid, $displayName);
-			if ($result) {
-				$this->displayName = $displayName;
-				$this->triggerChange('displayName', $displayName, $oldDisplayName);
-			}
-			return $result !== false;
-		}
-		return false;
-	}
-
-	/**
-	 * @inheritDoc
-	 */
-	public function setEMailAddress($mailAddress) {
-		$this->setSystemEMailAddress($mailAddress);
-	}
-
-	/**
-	 * @inheritDoc
-	 */
-	public function setSystemEMailAddress(string $mailAddress): void {
-		$oldMailAddress = $this->getSystemEMailAddress();
-
-		if ($mailAddress === '') {
-			$this->config->deleteUserValue($this->uid, 'settings', 'email');
-		} else {
-			$this->config->setUserValue($this->uid, 'settings', 'email', $mailAddress);
-		}
-
-		$primaryAddress = $this->getPrimaryEMailAddress();
-		if ($primaryAddress === $mailAddress) {
-			// on match no dedicated primary settings is necessary
-			$this->setPrimaryEMailAddress('');
-		}
-
-		if ($oldMailAddress !== strtolower($mailAddress)) {
-			$this->triggerChange('eMailAddress', $mailAddress, $oldMailAddress);
-		}
-	}
-
-	/**
-	 * @inheritDoc
-	 */
-	public function setPrimaryEMailAddress(string $mailAddress): void {
-		if ($mailAddress === '') {
-			$this->config->deleteUserValue($this->uid, 'settings', 'primary_email');
-			return;
-		}
-
-		$this->ensureAccountManager();
-		$account = $this->accountManager->getAccount($this);
-		$property = $account->getPropertyCollection(IAccountManager::COLLECTION_EMAIL)
-			->getPropertyByValue($mailAddress);
-
-		if ($property === null || $property->getLocallyVerified() !== IAccountManager::VERIFIED) {
-			throw new InvalidArgumentException('Only verified emails can be set as primary');
-		}
-		$this->config->setUserValue($this->uid, 'settings', 'primary_email', $mailAddress);
-	}
-
-	private function ensureAccountManager() {
-		if (!$this->accountManager instanceof IAccountManager) {
-			$this->accountManager = \OC::$server->get(IAccountManager::class);
-		}
-	}
-
-	/**
-	 * returns the timestamp of the user's last login or 0 if the user did never
-	 * login
-	 */
-	public function getLastLogin(): int {
-		if ($this->lastLogin === null) {
-			$this->lastLogin = (int)$this->config->getUserValue($this->uid, 'login', 'lastLogin', 0);
-		}
-		return $this->lastLogin;
-	}
-
-	/**
-	 * returns the timestamp of the user's last login or 0 if the user did never
-	 * login
-	 */
-	public function getFirstLogin(): int {
-		if ($this->firstLogin === null) {
-			$this->firstLogin = (int)$this->config->getUserValue($this->uid, 'login', 'firstLogin', 0);
-		}
-		return $this->firstLogin;
-	}
-
-	/**
-	 * updates the timestamp of the most recent login of this user
-	 */
-	public function updateLastLoginTimestamp(): bool {
-		$previousLogin = $this->getLastLogin();
-		$firstLogin = $this->getFirstLogin();
-		$now = time();
-		$firstTimeLogin = $previousLogin === 0;
-
-		if ($now - $previousLogin > 60) {
-			$this->lastLogin = $now;
-			$this->config->setUserValue($this->uid, 'login', 'lastLogin', (string)$this->lastLogin);
-		}
-
-		if ($firstLogin === 0) {
-			if ($firstTimeLogin) {
-				$this->firstLogin = $now;
-			} else {
-				/* Unknown first login, most likely was before upgrade to Nextcloud 31 */
-				$this->firstLogin = -1;
-			}
-			$this->config->setUserValue($this->uid, 'login', 'firstLogin', (string)$this->firstLogin);
-		}
-
-		return $firstTimeLogin;
-	}
-
-	/**
-	 * Delete the user
-	 *
-	 * @return bool
-	 */
-	public function delete() {
-		if ($this->backend === null) {
-			\OCP\Server::get(LoggerInterface::class)->error('Cannot delete user: No backend set');
-			return false;
-		}
-
-		if ($this->emitter) {
-			/** @deprecated 21.0.0 use BeforeUserDeletedEvent event with the IEventDispatcher instead */
-			$this->emitter->emit('\OC\User', 'preDelete', [$this]);
-		}
-		$this->dispatcher->dispatchTyped(new BeforeUserDeletedEvent($this));
-
-		// Set delete flag on the user - this is needed to ensure that the user data is removed if there happen any exception in the backend
-		// because we can not restore the user meaning we could not rollback to any stable state otherwise.
-		$this->config->setUserValue($this->uid, 'core', 'deleted', 'true');
-		// We also need to backup the home path as this can not be reconstructed later if the original backend uses custom home paths
-		$this->config->setUserValue($this->uid, 'core', 'deleted.home-path', $this->getHome());
-
-		// Try to delete the user on the backend
-		$result = $this->backend->deleteUser($this->uid);
-		if ($result === false) {
-			// The deletion was aborted or something else happened, we are in a defined state, so remove the delete flag
-			$this->config->deleteUserValue($this->uid, 'core', 'deleted');
-			return false;
-		}
-
-		// We have to delete the user from all groups
-		$groupManager = \OCP\Server::get(IGroupManager::class);
-		foreach ($groupManager->getUserGroupIds($this) as $groupId) {
-			$group = $groupManager->get($groupId);
-			if ($group) {
-				$this->dispatcher->dispatchTyped(new BeforeUserRemovedEvent($group, $this));
-				$group->removeUser($this);
-				$this->dispatcher->dispatchTyped(new UserRemovedEvent($group, $this));
-			}
-		}
-
-		$commentsManager = \OCP\Server::get(ICommentsManager::class);
-		$commentsManager->deleteReferencesOfActor('users', $this->uid);
-		$commentsManager->deleteReadMarksFromUser($this);
-
-		$avatarManager = \OCP\Server::get(AvatarManager::class);
-		$avatarManager->deleteUserAvatar($this->uid);
-
-		$notificationManager = \OCP\Server::get(INotificationManager::class);
-		$notification = $notificationManager->createNotification();
-		$notification->setUser($this->uid);
-		$notificationManager->markProcessed($notification);
-
-		$accountManager = \OCP\Server::get(AccountManager::class);
-		$accountManager->deleteUser($this);
-
-		$database = \OCP\Server::get(IDBConnection::class);
-		try {
-			// We need to create a transaction to make sure we are in a defined state
-			// because if all user values are removed also the flag is gone, but if an exception happens (e.g. database lost connection on the set operation)
-			// exactly here we are in an undefined state as the data is still present but the user does not exist on the system anymore.
-			$database->beginTransaction();
-			// Remove all user settings
-			$this->config->deleteAllUserValues($this->uid);
-			// But again set flag that this user is about to be deleted
-			$this->config->setUserValue($this->uid, 'core', 'deleted', 'true');
-			$this->config->setUserValue($this->uid, 'core', 'deleted.home-path', $this->getHome());
-			// Commit the transaction so we are in a defined state: either the preferences are removed or an exception occurred but the delete flag is still present
-			$database->commit();
-		} catch (\Throwable $e) {
-			$database->rollback();
-			throw $e;
-		}
-
-		if ($this->emitter !== null) {
-			/** @deprecated 21.0.0 use UserDeletedEvent event with the IEventDispatcher instead */
-			$this->emitter->emit('\OC\User', 'postDelete', [$this]);
-		}
-		$this->dispatcher->dispatchTyped(new UserDeletedEvent($this));
-
-		// Finally we can unset the delete flag and all other states
-		$this->config->deleteAllUserValues($this->uid);
-
-		return true;
-	}
-
-	/**
-	 * Set the password of the user
-	 *
-	 * @param string $password
-	 * @param string $recoveryPassword for the encryption app to reset encryption keys
-	 * @return bool
-	 */
-	public function setPassword($password, $recoveryPassword = null) {
-		$this->dispatcher->dispatchTyped(new BeforePasswordUpdatedEvent($this, $password, $recoveryPassword));
-		if ($this->emitter) {
-			$this->emitter->emit('\OC\User', 'preSetPassword', [$this, $password, $recoveryPassword]);
-		}
-		if ($this->backend->implementsActions(Backend::SET_PASSWORD)) {
-			/** @var ISetPasswordBackend $backend */
-			$backend = $this->backend;
-			$result = $backend->setPassword($this->uid, $password);
-
-			if ($result !== false) {
-				$this->dispatcher->dispatchTyped(new PasswordUpdatedEvent($this, $password, $recoveryPassword));
-				if ($this->emitter) {
-					$this->emitter->emit('\OC\User', 'postSetPassword', [$this, $password, $recoveryPassword]);
-				}
-			}
-
-			return !($result === false);
-		} else {
-			return false;
-		}
-	}
-
-	public function getPasswordHash(): ?string {
-		if (!($this->backend instanceof IPasswordHashBackend)) {
-			return null;
-		}
-		return $this->backend->getPasswordHash($this->uid);
-	}
-
-	public function setPasswordHash(string $passwordHash): bool {
-		if (!($this->backend instanceof IPasswordHashBackend)) {
-			return false;
-		}
-		return $this->backend->setPasswordHash($this->uid, $passwordHash);
-	}
-
-	/**
-	 * get the users home folder to mount
-	 *
-	 * @return string
-	 */
-	public function getHome() {
-		if (!$this->home) {
-			/** @psalm-suppress UndefinedInterfaceMethod Once we get rid of the legacy implementsActions, psalm won't complain anymore */
-			if (($this->backend instanceof IGetHomeBackend || $this->backend->implementsActions(Backend::GET_HOME)) && $home = $this->backend->getHome($this->uid)) {
-				$this->home = $home;
-			} else {
-				$this->home = $this->config->getSystemValueString('datadirectory', \OC::$SERVERROOT . '/data') . '/' . $this->uid;
-			}
-		}
-		return $this->home;
-	}
-
-	/**
-	 * Get the name of the backend class the user is connected with
-	 *
-	 * @return string
-	 */
-	public function getBackendClassName() {
-		if ($this->backend instanceof IUserBackend) {
-			return $this->backend->getBackendName();
-		}
-		return get_class($this->backend);
-	}
-
-	public function getBackend(): ?UserInterface {
-		return $this->backend;
-	}
-
-	/**
-	 * Check if the backend allows the user to change their avatar on Personal page
-	 *
-	 * @return bool
-	 */
-	public function canChangeAvatar() {
-		if ($this->backend instanceof IProvideAvatarBackend || $this->backend->implementsActions(Backend::PROVIDE_AVATAR)) {
-			/** @var IProvideAvatarBackend $backend */
-			$backend = $this->backend;
-			return $backend->canChangeAvatar($this->uid);
-		}
-		return true;
-	}
-
-	/**
-	 * check if the backend supports changing passwords
-	 *
-	 * @return bool
-	 */
-	public function canChangePassword() {
-		return $this->backend->implementsActions(Backend::SET_PASSWORD);
-	}
-
-	/**
-	 * check if the backend supports changing display names
-	 *
-	 * @return bool
-	 */
-	public function canChangeDisplayName() {
-		if (!$this->config->getSystemValueBool('allow_user_to_change_display_name', true)) {
-			return false;
-		}
-		return $this->backend->implementsActions(Backend::SET_DISPLAYNAME);
-	}
-
-	public function canChangeEmail(): bool {
-		// Fallback to display name value to avoid changing behavior with the new option.
-		return $this->config->getSystemValueBool('allow_user_to_change_email', $this->config->getSystemValueBool('allow_user_to_change_display_name', true));
-	}
-
-	/**
-	 * check if the user is enabled
-	 *
-	 * @return bool
-	 */
-	public function isEnabled() {
-		$queryDatabaseValue = function (): bool {
-			if ($this->enabled === null) {
-				$enabled = $this->config->getUserValue($this->uid, 'core', 'enabled', 'true');
-				$this->enabled = $enabled === 'true';
-			}
-			return $this->enabled;
-		};
-		if ($this->backend instanceof IProvideEnabledStateBackend) {
-			return $this->backend->isUserEnabled($this->uid, $queryDatabaseValue);
-		} else {
-			return $queryDatabaseValue();
-		}
-	}
-
-	/**
-	 * set the enabled status for the user
-	 *
-	 * @return void
-	 */
-	public function setEnabled(bool $enabled = true) {
-		$oldStatus = $this->isEnabled();
-		$setDatabaseValue = function (bool $enabled): void {
-			$this->config->setUserValue($this->uid, 'core', 'enabled', $enabled ? 'true' : 'false');
-			$this->enabled = $enabled;
-		};
-		if ($this->backend instanceof IProvideEnabledStateBackend) {
-			$queryDatabaseValue = function (): bool {
-				if ($this->enabled === null) {
-					$enabled = $this->config->getUserValue($this->uid, 'core', 'enabled', 'true');
-					$this->enabled = $enabled === 'true';
-				}
-				return $this->enabled;
-			};
-			$enabled = $this->backend->setUserEnabled($this->uid, $enabled, $queryDatabaseValue, $setDatabaseValue);
-			if ($oldStatus !== $enabled) {
-				$this->triggerChange('enabled', $enabled, $oldStatus);
-			}
-		} elseif ($oldStatus !== $enabled) {
-			$setDatabaseValue($enabled);
-			$this->triggerChange('enabled', $enabled, $oldStatus);
-		}
-	}
-
-	/**
-	 * get the users email address
-	 *
-	 * @return string|null
-	 * @since 9.0.0
-	 */
-	public function getEMailAddress() {
-		return $this->getPrimaryEMailAddress() ?? $this->getSystemEMailAddress();
-	}
-
-	/**
-	 * @inheritDoc
-	 */
-	public function getSystemEMailAddress(): ?string {
-		return $this->config->getUserValue($this->uid, 'settings', 'email', null);
-	}
-
-	/**
-	 * @inheritDoc
-	 */
-	public function getPrimaryEMailAddress(): ?string {
-		return $this->config->getUserValue($this->uid, 'settings', 'primary_email', null);
-	}
-
-	/**
-	 * get the users' quota
-	 *
-	 * @return string
-	 * @since 9.0.0
-	 */
-	public function getQuota() {
-		// allow apps to modify the user quota by hooking into the event
-		$event = new GetQuotaEvent($this);
-		$this->dispatcher->dispatchTyped($event);
-		$overwriteQuota = $event->getQuota();
-		if ($overwriteQuota) {
-			$quota = $overwriteQuota;
-		} else {
-			$quota = $this->config->getUserValue($this->uid, 'files', 'quota', 'default');
-		}
-		if ($quota === 'default') {
-			$quota = $this->config->getAppValue('files', 'default_quota', 'none');
-
-			// if unlimited quota is not allowed => avoid getting 'unlimited' as default_quota fallback value
-			// use the first preset instead
-			$allowUnlimitedQuota = $this->config->getAppValue('files', 'allow_unlimited_quota', '1') === '1';
-			if (!$allowUnlimitedQuota) {
-				$presets = $this->config->getAppValue('files', 'quota_preset', '1 GB, 5 GB, 10 GB');
-				$presets = array_filter(array_map('trim', explode(',', $presets)));
-				$quotaPreset = array_values(array_diff($presets, ['default', 'none']));
-				if (count($quotaPreset) > 0) {
-					$quota = $this->config->getAppValue('files', 'default_quota', $quotaPreset[0]);
-				}
-			}
-		}
-		return $quota;
-	}
-
-	public function getQuotaBytes(): int|float {
-		$quota = $this->getQuota();
-		if ($quota === 'none') {
-			return \OCP\Files\FileInfo::SPACE_UNLIMITED;
-		}
-
-		$bytes = \OCP\Util::computerFileSize($quota);
-		if ($bytes === false) {
-			return \OCP\Files\FileInfo::SPACE_UNKNOWN;
-		}
-		return $bytes;
-	}
-
-	/**
-	 * set the users' quota
-	 *
-	 * @param string $quota
-	 * @return void
-	 * @throws InvalidArgumentException
-	 * @since 9.0.0
-	 */
-	public function setQuota($quota) {
-		$oldQuota = $this->config->getUserValue($this->uid, 'files', 'quota', '');
-		if ($quota !== 'none' and $quota !== 'default') {
-			$bytesQuota = \OCP\Util::computerFileSize($quota);
-			if ($bytesQuota === false) {
-				throw new InvalidArgumentException('Failed to set quota to invalid value ' . $quota);
-			}
-			$quota = \OCP\Util::humanFileSize($bytesQuota);
-		}
-		if ($quota !== $oldQuota) {
-			$this->config->setUserValue($this->uid, 'files', 'quota', $quota);
-			$this->triggerChange('quota', $quota, $oldQuota);
-		}
-		\OC_Helper::clearStorageInfo('/' . $this->uid . '/files');
-	}
-
-	public function getManagerUids(): array {
-		$encodedUids = $this->config->getUserValue(
-			$this->uid,
-			'settings',
-			self::CONFIG_KEY_MANAGERS,
-			'[]'
-		);
-		return json_decode($encodedUids, false, 512, JSON_THROW_ON_ERROR);
-	}
-
-	public function setManagerUids(array $uids): void {
-		$oldUids = $this->getManagerUids();
-		$this->config->setUserValue(
-			$this->uid,
-			'settings',
-			self::CONFIG_KEY_MANAGERS,
-			json_encode($uids, JSON_THROW_ON_ERROR)
-		);
-		$this->triggerChange('managers', $uids, $oldUids);
-	}
-
-	/**
-	 * get the avatar image if it exists
-	 *
-	 * @param int $size
-	 * @return IImage|null
-	 * @since 9.0.0
-	 */
-	public function getAvatarImage($size) {
-		// delay the initialization
-		if (is_null($this->avatarManager)) {
-			$this->avatarManager = \OC::$server->get(IAvatarManager::class);
-		}
-
-		$avatar = $this->avatarManager->getAvatar($this->uid);
-		$image = $avatar->get($size);
-		if ($image) {
-			return $image;
-		}
-
-		return null;
-	}
-
-	/**
-	 * get the federation cloud id
-	 *
-	 * @return string
-	 * @since 9.0.0
-	 */
-	public function getCloudId() {
-		$uid = $this->getUID();
-		$server = rtrim($this->urlGenerator->getAbsoluteURL('/'), '/');
-		if (str_ends_with($server, '/index.php')) {
-			$server = substr($server, 0, -10);
-		}
-		$server = $this->removeProtocolFromUrl($server);
-		return $uid . '@' . $server;
-	}
-
-	private function removeProtocolFromUrl(string $url): string {
-		if (str_starts_with($url, 'https://')) {
-			return substr($url, strlen('https://'));
-		}
-
-		return $url;
-	}
-
-	public function triggerChange($feature, $value = null, $oldValue = null) {
-		$this->dispatcher->dispatchTyped(new UserChangedEvent($this, $feature, $value, $oldValue));
-		if ($this->emitter) {
-			$this->emitter->emit('\OC\User', 'changeUser', [$this, $feature, $value, $oldValue]);
-		}
-	}
+    private const CONFIG_KEY_MANAGERS = 'manager';
+
+    private IConfig $config;
+    private IURLGenerator $urlGenerator;
+
+    /** @var IAccountManager */
+    protected $accountManager;
+
+    /** @var string|null */
+    private $displayName;
+
+    /** @var bool|null */
+    private $enabled;
+
+    /** @var Emitter|Manager|null */
+    private $emitter;
+
+    /** @var string */
+    private $home;
+
+    private ?int $lastLogin = null;
+    private ?int $firstLogin = null;
+
+    /** @var IAvatarManager */
+    private $avatarManager;
+
+    public function __construct(
+        private string $uid,
+        private ?UserInterface $backend,
+        private IEventDispatcher $dispatcher,
+        $emitter = null,
+        ?IConfig $config = null,
+        $urlGenerator = null,
+    ) {
+        $this->emitter = $emitter;
+        $this->config = $config ?? \OCP\Server::get(IConfig::class);
+        $this->urlGenerator = $urlGenerator ?? \OCP\Server::get(IURLGenerator::class);
+    }
+
+    /**
+     * get the user id
+     *
+     * @return string
+     */
+    public function getUID() {
+        return $this->uid;
+    }
+
+    /**
+     * get the display name for the user, if no specific display name is set it will fallback to the user id
+     *
+     * @return string
+     */
+    public function getDisplayName() {
+        if ($this->displayName === null) {
+            $displayName = '';
+            if ($this->backend && $this->backend->implementsActions(Backend::GET_DISPLAYNAME)) {
+                // get display name and strip whitespace from the beginning and end of it
+                $backendDisplayName = $this->backend->getDisplayName($this->uid);
+                if (is_string($backendDisplayName)) {
+                    $displayName = trim($backendDisplayName);
+                }
+            }
+
+            if (!empty($displayName)) {
+                $this->displayName = $displayName;
+            } else {
+                $this->displayName = $this->uid;
+            }
+        }
+        return $this->displayName;
+    }
+
+    /**
+     * set the displayname for the user
+     *
+     * @param string $displayName
+     * @return bool
+     *
+     * @since 25.0.0 Throw InvalidArgumentException
+     * @throws \InvalidArgumentException
+     */
+    public function setDisplayName($displayName) {
+        $displayName = trim($displayName);
+        $oldDisplayName = $this->getDisplayName();
+        if ($this->backend->implementsActions(Backend::SET_DISPLAYNAME) && !empty($displayName) && $displayName !== $oldDisplayName) {
+            /** @var ISetDisplayNameBackend $backend */
+            $backend = $this->backend;
+            $result = $backend->setDisplayName($this->uid, $displayName);
+            if ($result) {
+                $this->displayName = $displayName;
+                $this->triggerChange('displayName', $displayName, $oldDisplayName);
+            }
+            return $result !== false;
+        }
+        return false;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function setEMailAddress($mailAddress) {
+        $this->setSystemEMailAddress($mailAddress);
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function setSystemEMailAddress(string $mailAddress): void {
+        $oldMailAddress = $this->getSystemEMailAddress();
+
+        if ($mailAddress === '') {
+            $this->config->deleteUserValue($this->uid, 'settings', 'email');
+        } else {
+            $this->config->setUserValue($this->uid, 'settings', 'email', $mailAddress);
+        }
+
+        $primaryAddress = $this->getPrimaryEMailAddress();
+        if ($primaryAddress === $mailAddress) {
+            // on match no dedicated primary settings is necessary
+            $this->setPrimaryEMailAddress('');
+        }
+
+        if ($oldMailAddress !== strtolower($mailAddress)) {
+            $this->triggerChange('eMailAddress', $mailAddress, $oldMailAddress);
+        }
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function setPrimaryEMailAddress(string $mailAddress): void {
+        if ($mailAddress === '') {
+            $this->config->deleteUserValue($this->uid, 'settings', 'primary_email');
+            return;
+        }
+
+        $this->ensureAccountManager();
+        $account = $this->accountManager->getAccount($this);
+        $property = $account->getPropertyCollection(IAccountManager::COLLECTION_EMAIL)
+            ->getPropertyByValue($mailAddress);
+
+        if ($property === null || $property->getLocallyVerified() !== IAccountManager::VERIFIED) {
+            throw new InvalidArgumentException('Only verified emails can be set as primary');
+        }
+        $this->config->setUserValue($this->uid, 'settings', 'primary_email', $mailAddress);
+    }
+
+    private function ensureAccountManager() {
+        if (!$this->accountManager instanceof IAccountManager) {
+            $this->accountManager = \OC::$server->get(IAccountManager::class);
+        }
+    }
+
+    /**
+     * returns the timestamp of the user's last login or 0 if the user did never
+     * login
+     */
+    public function getLastLogin(): int {
+        if ($this->lastLogin === null) {
+            $this->lastLogin = (int)$this->config->getUserValue($this->uid, 'login', 'lastLogin', 0);
+        }
+        return $this->lastLogin;
+    }
+
+    /**
+     * returns the timestamp of the user's last login or 0 if the user did never
+     * login
+     */
+    public function getFirstLogin(): int {
+        if ($this->firstLogin === null) {
+            $this->firstLogin = (int)$this->config->getUserValue($this->uid, 'login', 'firstLogin', 0);
+        }
+        return $this->firstLogin;
+    }
+
+    /**
+     * updates the timestamp of the most recent login of this user
+     */
+    public function updateLastLoginTimestamp(): bool {
+        $previousLogin = $this->getLastLogin();
+        $firstLogin = $this->getFirstLogin();
+        $now = time();
+        $firstTimeLogin = $previousLogin === 0;
+
+        if ($now - $previousLogin > 60) {
+            $this->lastLogin = $now;
+            $this->config->setUserValue($this->uid, 'login', 'lastLogin', (string)$this->lastLogin);
+        }
+
+        if ($firstLogin === 0) {
+            if ($firstTimeLogin) {
+                $this->firstLogin = $now;
+            } else {
+                /* Unknown first login, most likely was before upgrade to Nextcloud 31 */
+                $this->firstLogin = -1;
+            }
+            $this->config->setUserValue($this->uid, 'login', 'firstLogin', (string)$this->firstLogin);
+        }
+
+        return $firstTimeLogin;
+    }
+
+    /**
+     * Delete the user
+     *
+     * @return bool
+     */
+    public function delete() {
+        if ($this->backend === null) {
+            \OCP\Server::get(LoggerInterface::class)->error('Cannot delete user: No backend set');
+            return false;
+        }
+
+        if ($this->emitter) {
+            /** @deprecated 21.0.0 use BeforeUserDeletedEvent event with the IEventDispatcher instead */
+            $this->emitter->emit('\OC\User', 'preDelete', [$this]);
+        }
+        $this->dispatcher->dispatchTyped(new BeforeUserDeletedEvent($this));
+
+        // Set delete flag on the user - this is needed to ensure that the user data is removed if there happen any exception in the backend
+        // because we can not restore the user meaning we could not rollback to any stable state otherwise.
+        $this->config->setUserValue($this->uid, 'core', 'deleted', 'true');
+        // We also need to backup the home path as this can not be reconstructed later if the original backend uses custom home paths
+        $this->config->setUserValue($this->uid, 'core', 'deleted.home-path', $this->getHome());
+
+        // Try to delete the user on the backend
+        $result = $this->backend->deleteUser($this->uid);
+        if ($result === false) {
+            // The deletion was aborted or something else happened, we are in a defined state, so remove the delete flag
+            $this->config->deleteUserValue($this->uid, 'core', 'deleted');
+            return false;
+        }
+
+        // We have to delete the user from all groups
+        $groupManager = \OCP\Server::get(IGroupManager::class);
+        foreach ($groupManager->getUserGroupIds($this) as $groupId) {
+            $group = $groupManager->get($groupId);
+            if ($group) {
+                $this->dispatcher->dispatchTyped(new BeforeUserRemovedEvent($group, $this));
+                $group->removeUser($this);
+                $this->dispatcher->dispatchTyped(new UserRemovedEvent($group, $this));
+            }
+        }
+
+        $commentsManager = \OCP\Server::get(ICommentsManager::class);
+        $commentsManager->deleteReferencesOfActor('users', $this->uid);
+        $commentsManager->deleteReadMarksFromUser($this);
+
+        $avatarManager = \OCP\Server::get(AvatarManager::class);
+        $avatarManager->deleteUserAvatar($this->uid);
+
+        $notificationManager = \OCP\Server::get(INotificationManager::class);
+        $notification = $notificationManager->createNotification();
+        $notification->setUser($this->uid);
+        $notificationManager->markProcessed($notification);
+
+        $accountManager = \OCP\Server::get(AccountManager::class);
+        $accountManager->deleteUser($this);
+
+        $database = \OCP\Server::get(IDBConnection::class);
+        try {
+            // We need to create a transaction to make sure we are in a defined state
+            // because if all user values are removed also the flag is gone, but if an exception happens (e.g. database lost connection on the set operation)
+            // exactly here we are in an undefined state as the data is still present but the user does not exist on the system anymore.
+            $database->beginTransaction();
+            // Remove all user settings
+            $this->config->deleteAllUserValues($this->uid);
+            // But again set flag that this user is about to be deleted
+            $this->config->setUserValue($this->uid, 'core', 'deleted', 'true');
+            $this->config->setUserValue($this->uid, 'core', 'deleted.home-path', $this->getHome());
+            // Commit the transaction so we are in a defined state: either the preferences are removed or an exception occurred but the delete flag is still present
+            $database->commit();
+        } catch (\Throwable $e) {
+            $database->rollback();
+            throw $e;
+        }
+
+        if ($this->emitter !== null) {
+            /** @deprecated 21.0.0 use UserDeletedEvent event with the IEventDispatcher instead */
+            $this->emitter->emit('\OC\User', 'postDelete', [$this]);
+        }
+        $this->dispatcher->dispatchTyped(new UserDeletedEvent($this));
+
+        // Finally we can unset the delete flag and all other states
+        $this->config->deleteAllUserValues($this->uid);
+
+        return true;
+    }
+
+    /**
+     * Set the password of the user
+     *
+     * @param string $password
+     * @param string $recoveryPassword for the encryption app to reset encryption keys
+     * @return bool
+     */
+    public function setPassword($password, $recoveryPassword = null) {
+        $this->dispatcher->dispatchTyped(new BeforePasswordUpdatedEvent($this, $password, $recoveryPassword));
+        if ($this->emitter) {
+            $this->emitter->emit('\OC\User', 'preSetPassword', [$this, $password, $recoveryPassword]);
+        }
+        if ($this->backend->implementsActions(Backend::SET_PASSWORD)) {
+            /** @var ISetPasswordBackend $backend */
+            $backend = $this->backend;
+            $result = $backend->setPassword($this->uid, $password);
+
+            if ($result !== false) {
+                $this->dispatcher->dispatchTyped(new PasswordUpdatedEvent($this, $password, $recoveryPassword));
+                if ($this->emitter) {
+                    $this->emitter->emit('\OC\User', 'postSetPassword', [$this, $password, $recoveryPassword]);
+                }
+            }
+
+            return !($result === false);
+        } else {
+            return false;
+        }
+    }
+
+    public function getPasswordHash(): ?string {
+        if (!($this->backend instanceof IPasswordHashBackend)) {
+            return null;
+        }
+        return $this->backend->getPasswordHash($this->uid);
+    }
+
+    public function setPasswordHash(string $passwordHash): bool {
+        if (!($this->backend instanceof IPasswordHashBackend)) {
+            return false;
+        }
+        return $this->backend->setPasswordHash($this->uid, $passwordHash);
+    }
+
+    /**
+     * get the users home folder to mount
+     *
+     * @return string
+     */
+    public function getHome() {
+        if (!$this->home) {
+            /** @psalm-suppress UndefinedInterfaceMethod Once we get rid of the legacy implementsActions, psalm won't complain anymore */
+            if (($this->backend instanceof IGetHomeBackend || $this->backend->implementsActions(Backend::GET_HOME)) && $home = $this->backend->getHome($this->uid)) {
+                $this->home = $home;
+            } else {
+                $this->home = $this->config->getSystemValueString('datadirectory', \OC::$SERVERROOT . '/data') . '/' . $this->uid;
+            }
+        }
+        return $this->home;
+    }
+
+    /**
+     * Get the name of the backend class the user is connected with
+     *
+     * @return string
+     */
+    public function getBackendClassName() {
+        if ($this->backend instanceof IUserBackend) {
+            return $this->backend->getBackendName();
+        }
+        return get_class($this->backend);
+    }
+
+    public function getBackend(): ?UserInterface {
+        return $this->backend;
+    }
+
+    /**
+     * Check if the backend allows the user to change their avatar on Personal page
+     *
+     * @return bool
+     */
+    public function canChangeAvatar() {
+        if ($this->backend instanceof IProvideAvatarBackend || $this->backend->implementsActions(Backend::PROVIDE_AVATAR)) {
+            /** @var IProvideAvatarBackend $backend */
+            $backend = $this->backend;
+            return $backend->canChangeAvatar($this->uid);
+        }
+        return true;
+    }
+
+    /**
+     * check if the backend supports changing passwords
+     *
+     * @return bool
+     */
+    public function canChangePassword() {
+        return $this->backend->implementsActions(Backend::SET_PASSWORD);
+    }
+
+    /**
+     * check if the backend supports changing display names
+     *
+     * @return bool
+     */
+    public function canChangeDisplayName() {
+        if (!$this->config->getSystemValueBool('allow_user_to_change_display_name', true)) {
+            return false;
+        }
+        return $this->backend->implementsActions(Backend::SET_DISPLAYNAME);
+    }
+
+    public function canChangeEmail(): bool {
+        // Fallback to display name value to avoid changing behavior with the new option.
+        return $this->config->getSystemValueBool('allow_user_to_change_email', $this->config->getSystemValueBool('allow_user_to_change_display_name', true));
+    }
+
+    /**
+     * check if the user is enabled
+     *
+     * @return bool
+     */
+    public function isEnabled() {
+        $queryDatabaseValue = function (): bool {
+            if ($this->enabled === null) {
+                $enabled = $this->config->getUserValue($this->uid, 'core', 'enabled', 'true');
+                $this->enabled = $enabled === 'true';
+            }
+            return $this->enabled;
+        };
+        if ($this->backend instanceof IProvideEnabledStateBackend) {
+            return $this->backend->isUserEnabled($this->uid, $queryDatabaseValue);
+        } else {
+            return $queryDatabaseValue();
+        }
+    }
+
+    /**
+     * set the enabled status for the user
+     *
+     * @return void
+     */
+    public function setEnabled(bool $enabled = true) {
+        $oldStatus = $this->isEnabled();
+        $setDatabaseValue = function (bool $enabled): void {
+            $this->config->setUserValue($this->uid, 'core', 'enabled', $enabled ? 'true' : 'false');
+            $this->enabled = $enabled;
+        };
+        if ($this->backend instanceof IProvideEnabledStateBackend) {
+            $queryDatabaseValue = function (): bool {
+                if ($this->enabled === null) {
+                    $enabled = $this->config->getUserValue($this->uid, 'core', 'enabled', 'true');
+                    $this->enabled = $enabled === 'true';
+                }
+                return $this->enabled;
+            };
+            $enabled = $this->backend->setUserEnabled($this->uid, $enabled, $queryDatabaseValue, $setDatabaseValue);
+            if ($oldStatus !== $enabled) {
+                $this->triggerChange('enabled', $enabled, $oldStatus);
+            }
+        } elseif ($oldStatus !== $enabled) {
+            $setDatabaseValue($enabled);
+            $this->triggerChange('enabled', $enabled, $oldStatus);
+        }
+    }
+
+    /**
+     * get the users email address
+     *
+     * @return string|null
+     * @since 9.0.0
+     */
+    public function getEMailAddress() {
+        return $this->getPrimaryEMailAddress() ?? $this->getSystemEMailAddress();
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function getSystemEMailAddress(): ?string {
+        return $this->config->getUserValue($this->uid, 'settings', 'email', null);
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function getPrimaryEMailAddress(): ?string {
+        return $this->config->getUserValue($this->uid, 'settings', 'primary_email', null);
+    }
+
+    /**
+     * get the users' quota
+     *
+     * @return string
+     * @since 9.0.0
+     */
+    public function getQuota() {
+        // allow apps to modify the user quota by hooking into the event
+        $event = new GetQuotaEvent($this);
+        $this->dispatcher->dispatchTyped($event);
+        $overwriteQuota = $event->getQuota();
+        if ($overwriteQuota) {
+            $quota = $overwriteQuota;
+        } else {
+            $quota = $this->config->getUserValue($this->uid, 'files', 'quota', 'default');
+        }
+        if ($quota === 'default') {
+            $quota = $this->config->getAppValue('files', 'default_quota', 'none');
+
+            // if unlimited quota is not allowed => avoid getting 'unlimited' as default_quota fallback value
+            // use the first preset instead
+            $allowUnlimitedQuota = $this->config->getAppValue('files', 'allow_unlimited_quota', '1') === '1';
+            if (!$allowUnlimitedQuota) {
+                $presets = $this->config->getAppValue('files', 'quota_preset', '1 GB, 5 GB, 10 GB');
+                $presets = array_filter(array_map('trim', explode(',', $presets)));
+                $quotaPreset = array_values(array_diff($presets, ['default', 'none']));
+                if (count($quotaPreset) > 0) {
+                    $quota = $this->config->getAppValue('files', 'default_quota', $quotaPreset[0]);
+                }
+            }
+        }
+        return $quota;
+    }
+
+    public function getQuotaBytes(): int|float {
+        $quota = $this->getQuota();
+        if ($quota === 'none') {
+            return \OCP\Files\FileInfo::SPACE_UNLIMITED;
+        }
+
+        $bytes = \OCP\Util::computerFileSize($quota);
+        if ($bytes === false) {
+            return \OCP\Files\FileInfo::SPACE_UNKNOWN;
+        }
+        return $bytes;
+    }
+
+    /**
+     * set the users' quota
+     *
+     * @param string $quota
+     * @return void
+     * @throws InvalidArgumentException
+     * @since 9.0.0
+     */
+    public function setQuota($quota) {
+        $oldQuota = $this->config->getUserValue($this->uid, 'files', 'quota', '');
+        if ($quota !== 'none' and $quota !== 'default') {
+            $bytesQuota = \OCP\Util::computerFileSize($quota);
+            if ($bytesQuota === false) {
+                throw new InvalidArgumentException('Failed to set quota to invalid value ' . $quota);
+            }
+            $quota = \OCP\Util::humanFileSize($bytesQuota);
+        }
+        if ($quota !== $oldQuota) {
+            $this->config->setUserValue($this->uid, 'files', 'quota', $quota);
+            $this->triggerChange('quota', $quota, $oldQuota);
+        }
+        \OC_Helper::clearStorageInfo('/' . $this->uid . '/files');
+    }
+
+    public function getManagerUids(): array {
+        $encodedUids = $this->config->getUserValue(
+            $this->uid,
+            'settings',
+            self::CONFIG_KEY_MANAGERS,
+            '[]'
+        );
+        return json_decode($encodedUids, false, 512, JSON_THROW_ON_ERROR);
+    }
+
+    public function setManagerUids(array $uids): void {
+        $oldUids = $this->getManagerUids();
+        $this->config->setUserValue(
+            $this->uid,
+            'settings',
+            self::CONFIG_KEY_MANAGERS,
+            json_encode($uids, JSON_THROW_ON_ERROR)
+        );
+        $this->triggerChange('managers', $uids, $oldUids);
+    }
+
+    /**
+     * get the avatar image if it exists
+     *
+     * @param int $size
+     * @return IImage|null
+     * @since 9.0.0
+     */
+    public function getAvatarImage($size) {
+        // delay the initialization
+        if (is_null($this->avatarManager)) {
+            $this->avatarManager = \OC::$server->get(IAvatarManager::class);
+        }
+
+        $avatar = $this->avatarManager->getAvatar($this->uid);
+        $image = $avatar->get($size);
+        if ($image) {
+            return $image;
+        }
+
+        return null;
+    }
+
+    /**
+     * get the federation cloud id
+     *
+     * @return string
+     * @since 9.0.0
+     */
+    public function getCloudId() {
+        $uid = $this->getUID();
+        $server = rtrim($this->urlGenerator->getAbsoluteURL('/'), '/');
+        if (str_ends_with($server, '/index.php')) {
+            $server = substr($server, 0, -10);
+        }
+        $server = $this->removeProtocolFromUrl($server);
+        return $uid . '@' . $server;
+    }
+
+    private function removeProtocolFromUrl(string $url): string {
+        if (str_starts_with($url, 'https://')) {
+            return substr($url, strlen('https://'));
+        }
+
+        return $url;
+    }
+
+    public function triggerChange($feature, $value = null, $oldValue = null) {
+        $this->dispatcher->dispatchTyped(new UserChangedEvent($this, $feature, $value, $oldValue));
+        if ($this->emitter) {
+            $this->emitter->emit('\OC\User', 'changeUser', [$this, $feature, $value, $oldValue]);
+        }
+    }
 }

Spacing +12 added lines, -12 removed lines

@@ -204,7 +204,7 @@ 
 	 */
 	public function getLastLogin(): int {
 		if ($this->lastLogin === null) {
-			$this->lastLogin = (int)$this->config->getUserValue($this->uid, 'login', 'lastLogin', 0);
+			$this->lastLogin = (int) $this->config->getUserValue($this->uid, 'login', 'lastLogin', 0);
 		}
 		return $this->lastLogin;
 	}
@@ -215,7 +215,7 @@ 
 	 */
 	public function getFirstLogin(): int {
 		if ($this->firstLogin === null) {
-			$this->firstLogin = (int)$this->config->getUserValue($this->uid, 'login', 'firstLogin', 0);
+			$this->firstLogin = (int) $this->config->getUserValue($this->uid, 'login', 'firstLogin', 0);
 		}
 		return $this->firstLogin;
 	}
@@ -231,7 +231,7 @@ 
 
 		if ($now - $previousLogin > 60) {
 			$this->lastLogin = $now;
-			$this->config->setUserValue($this->uid, 'login', 'lastLogin', (string)$this->lastLogin);
+			$this->config->setUserValue($this->uid, 'login', 'lastLogin', (string) $this->lastLogin);
 		}
 
 		if ($firstLogin === 0) {
@@ -241,7 +241,7 @@ 
 				/* Unknown first login, most likely was before upgrade to Nextcloud 31 */
 				$this->firstLogin = -1;
 			}
-			$this->config->setUserValue($this->uid, 'login', 'firstLogin', (string)$this->firstLogin);
+			$this->config->setUserValue($this->uid, 'login', 'firstLogin', (string) $this->firstLogin);
 		}
 
 		return $firstTimeLogin;
@@ -389,7 +389,7 @@ 
 			if (($this->backend instanceof IGetHomeBackend || $this->backend->implementsActions(Backend::GET_HOME)) && $home = $this->backend->getHome($this->uid)) {
 				$this->home = $home;
 			} else {
-				$this->home = $this->config->getSystemValueString('datadirectory', \OC::$SERVERROOT . '/data') . '/' . $this->uid;
+				$this->home = $this->config->getSystemValueString('datadirectory', \OC::$SERVERROOT.'/data').'/'.$this->uid;
 			}
 		}
 		return $this->home;
@@ -457,7 +457,7 @@ 
 	 * @return bool
 	 */
 	public function isEnabled() {
-		$queryDatabaseValue = function (): bool {
+		$queryDatabaseValue = function(): bool {
 			if ($this->enabled === null) {
 				$enabled = $this->config->getUserValue($this->uid, 'core', 'enabled', 'true');
 				$this->enabled = $enabled === 'true';
@@ -478,12 +478,12 @@ 
 	 */
 	public function setEnabled(bool $enabled = true) {
 		$oldStatus = $this->isEnabled();
-		$setDatabaseValue = function (bool $enabled): void {
+		$setDatabaseValue = function(bool $enabled): void {
 			$this->config->setUserValue($this->uid, 'core', 'enabled', $enabled ? 'true' : 'false');
 			$this->enabled = $enabled;
 		};
 		if ($this->backend instanceof IProvideEnabledStateBackend) {
-			$queryDatabaseValue = function (): bool {
+			$queryDatabaseValue = function(): bool {
 				if ($this->enabled === null) {
 					$enabled = $this->config->getUserValue($this->uid, 'core', 'enabled', 'true');
 					$this->enabled = $enabled === 'true';
@@ -558,7 +558,7 @@ 
 		return $quota;
 	}
 
-	public function getQuotaBytes(): int|float {
+	public function getQuotaBytes(): int | float {
 		$quota = $this->getQuota();
 		if ($quota === 'none') {
 			return \OCP\Files\FileInfo::SPACE_UNLIMITED;
@@ -584,7 +584,7 @@ 
 		if ($quota !== 'none' and $quota !== 'default') {
 			$bytesQuota = \OCP\Util::computerFileSize($quota);
 			if ($bytesQuota === false) {
-				throw new InvalidArgumentException('Failed to set quota to invalid value ' . $quota);
+				throw new InvalidArgumentException('Failed to set quota to invalid value '.$quota);
 			}
 			$quota = \OCP\Util::humanFileSize($bytesQuota);
 		}
@@ -592,7 +592,7 @@ 
 			$this->config->setUserValue($this->uid, 'files', 'quota', $quota);
 			$this->triggerChange('quota', $quota, $oldQuota);
 		}
-		\OC_Helper::clearStorageInfo('/' . $this->uid . '/files');
+		\OC_Helper::clearStorageInfo('/'.$this->uid.'/files');
 	}
 
 	public function getManagerUids(): array {
@@ -651,7 +651,7 @@ 
 			$server = substr($server, 0, -10);
 		}
 		$server = $this->removeProtocolFromUrl($server);
-		return $uid . '@' . $server;
+		return $uid.'@'.$server;
 	}
 
 	private function removeProtocolFromUrl(string $url): string {

lib/private/Files/SetupManager.php

Indentation +542 added lines, -542 removed lines

@@ -55,548 +55,548 @@
 use Psr\Log\LoggerInterface;
 
 class SetupManager {
-	private bool $rootSetup = false;
-	// List of users for which at least one mount is setup
-	private array $setupUsers = [];
-	// List of users for which all mounts are setup
-	private array $setupUsersComplete = [];
-	/** @var array<string, string[]> */
-	private array $setupUserMountProviders = [];
-	private ICache $cache;
-	private bool $listeningForProviders;
-	private array $fullSetupRequired = [];
-	private bool $setupBuiltinWrappersDone = false;
-	private bool $forceFullSetup = false;
-
-	public function __construct(
-		private IEventLogger $eventLogger,
-		private MountProviderCollection $mountProviderCollection,
-		private IMountManager $mountManager,
-		private IUserManager $userManager,
-		private IEventDispatcher $eventDispatcher,
-		private IUserMountCache $userMountCache,
-		private ILockdownManager $lockdownManager,
-		private IUserSession $userSession,
-		ICacheFactory $cacheFactory,
-		private LoggerInterface $logger,
-		private IConfig $config,
-		private ShareDisableChecker $shareDisableChecker,
-	) {
-		$this->cache = $cacheFactory->createDistributed('setupmanager::');
-		$this->listeningForProviders = false;
-		$this->forceFullSetup = $this->config->getSystemValueBool('debug.force-full-fs-setup');
-
-		$this->setupListeners();
-	}
-
-	private function isSetupStarted(IUser $user): bool {
-		return in_array($user->getUID(), $this->setupUsers, true);
-	}
-
-	public function isSetupComplete(IUser $user): bool {
-		return in_array($user->getUID(), $this->setupUsersComplete, true);
-	}
-
-	private function setupBuiltinWrappers() {
-		if ($this->setupBuiltinWrappersDone) {
-			return;
-		}
-		$this->setupBuiltinWrappersDone = true;
-
-		// load all filesystem apps before, so no setup-hook gets lost
-		OC_App::loadApps(['filesystem']);
-		$prevLogging = Filesystem::logWarningWhenAddingStorageWrapper(false);
-
-		Filesystem::addStorageWrapper('mount_options', function ($mountPoint, IStorage $storage, IMountPoint $mount) {
-			if ($storage->instanceOfStorage(Common::class)) {
-				$options = array_merge($mount->getOptions(), ['mount_point' => $mountPoint]);
-				$storage->setMountOptions($options);
-			}
-			return $storage;
-		});
-
-		$reSharingEnabled = Share::isResharingAllowed();
-		$user = $this->userSession->getUser();
-		$sharingEnabledForUser = $user ? !$this->shareDisableChecker->sharingDisabledForUser($user->getUID()) : true;
-		Filesystem::addStorageWrapper(
-			'sharing_mask',
-			function ($mountPoint, IStorage $storage, IMountPoint $mount) use ($reSharingEnabled, $sharingEnabledForUser) {
-				$sharingEnabledForMount = $mount->getOption('enable_sharing', true);
-				$isShared = $mount instanceof ISharedMountPoint;
-				if (!$sharingEnabledForMount || !$sharingEnabledForUser || (!$reSharingEnabled && $isShared)) {
-					return new PermissionsMask([
-						'storage' => $storage,
-						'mask' => Constants::PERMISSION_ALL - Constants::PERMISSION_SHARE,
-					]);
-				}
-				return $storage;
-			}
-		);
-
-		// install storage availability wrapper, before most other wrappers
-		Filesystem::addStorageWrapper('oc_availability', function ($mountPoint, IStorage $storage, IMountPoint $mount) {
-			$externalMount = $mount instanceof ExternalMountPoint || $mount instanceof Mount;
-			if ($externalMount && !$storage->isLocal()) {
-				return new Availability(['storage' => $storage]);
-			}
-			return $storage;
-		});
-
-		Filesystem::addStorageWrapper('oc_encoding', function ($mountPoint, IStorage $storage, IMountPoint $mount) {
-			if ($mount->getOption('encoding_compatibility', false) && !$mount instanceof SharedMount) {
-				return new Encoding(['storage' => $storage]);
-			}
-			return $storage;
-		});
-
-		$quotaIncludeExternal = $this->config->getSystemValue('quota_include_external_storage', false);
-		Filesystem::addStorageWrapper('oc_quota', function ($mountPoint, $storage, IMountPoint $mount) use ($quotaIncludeExternal) {
-			// set up quota for home storages, even for other users
-			// which can happen when using sharing
-			if ($mount instanceof HomeMountPoint) {
-				$user = $mount->getUser();
-				return new Quota(['storage' => $storage, 'quotaCallback' => function () use ($user) {
-					return $user->getQuotaBytes();
-				}, 'root' => 'files', 'include_external_storage' => $quotaIncludeExternal]);
-			}
-
-			return $storage;
-		});
-
-		Filesystem::addStorageWrapper('readonly', function ($mountPoint, IStorage $storage, IMountPoint $mount) {
-			/*
+    private bool $rootSetup = false;
+    // List of users for which at least one mount is setup
+    private array $setupUsers = [];
+    // List of users for which all mounts are setup
+    private array $setupUsersComplete = [];
+    /** @var array<string, string[]> */
+    private array $setupUserMountProviders = [];
+    private ICache $cache;
+    private bool $listeningForProviders;
+    private array $fullSetupRequired = [];
+    private bool $setupBuiltinWrappersDone = false;
+    private bool $forceFullSetup = false;
+
+    public function __construct(
+        private IEventLogger $eventLogger,
+        private MountProviderCollection $mountProviderCollection,
+        private IMountManager $mountManager,
+        private IUserManager $userManager,
+        private IEventDispatcher $eventDispatcher,
+        private IUserMountCache $userMountCache,
+        private ILockdownManager $lockdownManager,
+        private IUserSession $userSession,
+        ICacheFactory $cacheFactory,
+        private LoggerInterface $logger,
+        private IConfig $config,
+        private ShareDisableChecker $shareDisableChecker,
+    ) {
+        $this->cache = $cacheFactory->createDistributed('setupmanager::');
+        $this->listeningForProviders = false;
+        $this->forceFullSetup = $this->config->getSystemValueBool('debug.force-full-fs-setup');
+
+        $this->setupListeners();
+    }
+
+    private function isSetupStarted(IUser $user): bool {
+        return in_array($user->getUID(), $this->setupUsers, true);
+    }
+
+    public function isSetupComplete(IUser $user): bool {
+        return in_array($user->getUID(), $this->setupUsersComplete, true);
+    }
+
+    private function setupBuiltinWrappers() {
+        if ($this->setupBuiltinWrappersDone) {
+            return;
+        }
+        $this->setupBuiltinWrappersDone = true;
+
+        // load all filesystem apps before, so no setup-hook gets lost
+        OC_App::loadApps(['filesystem']);
+        $prevLogging = Filesystem::logWarningWhenAddingStorageWrapper(false);
+
+        Filesystem::addStorageWrapper('mount_options', function ($mountPoint, IStorage $storage, IMountPoint $mount) {
+            if ($storage->instanceOfStorage(Common::class)) {
+                $options = array_merge($mount->getOptions(), ['mount_point' => $mountPoint]);
+                $storage->setMountOptions($options);
+            }
+            return $storage;
+        });
+
+        $reSharingEnabled = Share::isResharingAllowed();
+        $user = $this->userSession->getUser();
+        $sharingEnabledForUser = $user ? !$this->shareDisableChecker->sharingDisabledForUser($user->getUID()) : true;
+        Filesystem::addStorageWrapper(
+            'sharing_mask',
+            function ($mountPoint, IStorage $storage, IMountPoint $mount) use ($reSharingEnabled, $sharingEnabledForUser) {
+                $sharingEnabledForMount = $mount->getOption('enable_sharing', true);
+                $isShared = $mount instanceof ISharedMountPoint;
+                if (!$sharingEnabledForMount || !$sharingEnabledForUser || (!$reSharingEnabled && $isShared)) {
+                    return new PermissionsMask([
+                        'storage' => $storage,
+                        'mask' => Constants::PERMISSION_ALL - Constants::PERMISSION_SHARE,
+                    ]);
+                }
+                return $storage;
+            }
+        );
+
+        // install storage availability wrapper, before most other wrappers
+        Filesystem::addStorageWrapper('oc_availability', function ($mountPoint, IStorage $storage, IMountPoint $mount) {
+            $externalMount = $mount instanceof ExternalMountPoint || $mount instanceof Mount;
+            if ($externalMount && !$storage->isLocal()) {
+                return new Availability(['storage' => $storage]);
+            }
+            return $storage;
+        });
+
+        Filesystem::addStorageWrapper('oc_encoding', function ($mountPoint, IStorage $storage, IMountPoint $mount) {
+            if ($mount->getOption('encoding_compatibility', false) && !$mount instanceof SharedMount) {
+                return new Encoding(['storage' => $storage]);
+            }
+            return $storage;
+        });
+
+        $quotaIncludeExternal = $this->config->getSystemValue('quota_include_external_storage', false);
+        Filesystem::addStorageWrapper('oc_quota', function ($mountPoint, $storage, IMountPoint $mount) use ($quotaIncludeExternal) {
+            // set up quota for home storages, even for other users
+            // which can happen when using sharing
+            if ($mount instanceof HomeMountPoint) {
+                $user = $mount->getUser();
+                return new Quota(['storage' => $storage, 'quotaCallback' => function () use ($user) {
+                    return $user->getQuotaBytes();
+                }, 'root' => 'files', 'include_external_storage' => $quotaIncludeExternal]);
+            }
+
+            return $storage;
+        });
+
+        Filesystem::addStorageWrapper('readonly', function ($mountPoint, IStorage $storage, IMountPoint $mount) {
+            /*
 			 * Do not allow any operations that modify the storage
 			 */
-			if ($mount->getOption('readonly', false)) {
-				return new PermissionsMask([
-					'storage' => $storage,
-					'mask' => Constants::PERMISSION_ALL & ~(
-						Constants::PERMISSION_UPDATE |
-						Constants::PERMISSION_CREATE |
-						Constants::PERMISSION_DELETE
-					),
-				]);
-			}
-			return $storage;
-		});
-
-		Filesystem::logWarningWhenAddingStorageWrapper($prevLogging);
-	}
-
-	/**
-	 * Setup the full filesystem for the specified user
-	 */
-	public function setupForUser(IUser $user): void {
-		if ($this->isSetupComplete($user)) {
-			return;
-		}
-		$this->setupUsersComplete[] = $user->getUID();
-
-		$this->eventLogger->start('fs:setup:user:full', 'Setup full filesystem for user');
-
-		if (!isset($this->setupUserMountProviders[$user->getUID()])) {
-			$this->setupUserMountProviders[$user->getUID()] = [];
-		}
-
-		$previouslySetupProviders = $this->setupUserMountProviders[$user->getUID()];
-
-		$this->setupForUserWith($user, function () use ($user) {
-			$this->mountProviderCollection->addMountForUser($user, $this->mountManager, function (
-				IMountProvider $provider,
-			) use ($user) {
-				return !in_array(get_class($provider), $this->setupUserMountProviders[$user->getUID()]);
-			});
-		});
-		$this->afterUserFullySetup($user, $previouslySetupProviders);
-		$this->eventLogger->end('fs:setup:user:full');
-	}
-
-	/**
-	 * part of the user setup that is run only once per user
-	 */
-	private function oneTimeUserSetup(IUser $user) {
-		if ($this->isSetupStarted($user)) {
-			return;
-		}
-		$this->setupUsers[] = $user->getUID();
-
-		$this->setupRoot();
-
-		$this->eventLogger->start('fs:setup:user:onetime', 'Onetime filesystem for user');
-
-		$this->setupBuiltinWrappers();
-
-		$prevLogging = Filesystem::logWarningWhenAddingStorageWrapper(false);
-
-		// TODO remove hook
-		OC_Hook::emit('OC_Filesystem', 'preSetup', ['user' => $user->getUID()]);
-
-		$event = new BeforeFileSystemSetupEvent($user);
-		$this->eventDispatcher->dispatchTyped($event);
-
-		Filesystem::logWarningWhenAddingStorageWrapper($prevLogging);
-
-		$userDir = '/' . $user->getUID() . '/files';
-
-		Filesystem::initInternal($userDir);
-
-		if ($this->lockdownManager->canAccessFilesystem()) {
-			$this->eventLogger->start('fs:setup:user:home', 'Setup home filesystem for user');
-			// home mounts are handled separate since we need to ensure this is mounted before we call the other mount providers
-			$homeMount = $this->mountProviderCollection->getHomeMountForUser($user);
-			$this->mountManager->addMount($homeMount);
-
-			if ($homeMount->getStorageRootId() === -1) {
-				$this->eventLogger->start('fs:setup:user:home:scan', 'Scan home filesystem for user');
-				$homeMount->getStorage()->mkdir('');
-				$homeMount->getStorage()->getScanner()->scan('');
-				$this->eventLogger->end('fs:setup:user:home:scan');
-			}
-			$this->eventLogger->end('fs:setup:user:home');
-		} else {
-			$this->mountManager->addMount(new MountPoint(
-				new NullStorage([]),
-				'/' . $user->getUID()
-			));
-			$this->mountManager->addMount(new MountPoint(
-				new NullStorage([]),
-				'/' . $user->getUID() . '/files'
-			));
-			$this->setupUsersComplete[] = $user->getUID();
-		}
-
-		$this->listenForNewMountProviders();
-
-		$this->eventLogger->end('fs:setup:user:onetime');
-	}
-
-	/**
-	 * Final housekeeping after a user has been fully setup
-	 */
-	private function afterUserFullySetup(IUser $user, array $previouslySetupProviders): void {
-		$this->eventLogger->start('fs:setup:user:full:post', 'Housekeeping after user is setup');
-		$userRoot = '/' . $user->getUID() . '/';
-		$mounts = $this->mountManager->getAll();
-		$mounts = array_filter($mounts, function (IMountPoint $mount) use ($userRoot) {
-			return str_starts_with($mount->getMountPoint(), $userRoot);
-		});
-		$allProviders = array_map(function (IMountProvider|IHomeMountProvider|IRootMountProvider $provider) {
-			return get_class($provider);
-		}, array_merge(
-			$this->mountProviderCollection->getProviders(),
-			$this->mountProviderCollection->getHomeProviders(),
-			$this->mountProviderCollection->getRootProviders(),
-		));
-		$newProviders = array_diff($allProviders, $previouslySetupProviders);
-		$mounts = array_filter($mounts, function (IMountPoint $mount) use ($previouslySetupProviders) {
-			return !in_array($mount->getMountProvider(), $previouslySetupProviders);
-		});
-		$this->userMountCache->registerMounts($user, $mounts, $newProviders);
-
-		$cacheDuration = $this->config->getSystemValueInt('fs_mount_cache_duration', 5 * 60);
-		if ($cacheDuration > 0) {
-			$this->cache->set($user->getUID(), true, $cacheDuration);
-			$this->fullSetupRequired[$user->getUID()] = false;
-		}
-		$this->eventLogger->end('fs:setup:user:full:post');
-	}
-
-	/**
-	 * @param IUser $user
-	 * @param IMountPoint $mounts
-	 * @return void
-	 * @throws \OCP\HintException
-	 * @throws \OC\ServerNotAvailableException
-	 */
-	private function setupForUserWith(IUser $user, callable $mountCallback): void {
-		$this->oneTimeUserSetup($user);
-
-		if ($this->lockdownManager->canAccessFilesystem()) {
-			$mountCallback();
-		}
-		$this->eventLogger->start('fs:setup:user:post-init-mountpoint', 'post_initMountPoints legacy hook');
-		\OC_Hook::emit('OC_Filesystem', 'post_initMountPoints', ['user' => $user->getUID()]);
-		$this->eventLogger->end('fs:setup:user:post-init-mountpoint');
-
-		$userDir = '/' . $user->getUID() . '/files';
-		$this->eventLogger->start('fs:setup:user:setup-hook', 'setup legacy hook');
-		OC_Hook::emit('OC_Filesystem', 'setup', ['user' => $user->getUID(), 'user_dir' => $userDir]);
-		$this->eventLogger->end('fs:setup:user:setup-hook');
-	}
-
-	/**
-	 * Set up the root filesystem
-	 */
-	public function setupRoot(): void {
-		//setting up the filesystem twice can only lead to trouble
-		if ($this->rootSetup) {
-			return;
-		}
-
-		$this->setupBuiltinWrappers();
-
-		$this->rootSetup = true;
-
-		$this->eventLogger->start('fs:setup:root', 'Setup root filesystem');
-
-		$rootMounts = $this->mountProviderCollection->getRootMounts();
-		foreach ($rootMounts as $rootMountProvider) {
-			$this->mountManager->addMount($rootMountProvider);
-		}
-
-		$this->eventLogger->end('fs:setup:root');
-	}
-
-	/**
-	 * Get the user to setup for a path or `null` if the root needs to be setup
-	 *
-	 * @param string $path
-	 * @return IUser|null
-	 */
-	private function getUserForPath(string $path) {
-		if (str_starts_with($path, '/__groupfolders')) {
-			return null;
-		} elseif (substr_count($path, '/') < 2) {
-			if ($user = $this->userSession->getUser()) {
-				return $user;
-			} else {
-				return null;
-			}
-		} elseif (str_starts_with($path, '/appdata_' . \OC_Util::getInstanceId()) || str_starts_with($path, '/files_external/')) {
-			return null;
-		} else {
-			[, $userId] = explode('/', $path);
-		}
-
-		return $this->userManager->get($userId);
-	}
-
-	/**
-	 * Set up the filesystem for the specified path
-	 */
-	public function setupForPath(string $path, bool $includeChildren = false): void {
-		$user = $this->getUserForPath($path);
-		if (!$user) {
-			$this->setupRoot();
-			return;
-		}
-
-		if ($this->isSetupComplete($user)) {
-			return;
-		}
-
-		if ($this->fullSetupRequired($user)) {
-			$this->setupForUser($user);
-			return;
-		}
-
-		// for the user's home folder, and includes children we need everything always
-		if (rtrim($path) === '/' . $user->getUID() . '/files' && $includeChildren) {
-			$this->setupForUser($user);
-			return;
-		}
-
-		if (!isset($this->setupUserMountProviders[$user->getUID()])) {
-			$this->setupUserMountProviders[$user->getUID()] = [];
-		}
-		$setupProviders = &$this->setupUserMountProviders[$user->getUID()];
-		$currentProviders = [];
-
-		try {
-			$cachedMount = $this->userMountCache->getMountForPath($user, $path);
-		} catch (NotFoundException $e) {
-			$this->setupForUser($user);
-			return;
-		}
-
-		$this->oneTimeUserSetup($user);
-
-		$this->eventLogger->start('fs:setup:user:path', "Setup $path filesystem for user");
-		$this->eventLogger->start('fs:setup:user:path:find', "Find mountpoint for $path");
-
-		$mounts = [];
-		if (!in_array($cachedMount->getMountProvider(), $setupProviders)) {
-			$currentProviders[] = $cachedMount->getMountProvider();
-			if ($cachedMount->getMountProvider()) {
-				$setupProviders[] = $cachedMount->getMountProvider();
-				$mounts = $this->mountProviderCollection->getUserMountsForProviderClasses($user, [$cachedMount->getMountProvider()]);
-			} else {
-				$this->logger->debug('mount at ' . $cachedMount->getMountPoint() . ' has no provider set, performing full setup');
-				$this->eventLogger->end('fs:setup:user:path:find');
-				$this->setupForUser($user);
-				$this->eventLogger->end('fs:setup:user:path');
-				return;
-			}
-		}
-
-		if ($includeChildren) {
-			$subCachedMounts = $this->userMountCache->getMountsInPath($user, $path);
-			$this->eventLogger->end('fs:setup:user:path:find');
-
-			$needsFullSetup = array_reduce($subCachedMounts, function (bool $needsFullSetup, ICachedMountInfo $cachedMountInfo) {
-				return $needsFullSetup || $cachedMountInfo->getMountProvider() === '';
-			}, false);
-
-			if ($needsFullSetup) {
-				$this->logger->debug('mount has no provider set, performing full setup');
-				$this->setupForUser($user);
-				$this->eventLogger->end('fs:setup:user:path');
-				return;
-			} else {
-				foreach ($subCachedMounts as $cachedMount) {
-					if (!in_array($cachedMount->getMountProvider(), $setupProviders)) {
-						$currentProviders[] = $cachedMount->getMountProvider();
-						$setupProviders[] = $cachedMount->getMountProvider();
-						$mounts = array_merge($mounts, $this->mountProviderCollection->getUserMountsForProviderClasses($user, [$cachedMount->getMountProvider()]));
-					}
-				}
-			}
-		} else {
-			$this->eventLogger->end('fs:setup:user:path:find');
-		}
-
-		if (count($mounts)) {
-			$this->userMountCache->registerMounts($user, $mounts, $currentProviders);
-			$this->setupForUserWith($user, function () use ($mounts) {
-				array_walk($mounts, [$this->mountManager, 'addMount']);
-			});
-		} elseif (!$this->isSetupStarted($user)) {
-			$this->oneTimeUserSetup($user);
-		}
-		$this->eventLogger->end('fs:setup:user:path');
-	}
-
-	private function fullSetupRequired(IUser $user): bool {
-		if ($this->forceFullSetup) {
-			return true;
-		}
-
-		// we perform a "cached" setup only after having done the full setup recently
-		// this is also used to trigger a full setup after handling events that are likely
-		// to change the available mounts
-		if (!isset($this->fullSetupRequired[$user->getUID()])) {
-			$this->fullSetupRequired[$user->getUID()] = !$this->cache->get($user->getUID());
-		}
-		return $this->fullSetupRequired[$user->getUID()];
-	}
-
-	/**
-	 * @param string $path
-	 * @param string[] $providers
-	 */
-	public function setupForProvider(string $path, array $providers): void {
-		$user = $this->getUserForPath($path);
-		if (!$user) {
-			$this->setupRoot();
-			return;
-		}
-
-		if ($this->isSetupComplete($user)) {
-			return;
-		}
-
-		if ($this->fullSetupRequired($user)) {
-			$this->setupForUser($user);
-			return;
-		}
-
-		$this->eventLogger->start('fs:setup:user:providers', 'Setup filesystem for ' . implode(', ', $providers));
-
-		$this->oneTimeUserSetup($user);
-
-		// home providers are always used
-		$providers = array_filter($providers, function (string $provider) {
-			return !is_subclass_of($provider, IHomeMountProvider::class);
-		});
-
-		if (in_array('', $providers)) {
-			$this->setupForUser($user);
-			return;
-		}
-		$setupProviders = $this->setupUserMountProviders[$user->getUID()] ?? [];
-
-		$providers = array_diff($providers, $setupProviders);
-		if (count($providers) === 0) {
-			if (!$this->isSetupStarted($user)) {
-				$this->oneTimeUserSetup($user);
-			}
-			$this->eventLogger->end('fs:setup:user:providers');
-			return;
-		} else {
-			$this->setupUserMountProviders[$user->getUID()] = array_merge($setupProviders, $providers);
-			$mounts = $this->mountProviderCollection->getUserMountsForProviderClasses($user, $providers);
-		}
-
-		$this->userMountCache->registerMounts($user, $mounts, $providers);
-		$this->setupForUserWith($user, function () use ($mounts) {
-			array_walk($mounts, [$this->mountManager, 'addMount']);
-		});
-		$this->eventLogger->end('fs:setup:user:providers');
-	}
-
-	public function tearDown() {
-		$this->setupUsers = [];
-		$this->setupUsersComplete = [];
-		$this->setupUserMountProviders = [];
-		$this->fullSetupRequired = [];
-		$this->rootSetup = false;
-		$this->mountManager->clear();
-		$this->eventDispatcher->dispatchTyped(new FilesystemTornDownEvent());
-	}
-
-	/**
-	 * Get mounts from mount providers that are registered after setup
-	 */
-	private function listenForNewMountProviders() {
-		if (!$this->listeningForProviders) {
-			$this->listeningForProviders = true;
-			$this->mountProviderCollection->listen('\OC\Files\Config', 'registerMountProvider', function (
-				IMountProvider $provider,
-			) {
-				foreach ($this->setupUsers as $userId) {
-					$user = $this->userManager->get($userId);
-					if ($user) {
-						$mounts = $provider->getMountsForUser($user, Filesystem::getLoader());
-						array_walk($mounts, [$this->mountManager, 'addMount']);
-					}
-				}
-			});
-		}
-	}
-
-	private function setupListeners() {
-		// note that this event handling is intentionally pessimistic
-		// clearing the cache to often is better than not enough
-
-		$this->eventDispatcher->addListener(UserAddedEvent::class, function (UserAddedEvent $event) {
-			$this->cache->remove($event->getUser()->getUID());
-		});
-		$this->eventDispatcher->addListener(UserRemovedEvent::class, function (UserRemovedEvent $event) {
-			$this->cache->remove($event->getUser()->getUID());
-		});
-		$this->eventDispatcher->addListener(ShareCreatedEvent::class, function (ShareCreatedEvent $event) {
-			$this->cache->remove($event->getShare()->getSharedWith());
-		});
-		$this->eventDispatcher->addListener(InvalidateMountCacheEvent::class, function (InvalidateMountCacheEvent $event,
-		) {
-			if ($user = $event->getUser()) {
-				$this->cache->remove($user->getUID());
-			} else {
-				$this->cache->clear();
-			}
-		});
-
-		$genericEvents = [
-			'OCA\Circles\Events\CreatingCircleEvent',
-			'OCA\Circles\Events\DestroyingCircleEvent',
-			'OCA\Circles\Events\AddingCircleMemberEvent',
-			'OCA\Circles\Events\RemovingCircleMemberEvent',
-		];
-
-		foreach ($genericEvents as $genericEvent) {
-			$this->eventDispatcher->addListener($genericEvent, function ($event) {
-				$this->cache->clear();
-			});
-		}
-	}
+            if ($mount->getOption('readonly', false)) {
+                return new PermissionsMask([
+                    'storage' => $storage,
+                    'mask' => Constants::PERMISSION_ALL & ~(
+                        Constants::PERMISSION_UPDATE |
+                        Constants::PERMISSION_CREATE |
+                        Constants::PERMISSION_DELETE
+                    ),
+                ]);
+            }
+            return $storage;
+        });
+
+        Filesystem::logWarningWhenAddingStorageWrapper($prevLogging);
+    }
+
+    /**
+     * Setup the full filesystem for the specified user
+     */
+    public function setupForUser(IUser $user): void {
+        if ($this->isSetupComplete($user)) {
+            return;
+        }
+        $this->setupUsersComplete[] = $user->getUID();
+
+        $this->eventLogger->start('fs:setup:user:full', 'Setup full filesystem for user');
+
+        if (!isset($this->setupUserMountProviders[$user->getUID()])) {
+            $this->setupUserMountProviders[$user->getUID()] = [];
+        }
+
+        $previouslySetupProviders = $this->setupUserMountProviders[$user->getUID()];
+
+        $this->setupForUserWith($user, function () use ($user) {
+            $this->mountProviderCollection->addMountForUser($user, $this->mountManager, function (
+                IMountProvider $provider,
+            ) use ($user) {
+                return !in_array(get_class($provider), $this->setupUserMountProviders[$user->getUID()]);
+            });
+        });
+        $this->afterUserFullySetup($user, $previouslySetupProviders);
+        $this->eventLogger->end('fs:setup:user:full');
+    }
+
+    /**
+     * part of the user setup that is run only once per user
+     */
+    private function oneTimeUserSetup(IUser $user) {
+        if ($this->isSetupStarted($user)) {
+            return;
+        }
+        $this->setupUsers[] = $user->getUID();
+
+        $this->setupRoot();
+
+        $this->eventLogger->start('fs:setup:user:onetime', 'Onetime filesystem for user');
+
+        $this->setupBuiltinWrappers();
+
+        $prevLogging = Filesystem::logWarningWhenAddingStorageWrapper(false);
+
+        // TODO remove hook
+        OC_Hook::emit('OC_Filesystem', 'preSetup', ['user' => $user->getUID()]);
+
+        $event = new BeforeFileSystemSetupEvent($user);
+        $this->eventDispatcher->dispatchTyped($event);
+
+        Filesystem::logWarningWhenAddingStorageWrapper($prevLogging);
+
+        $userDir = '/' . $user->getUID() . '/files';
+
+        Filesystem::initInternal($userDir);
+
+        if ($this->lockdownManager->canAccessFilesystem()) {
+            $this->eventLogger->start('fs:setup:user:home', 'Setup home filesystem for user');
+            // home mounts are handled separate since we need to ensure this is mounted before we call the other mount providers
+            $homeMount = $this->mountProviderCollection->getHomeMountForUser($user);
+            $this->mountManager->addMount($homeMount);
+
+            if ($homeMount->getStorageRootId() === -1) {
+                $this->eventLogger->start('fs:setup:user:home:scan', 'Scan home filesystem for user');
+                $homeMount->getStorage()->mkdir('');
+                $homeMount->getStorage()->getScanner()->scan('');
+                $this->eventLogger->end('fs:setup:user:home:scan');
+            }
+            $this->eventLogger->end('fs:setup:user:home');
+        } else {
+            $this->mountManager->addMount(new MountPoint(
+                new NullStorage([]),
+                '/' . $user->getUID()
+            ));
+            $this->mountManager->addMount(new MountPoint(
+                new NullStorage([]),
+                '/' . $user->getUID() . '/files'
+            ));
+            $this->setupUsersComplete[] = $user->getUID();
+        }
+
+        $this->listenForNewMountProviders();
+
+        $this->eventLogger->end('fs:setup:user:onetime');
+    }
+
+    /**
+     * Final housekeeping after a user has been fully setup
+     */
+    private function afterUserFullySetup(IUser $user, array $previouslySetupProviders): void {
+        $this->eventLogger->start('fs:setup:user:full:post', 'Housekeeping after user is setup');
+        $userRoot = '/' . $user->getUID() . '/';
+        $mounts = $this->mountManager->getAll();
+        $mounts = array_filter($mounts, function (IMountPoint $mount) use ($userRoot) {
+            return str_starts_with($mount->getMountPoint(), $userRoot);
+        });
+        $allProviders = array_map(function (IMountProvider|IHomeMountProvider|IRootMountProvider $provider) {
+            return get_class($provider);
+        }, array_merge(
+            $this->mountProviderCollection->getProviders(),
+            $this->mountProviderCollection->getHomeProviders(),
+            $this->mountProviderCollection->getRootProviders(),
+        ));
+        $newProviders = array_diff($allProviders, $previouslySetupProviders);
+        $mounts = array_filter($mounts, function (IMountPoint $mount) use ($previouslySetupProviders) {
+            return !in_array($mount->getMountProvider(), $previouslySetupProviders);
+        });
+        $this->userMountCache->registerMounts($user, $mounts, $newProviders);
+
+        $cacheDuration = $this->config->getSystemValueInt('fs_mount_cache_duration', 5 * 60);
+        if ($cacheDuration > 0) {
+            $this->cache->set($user->getUID(), true, $cacheDuration);
+            $this->fullSetupRequired[$user->getUID()] = false;
+        }
+        $this->eventLogger->end('fs:setup:user:full:post');
+    }
+
+    /**
+     * @param IUser $user
+     * @param IMountPoint $mounts
+     * @return void
+     * @throws \OCP\HintException
+     * @throws \OC\ServerNotAvailableException
+     */
+    private function setupForUserWith(IUser $user, callable $mountCallback): void {
+        $this->oneTimeUserSetup($user);
+
+        if ($this->lockdownManager->canAccessFilesystem()) {
+            $mountCallback();
+        }
+        $this->eventLogger->start('fs:setup:user:post-init-mountpoint', 'post_initMountPoints legacy hook');
+        \OC_Hook::emit('OC_Filesystem', 'post_initMountPoints', ['user' => $user->getUID()]);
+        $this->eventLogger->end('fs:setup:user:post-init-mountpoint');
+
+        $userDir = '/' . $user->getUID() . '/files';
+        $this->eventLogger->start('fs:setup:user:setup-hook', 'setup legacy hook');
+        OC_Hook::emit('OC_Filesystem', 'setup', ['user' => $user->getUID(), 'user_dir' => $userDir]);
+        $this->eventLogger->end('fs:setup:user:setup-hook');
+    }
+
+    /**
+     * Set up the root filesystem
+     */
+    public function setupRoot(): void {
+        //setting up the filesystem twice can only lead to trouble
+        if ($this->rootSetup) {
+            return;
+        }
+
+        $this->setupBuiltinWrappers();
+
+        $this->rootSetup = true;
+
+        $this->eventLogger->start('fs:setup:root', 'Setup root filesystem');
+
+        $rootMounts = $this->mountProviderCollection->getRootMounts();
+        foreach ($rootMounts as $rootMountProvider) {
+            $this->mountManager->addMount($rootMountProvider);
+        }
+
+        $this->eventLogger->end('fs:setup:root');
+    }
+
+    /**
+     * Get the user to setup for a path or `null` if the root needs to be setup
+     *
+     * @param string $path
+     * @return IUser|null
+     */
+    private function getUserForPath(string $path) {
+        if (str_starts_with($path, '/__groupfolders')) {
+            return null;
+        } elseif (substr_count($path, '/') < 2) {
+            if ($user = $this->userSession->getUser()) {
+                return $user;
+            } else {
+                return null;
+            }
+        } elseif (str_starts_with($path, '/appdata_' . \OC_Util::getInstanceId()) || str_starts_with($path, '/files_external/')) {
+            return null;
+        } else {
+            [, $userId] = explode('/', $path);
+        }
+
+        return $this->userManager->get($userId);
+    }
+
+    /**
+     * Set up the filesystem for the specified path
+     */
+    public function setupForPath(string $path, bool $includeChildren = false): void {
+        $user = $this->getUserForPath($path);
+        if (!$user) {
+            $this->setupRoot();
+            return;
+        }
+
+        if ($this->isSetupComplete($user)) {
+            return;
+        }
+
+        if ($this->fullSetupRequired($user)) {
+            $this->setupForUser($user);
+            return;
+        }
+
+        // for the user's home folder, and includes children we need everything always
+        if (rtrim($path) === '/' . $user->getUID() . '/files' && $includeChildren) {
+            $this->setupForUser($user);
+            return;
+        }
+
+        if (!isset($this->setupUserMountProviders[$user->getUID()])) {
+            $this->setupUserMountProviders[$user->getUID()] = [];
+        }
+        $setupProviders = &$this->setupUserMountProviders[$user->getUID()];
+        $currentProviders = [];
+
+        try {
+            $cachedMount = $this->userMountCache->getMountForPath($user, $path);
+        } catch (NotFoundException $e) {
+            $this->setupForUser($user);
+            return;
+        }
+
+        $this->oneTimeUserSetup($user);
+
+        $this->eventLogger->start('fs:setup:user:path', "Setup $path filesystem for user");
+        $this->eventLogger->start('fs:setup:user:path:find', "Find mountpoint for $path");
+
+        $mounts = [];
+        if (!in_array($cachedMount->getMountProvider(), $setupProviders)) {
+            $currentProviders[] = $cachedMount->getMountProvider();
+            if ($cachedMount->getMountProvider()) {
+                $setupProviders[] = $cachedMount->getMountProvider();
+                $mounts = $this->mountProviderCollection->getUserMountsForProviderClasses($user, [$cachedMount->getMountProvider()]);
+            } else {
+                $this->logger->debug('mount at ' . $cachedMount->getMountPoint() . ' has no provider set, performing full setup');
+                $this->eventLogger->end('fs:setup:user:path:find');
+                $this->setupForUser($user);
+                $this->eventLogger->end('fs:setup:user:path');
+                return;
+            }
+        }
+
+        if ($includeChildren) {
+            $subCachedMounts = $this->userMountCache->getMountsInPath($user, $path);
+            $this->eventLogger->end('fs:setup:user:path:find');
+
+            $needsFullSetup = array_reduce($subCachedMounts, function (bool $needsFullSetup, ICachedMountInfo $cachedMountInfo) {
+                return $needsFullSetup || $cachedMountInfo->getMountProvider() === '';
+            }, false);
+
+            if ($needsFullSetup) {
+                $this->logger->debug('mount has no provider set, performing full setup');
+                $this->setupForUser($user);
+                $this->eventLogger->end('fs:setup:user:path');
+                return;
+            } else {
+                foreach ($subCachedMounts as $cachedMount) {
+                    if (!in_array($cachedMount->getMountProvider(), $setupProviders)) {
+                        $currentProviders[] = $cachedMount->getMountProvider();
+                        $setupProviders[] = $cachedMount->getMountProvider();
+                        $mounts = array_merge($mounts, $this->mountProviderCollection->getUserMountsForProviderClasses($user, [$cachedMount->getMountProvider()]));
+                    }
+                }
+            }
+        } else {
+            $this->eventLogger->end('fs:setup:user:path:find');
+        }
+
+        if (count($mounts)) {
+            $this->userMountCache->registerMounts($user, $mounts, $currentProviders);
+            $this->setupForUserWith($user, function () use ($mounts) {
+                array_walk($mounts, [$this->mountManager, 'addMount']);
+            });
+        } elseif (!$this->isSetupStarted($user)) {
+            $this->oneTimeUserSetup($user);
+        }
+        $this->eventLogger->end('fs:setup:user:path');
+    }
+
+    private function fullSetupRequired(IUser $user): bool {
+        if ($this->forceFullSetup) {
+            return true;
+        }
+
+        // we perform a "cached" setup only after having done the full setup recently
+        // this is also used to trigger a full setup after handling events that are likely
+        // to change the available mounts
+        if (!isset($this->fullSetupRequired[$user->getUID()])) {
+            $this->fullSetupRequired[$user->getUID()] = !$this->cache->get($user->getUID());
+        }
+        return $this->fullSetupRequired[$user->getUID()];
+    }
+
+    /**
+     * @param string $path
+     * @param string[] $providers
+     */
+    public function setupForProvider(string $path, array $providers): void {
+        $user = $this->getUserForPath($path);
+        if (!$user) {
+            $this->setupRoot();
+            return;
+        }
+
+        if ($this->isSetupComplete($user)) {
+            return;
+        }
+
+        if ($this->fullSetupRequired($user)) {
+            $this->setupForUser($user);
+            return;
+        }
+
+        $this->eventLogger->start('fs:setup:user:providers', 'Setup filesystem for ' . implode(', ', $providers));
+
+        $this->oneTimeUserSetup($user);
+
+        // home providers are always used
+        $providers = array_filter($providers, function (string $provider) {
+            return !is_subclass_of($provider, IHomeMountProvider::class);
+        });
+
+        if (in_array('', $providers)) {
+            $this->setupForUser($user);
+            return;
+        }
+        $setupProviders = $this->setupUserMountProviders[$user->getUID()] ?? [];
+
+        $providers = array_diff($providers, $setupProviders);
+        if (count($providers) === 0) {
+            if (!$this->isSetupStarted($user)) {
+                $this->oneTimeUserSetup($user);
+            }
+            $this->eventLogger->end('fs:setup:user:providers');
+            return;
+        } else {
+            $this->setupUserMountProviders[$user->getUID()] = array_merge($setupProviders, $providers);
+            $mounts = $this->mountProviderCollection->getUserMountsForProviderClasses($user, $providers);
+        }
+
+        $this->userMountCache->registerMounts($user, $mounts, $providers);
+        $this->setupForUserWith($user, function () use ($mounts) {
+            array_walk($mounts, [$this->mountManager, 'addMount']);
+        });
+        $this->eventLogger->end('fs:setup:user:providers');
+    }
+
+    public function tearDown() {
+        $this->setupUsers = [];
+        $this->setupUsersComplete = [];
+        $this->setupUserMountProviders = [];
+        $this->fullSetupRequired = [];
+        $this->rootSetup = false;
+        $this->mountManager->clear();
+        $this->eventDispatcher->dispatchTyped(new FilesystemTornDownEvent());
+    }
+
+    /**
+     * Get mounts from mount providers that are registered after setup
+     */
+    private function listenForNewMountProviders() {
+        if (!$this->listeningForProviders) {
+            $this->listeningForProviders = true;
+            $this->mountProviderCollection->listen('\OC\Files\Config', 'registerMountProvider', function (
+                IMountProvider $provider,
+            ) {
+                foreach ($this->setupUsers as $userId) {
+                    $user = $this->userManager->get($userId);
+                    if ($user) {
+                        $mounts = $provider->getMountsForUser($user, Filesystem::getLoader());
+                        array_walk($mounts, [$this->mountManager, 'addMount']);
+                    }
+                }
+            });
+        }
+    }
+
+    private function setupListeners() {
+        // note that this event handling is intentionally pessimistic
+        // clearing the cache to often is better than not enough
+
+        $this->eventDispatcher->addListener(UserAddedEvent::class, function (UserAddedEvent $event) {
+            $this->cache->remove($event->getUser()->getUID());
+        });
+        $this->eventDispatcher->addListener(UserRemovedEvent::class, function (UserRemovedEvent $event) {
+            $this->cache->remove($event->getUser()->getUID());
+        });
+        $this->eventDispatcher->addListener(ShareCreatedEvent::class, function (ShareCreatedEvent $event) {
+            $this->cache->remove($event->getShare()->getSharedWith());
+        });
+        $this->eventDispatcher->addListener(InvalidateMountCacheEvent::class, function (InvalidateMountCacheEvent $event,
+        ) {
+            if ($user = $event->getUser()) {
+                $this->cache->remove($user->getUID());
+            } else {
+                $this->cache->clear();
+            }
+        });
+
+        $genericEvents = [
+            'OCA\Circles\Events\CreatingCircleEvent',
+            'OCA\Circles\Events\DestroyingCircleEvent',
+            'OCA\Circles\Events\AddingCircleMemberEvent',
+            'OCA\Circles\Events\RemovingCircleMemberEvent',
+        ];
+
+        foreach ($genericEvents as $genericEvent) {
+            $this->eventDispatcher->addListener($genericEvent, function ($event) {
+                $this->cache->clear();
+            });
+        }
+    }
 }

Spacing +31 added lines, -31 removed lines

@@ -107,7 +107,7 @@ 
 		OC_App::loadApps(['filesystem']);
 		$prevLogging = Filesystem::logWarningWhenAddingStorageWrapper(false);
 
-		Filesystem::addStorageWrapper('mount_options', function ($mountPoint, IStorage $storage, IMountPoint $mount) {
+		Filesystem::addStorageWrapper('mount_options', function($mountPoint, IStorage $storage, IMountPoint $mount) {
 			if ($storage->instanceOfStorage(Common::class)) {
 				$options = array_merge($mount->getOptions(), ['mount_point' => $mountPoint]);
 				$storage->setMountOptions($options);
@@ -120,7 +120,7 @@ 
 		$sharingEnabledForUser = $user ? !$this->shareDisableChecker->sharingDisabledForUser($user->getUID()) : true;
 		Filesystem::addStorageWrapper(
 			'sharing_mask',
-			function ($mountPoint, IStorage $storage, IMountPoint $mount) use ($reSharingEnabled, $sharingEnabledForUser) {
+			function($mountPoint, IStorage $storage, IMountPoint $mount) use ($reSharingEnabled, $sharingEnabledForUser) {
 				$sharingEnabledForMount = $mount->getOption('enable_sharing', true);
 				$isShared = $mount instanceof ISharedMountPoint;
 				if (!$sharingEnabledForMount || !$sharingEnabledForUser || (!$reSharingEnabled && $isShared)) {
@@ -134,7 +134,7 @@ 
 		);
 
 		// install storage availability wrapper, before most other wrappers
-		Filesystem::addStorageWrapper('oc_availability', function ($mountPoint, IStorage $storage, IMountPoint $mount) {
+		Filesystem::addStorageWrapper('oc_availability', function($mountPoint, IStorage $storage, IMountPoint $mount) {
 			$externalMount = $mount instanceof ExternalMountPoint || $mount instanceof Mount;
 			if ($externalMount && !$storage->isLocal()) {
 				return new Availability(['storage' => $storage]);
@@ -142,7 +142,7 @@ 
 			return $storage;
 		});
 
-		Filesystem::addStorageWrapper('oc_encoding', function ($mountPoint, IStorage $storage, IMountPoint $mount) {
+		Filesystem::addStorageWrapper('oc_encoding', function($mountPoint, IStorage $storage, IMountPoint $mount) {
 			if ($mount->getOption('encoding_compatibility', false) && !$mount instanceof SharedMount) {
 				return new Encoding(['storage' => $storage]);
 			}
@@ -150,12 +150,12 @@ 
 		});
 
 		$quotaIncludeExternal = $this->config->getSystemValue('quota_include_external_storage', false);
-		Filesystem::addStorageWrapper('oc_quota', function ($mountPoint, $storage, IMountPoint $mount) use ($quotaIncludeExternal) {
+		Filesystem::addStorageWrapper('oc_quota', function($mountPoint, $storage, IMountPoint $mount) use ($quotaIncludeExternal) {
 			// set up quota for home storages, even for other users
 			// which can happen when using sharing
 			if ($mount instanceof HomeMountPoint) {
 				$user = $mount->getUser();
-				return new Quota(['storage' => $storage, 'quotaCallback' => function () use ($user) {
+				return new Quota(['storage' => $storage, 'quotaCallback' => function() use ($user) {
 					return $user->getQuotaBytes();
 				}, 'root' => 'files', 'include_external_storage' => $quotaIncludeExternal]);
 			}
@@ -163,7 +163,7 @@ 
 			return $storage;
 		});
 
-		Filesystem::addStorageWrapper('readonly', function ($mountPoint, IStorage $storage, IMountPoint $mount) {
+		Filesystem::addStorageWrapper('readonly', function($mountPoint, IStorage $storage, IMountPoint $mount) {
 			/*
 			 * Do not allow any operations that modify the storage
 			 */
@@ -200,8 +200,8 @@ 
 
 		$previouslySetupProviders = $this->setupUserMountProviders[$user->getUID()];
 
-		$this->setupForUserWith($user, function () use ($user) {
-			$this->mountProviderCollection->addMountForUser($user, $this->mountManager, function (
+		$this->setupForUserWith($user, function() use ($user) {
+			$this->mountProviderCollection->addMountForUser($user, $this->mountManager, function(
 				IMountProvider $provider,
 			) use ($user) {
 				return !in_array(get_class($provider), $this->setupUserMountProviders[$user->getUID()]);
@@ -236,7 +236,7 @@ 
 
 		Filesystem::logWarningWhenAddingStorageWrapper($prevLogging);
 
-		$userDir = '/' . $user->getUID() . '/files';
+		$userDir = '/'.$user->getUID().'/files';
 
 		Filesystem::initInternal($userDir);
 
@@ -256,11 +256,11 @@ 
 		} else {
 			$this->mountManager->addMount(new MountPoint(
 				new NullStorage([]),
-				'/' . $user->getUID()
+				'/'.$user->getUID()
 			));
 			$this->mountManager->addMount(new MountPoint(
 				new NullStorage([]),
-				'/' . $user->getUID() . '/files'
+				'/'.$user->getUID().'/files'
 			));
 			$this->setupUsersComplete[] = $user->getUID();
 		}
@@ -275,12 +275,12 @@ 
 	 */
 	private function afterUserFullySetup(IUser $user, array $previouslySetupProviders): void {
 		$this->eventLogger->start('fs:setup:user:full:post', 'Housekeeping after user is setup');
-		$userRoot = '/' . $user->getUID() . '/';
+		$userRoot = '/'.$user->getUID().'/';
 		$mounts = $this->mountManager->getAll();
-		$mounts = array_filter($mounts, function (IMountPoint $mount) use ($userRoot) {
+		$mounts = array_filter($mounts, function(IMountPoint $mount) use ($userRoot) {
 			return str_starts_with($mount->getMountPoint(), $userRoot);
 		});
-		$allProviders = array_map(function (IMountProvider|IHomeMountProvider|IRootMountProvider $provider) {
+		$allProviders = array_map(function(IMountProvider | IHomeMountProvider | IRootMountProvider $provider) {
 			return get_class($provider);
 		}, array_merge(
 			$this->mountProviderCollection->getProviders(),
@@ -288,7 +288,7 @@ 
 			$this->mountProviderCollection->getRootProviders(),
 		));
 		$newProviders = array_diff($allProviders, $previouslySetupProviders);
-		$mounts = array_filter($mounts, function (IMountPoint $mount) use ($previouslySetupProviders) {
+		$mounts = array_filter($mounts, function(IMountPoint $mount) use ($previouslySetupProviders) {
 			return !in_array($mount->getMountProvider(), $previouslySetupProviders);
 		});
 		$this->userMountCache->registerMounts($user, $mounts, $newProviders);
@@ -318,7 +318,7 @@ 
 		\OC_Hook::emit('OC_Filesystem', 'post_initMountPoints', ['user' => $user->getUID()]);
 		$this->eventLogger->end('fs:setup:user:post-init-mountpoint');
 
-		$userDir = '/' . $user->getUID() . '/files';
+		$userDir = '/'.$user->getUID().'/files';
 		$this->eventLogger->start('fs:setup:user:setup-hook', 'setup legacy hook');
 		OC_Hook::emit('OC_Filesystem', 'setup', ['user' => $user->getUID(), 'user_dir' => $userDir]);
 		$this->eventLogger->end('fs:setup:user:setup-hook');
@@ -362,7 +362,7 @@ 
 			} else {
 				return null;
 			}
-		} elseif (str_starts_with($path, '/appdata_' . \OC_Util::getInstanceId()) || str_starts_with($path, '/files_external/')) {
+		} elseif (str_starts_with($path, '/appdata_'.\OC_Util::getInstanceId()) || str_starts_with($path, '/files_external/')) {
 			return null;
 		} else {
 			[, $userId] = explode('/', $path);
@@ -391,7 +391,7 @@ 
 		}
 
 		// for the user's home folder, and includes children we need everything always
-		if (rtrim($path) === '/' . $user->getUID() . '/files' && $includeChildren) {
+		if (rtrim($path) === '/'.$user->getUID().'/files' && $includeChildren) {
 			$this->setupForUser($user);
 			return;
 		}
@@ -421,7 +421,7 @@ 
 				$setupProviders[] = $cachedMount->getMountProvider();
 				$mounts = $this->mountProviderCollection->getUserMountsForProviderClasses($user, [$cachedMount->getMountProvider()]);
 			} else {
-				$this->logger->debug('mount at ' . $cachedMount->getMountPoint() . ' has no provider set, performing full setup');
+				$this->logger->debug('mount at '.$cachedMount->getMountPoint().' has no provider set, performing full setup');
 				$this->eventLogger->end('fs:setup:user:path:find');
 				$this->setupForUser($user);
 				$this->eventLogger->end('fs:setup:user:path');
@@ -433,7 +433,7 @@ 
 			$subCachedMounts = $this->userMountCache->getMountsInPath($user, $path);
 			$this->eventLogger->end('fs:setup:user:path:find');
 
-			$needsFullSetup = array_reduce($subCachedMounts, function (bool $needsFullSetup, ICachedMountInfo $cachedMountInfo) {
+			$needsFullSetup = array_reduce($subCachedMounts, function(bool $needsFullSetup, ICachedMountInfo $cachedMountInfo) {
 				return $needsFullSetup || $cachedMountInfo->getMountProvider() === '';
 			}, false);
 
@@ -457,7 +457,7 @@ 
 
 		if (count($mounts)) {
 			$this->userMountCache->registerMounts($user, $mounts, $currentProviders);
-			$this->setupForUserWith($user, function () use ($mounts) {
+			$this->setupForUserWith($user, function() use ($mounts) {
 				array_walk($mounts, [$this->mountManager, 'addMount']);
 			});
 		} elseif (!$this->isSetupStarted($user)) {
@@ -500,12 +500,12 @@ 
 			return;
 		}
 
-		$this->eventLogger->start('fs:setup:user:providers', 'Setup filesystem for ' . implode(', ', $providers));
+		$this->eventLogger->start('fs:setup:user:providers', 'Setup filesystem for '.implode(', ', $providers));
 
 		$this->oneTimeUserSetup($user);
 
 		// home providers are always used
-		$providers = array_filter($providers, function (string $provider) {
+		$providers = array_filter($providers, function(string $provider) {
 			return !is_subclass_of($provider, IHomeMountProvider::class);
 		});
 
@@ -528,7 +528,7 @@ 
 		}
 
 		$this->userMountCache->registerMounts($user, $mounts, $providers);
-		$this->setupForUserWith($user, function () use ($mounts) {
+		$this->setupForUserWith($user, function() use ($mounts) {
 			array_walk($mounts, [$this->mountManager, 'addMount']);
 		});
 		$this->eventLogger->end('fs:setup:user:providers');
@@ -550,7 +550,7 @@ 
 	private function listenForNewMountProviders() {
 		if (!$this->listeningForProviders) {
 			$this->listeningForProviders = true;
-			$this->mountProviderCollection->listen('\OC\Files\Config', 'registerMountProvider', function (
+			$this->mountProviderCollection->listen('\OC\Files\Config', 'registerMountProvider', function(
 				IMountProvider $provider,
 			) {
 				foreach ($this->setupUsers as $userId) {
@@ -568,16 +568,16 @@ 
 		// note that this event handling is intentionally pessimistic
 		// clearing the cache to often is better than not enough
 
-		$this->eventDispatcher->addListener(UserAddedEvent::class, function (UserAddedEvent $event) {
+		$this->eventDispatcher->addListener(UserAddedEvent::class, function(UserAddedEvent $event) {
 			$this->cache->remove($event->getUser()->getUID());
 		});
-		$this->eventDispatcher->addListener(UserRemovedEvent::class, function (UserRemovedEvent $event) {
+		$this->eventDispatcher->addListener(UserRemovedEvent::class, function(UserRemovedEvent $event) {
 			$this->cache->remove($event->getUser()->getUID());
 		});
-		$this->eventDispatcher->addListener(ShareCreatedEvent::class, function (ShareCreatedEvent $event) {
+		$this->eventDispatcher->addListener(ShareCreatedEvent::class, function(ShareCreatedEvent $event) {
 			$this->cache->remove($event->getShare()->getSharedWith());
 		});
-		$this->eventDispatcher->addListener(InvalidateMountCacheEvent::class, function (InvalidateMountCacheEvent $event,
+		$this->eventDispatcher->addListener(InvalidateMountCacheEvent::class, function(InvalidateMountCacheEvent $event,
 		) {
 			if ($user = $event->getUser()) {
 				$this->cache->remove($user->getUID());
@@ -594,7 +594,7 @@ 
 		];
 
 		foreach ($genericEvents as $genericEvent) {
-			$this->eventDispatcher->addListener($genericEvent, function ($event) {
+			$this->eventDispatcher->addListener($genericEvent, function($event) {
 				$this->cache->clear();
 			});
 		}

tests/lib/User/UserTest.php

Indentation +996 added lines, -996 removed lines

@@ -34,1000 +34,1000 @@
  * @package Test\User
  */
 class UserTest extends TestCase {
-	/** @var IEventDispatcher|MockObject */
-	protected $dispatcher;
-
-	protected function setUp(): void {
-		parent::setUp();
-		$this->dispatcher = Server::get(IEventDispatcher::class);
-	}
-
-	public function testDisplayName(): void {
-		/**
-		 * @var \OC\User\Backend | MockObject $backend
-		 */
-		$backend = $this->createMock(\OC\User\Backend::class);
-		$backend->expects($this->once())
-			->method('getDisplayName')
-			->with($this->equalTo('foo'))
-			->willReturn('Foo');
-
-		$backend->expects($this->any())
-			->method('implementsActions')
-			->with($this->equalTo(\OC\User\Backend::GET_DISPLAYNAME))
-			->willReturn(true);
-
-		$user = new User('foo', $backend, $this->dispatcher);
-		$this->assertEquals('Foo', $user->getDisplayName());
-	}
-
-	/**
-	 * if the display name contain whitespaces only, we expect the uid as result
-	 */
-	public function testDisplayNameEmpty(): void {
-		/**
-		 * @var \OC\User\Backend | MockObject $backend
-		 */
-		$backend = $this->createMock(\OC\User\Backend::class);
-		$backend->expects($this->once())
-			->method('getDisplayName')
-			->with($this->equalTo('foo'))
-			->willReturn('  ');
-
-		$backend->expects($this->any())
-			->method('implementsActions')
-			->with($this->equalTo(\OC\User\Backend::GET_DISPLAYNAME))
-			->willReturn(true);
-
-		$user = new User('foo', $backend, $this->dispatcher);
-		$this->assertEquals('foo', $user->getDisplayName());
-	}
-
-	public function testDisplayNameNotSupported(): void {
-		/**
-		 * @var \OC\User\Backend | MockObject $backend
-		 */
-		$backend = $this->createMock(\OC\User\Backend::class);
-		$backend->expects($this->never())
-			->method('getDisplayName');
-
-		$backend->expects($this->any())
-			->method('implementsActions')
-			->with($this->equalTo(\OC\User\Backend::GET_DISPLAYNAME))
-			->willReturn(false);
-
-		$user = new User('foo', $backend, $this->dispatcher);
-		$this->assertEquals('foo', $user->getDisplayName());
-	}
-
-	public function testSetPassword(): void {
-		/**
-		 * @var Backend | MockObject $backend
-		 */
-		$backend = $this->createMock(\Test\Util\User\Dummy::class);
-		$backend->expects($this->once())
-			->method('setPassword')
-			->with($this->equalTo('foo'), $this->equalTo('bar'));
-
-		$backend->expects($this->any())
-			->method('implementsActions')
-			->willReturnCallback(function ($actions) {
-				if ($actions === \OC\User\Backend::SET_PASSWORD) {
-					return true;
-				} else {
-					return false;
-				}
-			});
-
-		$user = new User('foo', $backend, $this->dispatcher);
-		$this->assertTrue($user->setPassword('bar', ''));
-	}
-
-	public function testSetPasswordNotSupported(): void {
-		/**
-		 * @var Backend | MockObject $backend
-		 */
-		$backend = $this->createMock(\Test\Util\User\Dummy::class);
-		$backend->expects($this->never())
-			->method('setPassword');
-
-		$backend->expects($this->any())
-			->method('implementsActions')
-			->willReturn(false);
-
-		$user = new User('foo', $backend, $this->dispatcher);
-		$this->assertFalse($user->setPassword('bar', ''));
-	}
-
-	public function testChangeAvatarSupportedYes(): void {
-		/**
-		 * @var Backend | MockObject $backend
-		 */
-		$backend = $this->createMock(AvatarUserDummy::class);
-		$backend->expects($this->once())
-			->method('canChangeAvatar')
-			->with($this->equalTo('foo'))
-			->willReturn(true);
-
-		$backend->expects($this->any())
-			->method('implementsActions')
-			->willReturnCallback(function ($actions) {
-				if ($actions === \OC\User\Backend::PROVIDE_AVATAR) {
-					return true;
-				} else {
-					return false;
-				}
-			});
-
-		$user = new User('foo', $backend, $this->dispatcher);
-		$this->assertTrue($user->canChangeAvatar());
-	}
-
-	public function testChangeAvatarSupportedNo(): void {
-		/**
-		 * @var Backend | MockObject $backend
-		 */
-		$backend = $this->createMock(AvatarUserDummy::class);
-		$backend->expects($this->once())
-			->method('canChangeAvatar')
-			->with($this->equalTo('foo'))
-			->willReturn(false);
-
-		$backend->expects($this->any())
-			->method('implementsActions')
-			->willReturnCallback(function ($actions) {
-				if ($actions === \OC\User\Backend::PROVIDE_AVATAR) {
-					return true;
-				} else {
-					return false;
-				}
-			});
-
-		$user = new User('foo', $backend, $this->dispatcher);
-		$this->assertFalse($user->canChangeAvatar());
-	}
-
-	public function testChangeAvatarNotSupported(): void {
-		/**
-		 * @var Backend | MockObject $backend
-		 */
-		$backend = $this->createMock(AvatarUserDummy::class);
-		$backend->expects($this->never())
-			->method('canChangeAvatar');
-
-		$backend->expects($this->any())
-			->method('implementsActions')
-			->willReturn(false);
-
-		$user = new User('foo', $backend, $this->dispatcher);
-		$this->assertTrue($user->canChangeAvatar());
-	}
-
-	public function testDelete(): void {
-		/**
-		 * @var Backend | MockObject $backend
-		 */
-		$backend = $this->createMock(\Test\Util\User\Dummy::class);
-		$backend->expects($this->once())
-			->method('deleteUser')
-			->with($this->equalTo('foo'));
-
-		$user = new User('foo', $backend, $this->dispatcher);
-		$this->assertTrue($user->delete());
-	}
-
-	public function testDeleteWithDifferentHome(): void {
-		/** @var ObjectHomeMountProvider $homeProvider */
-		$homeProvider = \OC::$server->get(ObjectHomeMountProvider::class);
-		$user = $this->createMock(IUser::class);
-		$user->method('getUID')
-			->willReturn('foo');
-		if ($homeProvider->getHomeMountForUser($user, $this->createMock(IStorageFactory::class)) !== null) {
-			$this->markTestSkipped('Skipping test for non local home storage');
-		}
-
-		/**
-		 * @var Backend | MockObject $backend
-		 */
-		$backend = $this->createMock(\Test\Util\User\Dummy::class);
-
-		$backend->expects($this->once())
-			->method('implementsActions')
-			->willReturnCallback(function ($actions) {
-				if ($actions === \OC\User\Backend::GET_HOME) {
-					return true;
-				} else {
-					return false;
-				}
-			});
-
-		// important: getHome MUST be called before deleteUser because
-		// once the user is deleted, getHome implementations might not
-		// return anything
-		$backend->expects($this->once())
-			->method('getHome')
-			->with($this->equalTo('foo'))
-			->willReturn('/home/foo');
-
-		$backend->expects($this->once())
-			->method('deleteUser')
-			->with($this->equalTo('foo'));
-
-		$user = new User('foo', $backend, $this->dispatcher);
-		$this->assertTrue($user->delete());
-	}
-
-	public function testGetHome(): void {
-		/**
-		 * @var Backend | MockObject $backend
-		 */
-		$backend = $this->createMock(\Test\Util\User\Dummy::class);
-		$backend->expects($this->once())
-			->method('getHome')
-			->with($this->equalTo('foo'))
-			->willReturn('/home/foo');
-
-		$backend->expects($this->any())
-			->method('implementsActions')
-			->willReturnCallback(function ($actions) {
-				if ($actions === \OC\User\Backend::GET_HOME) {
-					return true;
-				} else {
-					return false;
-				}
-			});
-
-		$user = new User('foo', $backend, $this->dispatcher);
-		$this->assertEquals('/home/foo', $user->getHome());
-	}
-
-	public function testGetBackendClassName(): void {
-		$user = new User('foo', new \Test\Util\User\Dummy(), $this->dispatcher);
-		$this->assertEquals('Dummy', $user->getBackendClassName());
-		$user = new User('foo', new \OC\User\Database(), $this->dispatcher);
-		$this->assertEquals('Database', $user->getBackendClassName());
-	}
-
-	public function testGetHomeNotSupported(): void {
-		/**
-		 * @var Backend | MockObject $backend
-		 */
-		$backend = $this->createMock(\Test\Util\User\Dummy::class);
-		$backend->expects($this->never())
-			->method('getHome');
-
-		$backend->expects($this->any())
-			->method('implementsActions')
-			->willReturn(false);
-
-		$allConfig = $this->getMockBuilder(IConfig::class)
-			->disableOriginalConstructor()
-			->getMock();
-		$allConfig->expects($this->any())
-			->method('getUserValue')
-			->willReturn(true);
-		$allConfig->expects($this->any())
-			->method('getSystemValueString')
-			->with($this->equalTo('datadirectory'))
-			->willReturn('arbitrary/path');
-
-		$user = new User('foo', $backend, $this->dispatcher, null, $allConfig);
-		$this->assertEquals('arbitrary/path/foo', $user->getHome());
-	}
-
-	public function testCanChangePassword(): void {
-		/**
-		 * @var Backend | MockObject $backend
-		 */
-		$backend = $this->createMock(\Test\Util\User\Dummy::class);
-
-		$backend->expects($this->any())
-			->method('implementsActions')
-			->willReturnCallback(function ($actions) {
-				if ($actions === \OC\User\Backend::SET_PASSWORD) {
-					return true;
-				} else {
-					return false;
-				}
-			});
-
-		$user = new User('foo', $backend, $this->dispatcher);
-		$this->assertTrue($user->canChangePassword());
-	}
-
-	public function testCanChangePasswordNotSupported(): void {
-		/**
-		 * @var Backend | MockObject $backend
-		 */
-		$backend = $this->createMock(\Test\Util\User\Dummy::class);
-
-		$backend->expects($this->any())
-			->method('implementsActions')
-			->willReturn(false);
-
-		$user = new User('foo', $backend, $this->dispatcher);
-		$this->assertFalse($user->canChangePassword());
-	}
-
-	public function testCanChangeDisplayName(): void {
-		/**
-		 * @var Backend | MockObject $backend
-		 */
-		$backend = $this->createMock(\Test\Util\User\Dummy::class);
-
-		$backend->expects($this->any())
-			->method('implementsActions')
-			->willReturnCallback(function ($actions) {
-				if ($actions === \OC\User\Backend::SET_DISPLAYNAME) {
-					return true;
-				} else {
-					return false;
-				}
-			});
-
-		$config = $this->createMock(IConfig::class);
-		$config->method('getSystemValueBool')
-			->with('allow_user_to_change_display_name')
-			->willReturn(true);
-
-		$user = new User('foo', $backend, $this->dispatcher, null, $config);
-		$this->assertTrue($user->canChangeDisplayName());
-	}
-
-	public function testCanChangeDisplayNameNotSupported(): void {
-		/**
-		 * @var Backend | MockObject $backend
-		 */
-		$backend = $this->createMock(\Test\Util\User\Dummy::class);
-
-		$backend->expects($this->any())
-			->method('implementsActions')
-			->willReturn(false);
-
-		$user = new User('foo', $backend, $this->dispatcher);
-		$this->assertFalse($user->canChangeDisplayName());
-	}
-
-	public function testSetDisplayNameSupported(): void {
-		/**
-		 * @var Backend | MockObject $backend
-		 */
-		$backend = $this->createMock(\OC\User\Database::class);
-
-		$backend->expects($this->any())
-			->method('implementsActions')
-			->willReturnCallback(function ($actions) {
-				if ($actions === \OC\User\Backend::SET_DISPLAYNAME) {
-					return true;
-				} else {
-					return false;
-				}
-			});
-
-		$backend->expects($this->once())
-			->method('setDisplayName')
-			->with('foo', 'Foo')
-			->willReturn(true);
-
-		$user = new User('foo', $backend, $this->createMock(IEventDispatcher::class));
-		$this->assertTrue($user->setDisplayName('Foo'));
-		$this->assertEquals('Foo', $user->getDisplayName());
-	}
-
-	/**
-	 * don't allow display names containing whitespaces only
-	 */
-	public function testSetDisplayNameEmpty(): void {
-		/**
-		 * @var Backend | MockObject $backend
-		 */
-		$backend = $this->createMock(\OC\User\Database::class);
-
-		$backend->expects($this->any())
-			->method('implementsActions')
-			->willReturnCallback(function ($actions) {
-				if ($actions === \OC\User\Backend::SET_DISPLAYNAME) {
-					return true;
-				} else {
-					return false;
-				}
-			});
-
-		$user = new User('foo', $backend, $this->dispatcher);
-		$this->assertFalse($user->setDisplayName(' '));
-		$this->assertEquals('foo', $user->getDisplayName());
-	}
-
-	public function testSetDisplayNameNotSupported(): void {
-		/**
-		 * @var Backend | MockObject $backend
-		 */
-		$backend = $this->createMock(\OC\User\Database::class);
-
-		$backend->expects($this->any())
-			->method('implementsActions')
-			->willReturn(false);
-
-		$backend->expects($this->never())
-			->method('setDisplayName');
-
-		$user = new User('foo', $backend, $this->dispatcher);
-		$this->assertFalse($user->setDisplayName('Foo'));
-		$this->assertEquals('foo', $user->getDisplayName());
-	}
-
-	public function testSetPasswordHooks(): void {
-		$hooksCalled = 0;
-		$test = $this;
-
-		/**
-		 * @var Backend | MockObject $backend
-		 */
-		$backend = $this->createMock(\Test\Util\User\Dummy::class);
-		$backend->expects($this->once())
-			->method('setPassword');
-
-		/**
-		 * @param User $user
-		 * @param string $password
-		 */
-		$hook = function ($user, $password) use ($test, &$hooksCalled) {
-			$hooksCalled++;
-			$test->assertEquals('foo', $user->getUID());
-			$test->assertEquals('bar', $password);
-		};
-
-		$emitter = new PublicEmitter();
-		$emitter->listen('\OC\User', 'preSetPassword', $hook);
-		$emitter->listen('\OC\User', 'postSetPassword', $hook);
-
-		$backend->expects($this->any())
-			->method('implementsActions')
-			->willReturnCallback(function ($actions) {
-				if ($actions === \OC\User\Backend::SET_PASSWORD) {
-					return true;
-				} else {
-					return false;
-				}
-			});
-
-		$user = new User('foo', $backend, $this->dispatcher, $emitter);
-
-		$user->setPassword('bar', '');
-		$this->assertEquals(2, $hooksCalled);
-	}
-
-	public static function dataDeleteHooks(): array {
-		return [
-			[true, 2],
-			[false, 1],
-		];
-	}
-
-	/**
-	 * @dataProvider dataDeleteHooks
-	 * @param bool $result
-	 * @param int $expectedHooks
-	 */
-	public function testDeleteHooks($result, $expectedHooks): void {
-		$hooksCalled = 0;
-		$test = $this;
-
-		/**
-		 * @var UserInterface&MockObject $backend
-		 */
-		$backend = $this->createMock(\Test\Util\User\Dummy::class);
-		$backend->expects($this->once())
-			->method('deleteUser')
-			->willReturn($result);
-
-		$config = $this->createMock(IConfig::class);
-		$config->method('getSystemValue')
-			->willReturnArgument(1);
-		$config->method('getSystemValueString')
-			->willReturnArgument(1);
-		$config->method('getSystemValueBool')
-			->willReturnArgument(1);
-		$config->method('getSystemValueInt')
-			->willReturnArgument(1);
-
-		$emitter = new PublicEmitter();
-		$user = new User('foo', $backend, $this->dispatcher, $emitter, $config);
-
-		/**
-		 * @param User $user
-		 */
-		$hook = function ($user) use ($test, &$hooksCalled) {
-			$hooksCalled++;
-			$test->assertEquals('foo', $user->getUID());
-		};
-
-		$emitter->listen('\OC\User', 'preDelete', $hook);
-		$emitter->listen('\OC\User', 'postDelete', $hook);
-
-		$commentsManager = $this->createMock(ICommentsManager::class);
-		$notificationManager = $this->createMock(INotificationManager::class);
-
-		if ($result) {
-			$config->expects($this->atLeastOnce())
-				->method('deleteAllUserValues')
-				->with('foo');
-
-			$commentsManager->expects($this->once())
-				->method('deleteReferencesOfActor')
-				->with('users', 'foo');
-			$commentsManager->expects($this->once())
-				->method('deleteReadMarksFromUser')
-				->with($user);
-
-			$notification = $this->createMock(INotification::class);
-			$notification->expects($this->once())
-				->method('setUser')
-				->with('foo');
-
-			$notificationManager->expects($this->once())
-				->method('createNotification')
-				->willReturn($notification);
-			$notificationManager->expects($this->once())
-				->method('markProcessed')
-				->with($notification);
-		} else {
-			$config->expects($this->never())
-				->method('deleteAllUserValues');
-
-			$commentsManager->expects($this->never())
-				->method('deleteReferencesOfActor');
-			$commentsManager->expects($this->never())
-				->method('deleteReadMarksFromUser');
-
-			$notificationManager->expects($this->never())
-				->method('createNotification');
-			$notificationManager->expects($this->never())
-				->method('markProcessed');
-		}
-
-		$this->overwriteService(\OCP\Notification\IManager::class, $notificationManager);
-		$this->overwriteService(\OCP\Comments\ICommentsManager::class, $commentsManager);
-
-		$this->assertSame($result, $user->delete());
-
-		$this->restoreService(AllConfig::class);
-		$this->restoreService(\OCP\Comments\ICommentsManager::class);
-		$this->restoreService(\OCP\Notification\IManager::class);
-
-		$this->assertEquals($expectedHooks, $hooksCalled);
-	}
-
-	public function testDeleteRecoverState() {
-		$backend = $this->createMock(\Test\Util\User\Dummy::class);
-		$backend->expects($this->once())
-			->method('deleteUser')
-			->willReturn(true);
-
-		$config = $this->createMock(IConfig::class);
-		$config->method('getSystemValue')
-			->willReturnArgument(1);
-		$config->method('getSystemValueString')
-			->willReturnArgument(1);
-		$config->method('getSystemValueBool')
-			->willReturnArgument(1);
-		$config->method('getSystemValueInt')
-			->willReturnArgument(1);
-
-		$userConfig = [];
-		$config->expects(self::atLeast(2))
-			->method('setUserValue')
-			->willReturnCallback(function () {
-				$userConfig[] = func_get_args();
-			});
-
-		$commentsManager = $this->createMock(ICommentsManager::class);
-		$commentsManager->expects($this->once())
-			->method('deleteReferencesOfActor')
-			->willThrowException(new \Error('Test exception'));
-
-		$this->overwriteService(\OCP\Comments\ICommentsManager::class, $commentsManager);
-		$this->expectException(\Error::class);
-
-		$user = $this->getMockBuilder(User::class)
-			->onlyMethods(['getHome'])
-			->setConstructorArgs(['foo', $backend, $this->dispatcher, null, $config])
-			->getMock();
-
-		$user->expects(self::atLeastOnce())
-			->method('getHome')
-			->willReturn('/home/path');
-
-		$user->delete();
-
-		$this->assertEqualsCanonicalizing(
-			[
-				['foo', 'core', 'deleted', 'true', null],
-				['foo', 'core', 'deleted.backup-home', '/home/path', null],
-			],
-			$userConfig,
-		);
-
-		$this->restoreService(\OCP\Comments\ICommentsManager::class);
-	}
-
-	public static function dataGetCloudId(): array {
-		return [
-			['https://localhost:8888/nextcloud', 'foo@localhost:8888/nextcloud'],
-			['http://localhost:8888/nextcloud', 'foo@http://localhost:8888/nextcloud'],
-		];
-	}
-
-	/**
-	 * @dataProvider dataGetCloudId
-	 */
-	public function testGetCloudId(string $absoluteUrl, string $cloudId): void {
-		/** @var Backend|MockObject $backend */
-		$backend = $this->createMock(\Test\Util\User\Dummy::class);
-		$urlGenerator = $this->createMock(IURLGenerator::class);
-		$urlGenerator->method('getAbsoluteURL')
-			->withAnyParameters()
-			->willReturn($absoluteUrl);
-		$user = new User('foo', $backend, $this->dispatcher, null, null, $urlGenerator);
-		$this->assertEquals($cloudId, $user->getCloudId());
-	}
-
-	public function testSetEMailAddressEmpty(): void {
-		/**
-		 * @var Backend | MockObject $backend
-		 */
-		$backend = $this->createMock(\Test\Util\User\Dummy::class);
-
-		$test = $this;
-		$hooksCalled = 0;
-
-		/**
-		 * @param IUser $user
-		 * @param string $feature
-		 * @param string $value
-		 */
-		$hook = function (IUser $user, $feature, $value) use ($test, &$hooksCalled) {
-			$hooksCalled++;
-			$test->assertEquals('eMailAddress', $feature);
-			$test->assertEquals('', $value);
-		};
-
-		$emitter = new PublicEmitter();
-		$emitter->listen('\OC\User', 'changeUser', $hook);
-
-		$config = $this->createMock(IConfig::class);
-		$config->expects($this->once())
-			->method('deleteUserValue')
-			->with(
-				'foo',
-				'settings',
-				'email'
-			);
-
-		$user = new User('foo', $backend, $this->dispatcher, $emitter, $config);
-		$user->setEMailAddress('');
-	}
-
-	public function testSetEMailAddress(): void {
-		/**
-		 * @var UserInterface | MockObject $backend
-		 */
-		$backend = $this->createMock(\Test\Util\User\Dummy::class);
-
-		$test = $this;
-		$hooksCalled = 0;
-
-		/**
-		 * @param IUser $user
-		 * @param string $feature
-		 * @param string $value
-		 */
-		$hook = function (IUser $user, $feature, $value) use ($test, &$hooksCalled) {
-			$hooksCalled++;
-			$test->assertEquals('eMailAddress', $feature);
-			$test->assertEquals('foo@bar.com', $value);
-		};
-
-		$emitter = new PublicEmitter();
-		$emitter->listen('\OC\User', 'changeUser', $hook);
-
-		$config = $this->createMock(IConfig::class);
-		$config->expects($this->once())
-			->method('setUserValue')
-			->with(
-				'foo',
-				'settings',
-				'email',
-				'foo@bar.com'
-			);
-
-		$user = new User('foo', $backend, $this->dispatcher, $emitter, $config);
-		$user->setEMailAddress('foo@bar.com');
-	}
-
-	public function testSetEMailAddressNoChange(): void {
-		/**
-		 * @var UserInterface | MockObject $backend
-		 */
-		$backend = $this->createMock(\Test\Util\User\Dummy::class);
-
-		/** @var PublicEmitter|MockObject $emitter */
-		$emitter = $this->createMock(PublicEmitter::class);
-		$emitter->expects($this->never())
-			->method('emit');
-
-		$dispatcher = $this->createMock(IEventDispatcher::class);
-		$dispatcher->expects($this->never())
-			->method('dispatch');
-
-		$config = $this->createMock(IConfig::class);
-		$config->expects($this->any())
-			->method('getUserValue')
-			->willReturn('foo@bar.com');
-		$config->expects($this->any())
-			->method('setUserValue');
-
-		$user = new User('foo', $backend, $dispatcher, $emitter, $config);
-		$user->setEMailAddress('foo@bar.com');
-	}
-
-	public function testSetQuota(): void {
-		/**
-		 * @var UserInterface | MockObject $backend
-		 */
-		$backend = $this->createMock(\Test\Util\User\Dummy::class);
-
-		$test = $this;
-		$hooksCalled = 0;
-
-		/**
-		 * @param IUser $user
-		 * @param string $feature
-		 * @param string $value
-		 */
-		$hook = function (IUser $user, $feature, $value) use ($test, &$hooksCalled) {
-			$hooksCalled++;
-			$test->assertEquals('quota', $feature);
-			$test->assertEquals('23 TB', $value);
-		};
-
-		$emitter = new PublicEmitter();
-		$emitter->listen('\OC\User', 'changeUser', $hook);
-
-		$config = $this->createMock(IConfig::class);
-		$config->expects($this->once())
-			->method('setUserValue')
-			->with(
-				'foo',
-				'files',
-				'quota',
-				'23 TB'
-			);
-
-		$user = new User('foo', $backend, $this->dispatcher, $emitter, $config);
-		$user->setQuota('23 TB');
-	}
-
-	public function testGetDefaultUnlimitedQuota(): void {
-		/**
-		 * @var UserInterface | MockObject $backend
-		 */
-		$backend = $this->createMock(\Test\Util\User\Dummy::class);
-
-		/** @var PublicEmitter|MockObject $emitter */
-		$emitter = $this->createMock(PublicEmitter::class);
-		$emitter->expects($this->never())
-			->method('emit');
-
-		$config = $this->createMock(IConfig::class);
-		$user = new User('foo', $backend, $this->dispatcher, $emitter, $config);
-
-		$userValueMap = [
-			['foo', 'files', 'quota', 'default', 'default'],
-		];
-		$appValueMap = [
-			['files', 'default_quota', 'none', 'none'],
-			// allow unlimited quota
-			['files', 'allow_unlimited_quota', '1', '1'],
-		];
-		$config->method('getUserValue')
-			->will($this->returnValueMap($userValueMap));
-		$config->method('getAppValue')
-			->will($this->returnValueMap($appValueMap));
-
-		$this->assertEquals('none', $user->getQuota());
-		$this->assertEquals(FileInfo::SPACE_UNLIMITED, $user->getQuotaBytes());
-	}
-
-	public function testGetDefaultUnlimitedQuotaForbidden(): void {
-		/**
-		 * @var UserInterface | MockObject $backend
-		 */
-		$backend = $this->createMock(\Test\Util\User\Dummy::class);
-
-		/** @var PublicEmitter|MockObject $emitter */
-		$emitter = $this->createMock(PublicEmitter::class);
-		$emitter->expects($this->never())
-			->method('emit');
-
-		$config = $this->createMock(IConfig::class);
-		$user = new User('foo', $backend, $this->dispatcher, $emitter, $config);
-
-		$userValueMap = [
-			['foo', 'files', 'quota', 'default', 'default'],
-		];
-		$appValueMap = [
-			['files', 'default_quota', 'none', 'none'],
-			// do not allow unlimited quota
-			['files', 'allow_unlimited_quota', '1', '0'],
-			['files', 'quota_preset', '1 GB, 5 GB, 10 GB', '1 GB, 5 GB, 10 GB'],
-			// expect seeing 1 GB used as fallback value
-			['files', 'default_quota', '1 GB', '1 GB'],
-		];
-		$config->method('getUserValue')
-			->will($this->returnValueMap($userValueMap));
-		$config->method('getAppValue')
-			->will($this->returnValueMap($appValueMap));
-
-		$this->assertEquals('1 GB', $user->getQuota());
-		$this->assertEquals(1024 * 1024 * 1024, $user->getQuotaBytes());
-	}
-
-	public function testSetQuotaAddressNoChange(): void {
-		/**
-		 * @var UserInterface | MockObject $backend
-		 */
-		$backend = $this->createMock(\Test\Util\User\Dummy::class);
-
-		/** @var PublicEmitter|MockObject $emitter */
-		$emitter = $this->createMock(PublicEmitter::class);
-		$emitter->expects($this->never())
-			->method('emit');
-
-		$config = $this->createMock(IConfig::class);
-		$config->expects($this->any())
-			->method('getUserValue')
-			->willReturn('23 TB');
-		$config->expects($this->never())
-			->method('setUserValue');
-
-		$user = new User('foo', $backend, $this->dispatcher, $emitter, $config);
-		$user->setQuota('23 TB');
-	}
-
-	public function testGetLastLogin(): void {
-		/**
-		 * @var Backend | MockObject $backend
-		 */
-		$backend = $this->createMock(\Test\Util\User\Dummy::class);
-
-		$config = $this->createMock(IConfig::class);
-		$config->method('getUserValue')
-			->willReturnCallback(function ($uid, $app, $key, $default) {
-				if ($uid === 'foo' && $app === 'login' && $key === 'lastLogin') {
-					return 42;
-				} else {
-					return $default;
-				}
-			});
-
-		$user = new User('foo', $backend, $this->dispatcher, null, $config);
-		$this->assertSame(42, $user->getLastLogin());
-	}
-
-	public function testSetEnabled(): void {
-		/**
-		 * @var Backend | MockObject $backend
-		 */
-		$backend = $this->createMock(\Test\Util\User\Dummy::class);
-
-		$config = $this->createMock(IConfig::class);
-		$config->expects($this->once())
-			->method('setUserValue')
-			->with(
-				$this->equalTo('foo'),
-				$this->equalTo('core'),
-				$this->equalTo('enabled'),
-				'true'
-			);
-		/* dav event listener gets the manager list from config */
-		$config->expects(self::any())
-			->method('getUserValue')
-			->willReturnCallback(
-				fn ($user, $app, $key, $default) => ($key === 'enabled' ? 'false' : $default)
-			);
-
-		$user = new User('foo', $backend, $this->dispatcher, null, $config);
-		$user->setEnabled(true);
-	}
-
-	public function testSetDisabled(): void {
-		/**
-		 * @var Backend | MockObject $backend
-		 */
-		$backend = $this->createMock(\Test\Util\User\Dummy::class);
-
-		$config = $this->createMock(IConfig::class);
-		$config->expects($this->once())
-			->method('setUserValue')
-			->with(
-				$this->equalTo('foo'),
-				$this->equalTo('core'),
-				$this->equalTo('enabled'),
-				'false'
-			);
-
-		$user = $this->getMockBuilder(User::class)
-			->setConstructorArgs([
-				'foo',
-				$backend,
-				$this->dispatcher,
-				null,
-				$config,
-			])
-			->onlyMethods(['isEnabled', 'triggerChange'])
-			->getMock();
-
-		$user->expects($this->once())
-			->method('isEnabled')
-			->willReturn(true);
-		$user->expects($this->once())
-			->method('triggerChange')
-			->with(
-				'enabled',
-				false
-			);
-
-		$user->setEnabled(false);
-	}
-
-	public function testSetDisabledAlreadyDisabled(): void {
-		/**
-		 * @var Backend | MockObject $backend
-		 */
-		$backend = $this->createMock(\Test\Util\User\Dummy::class);
-
-		$config = $this->createMock(IConfig::class);
-		$config->expects($this->never())
-			->method('setUserValue');
-
-		$user = $this->getMockBuilder(User::class)
-			->setConstructorArgs([
-				'foo',
-				$backend,
-				$this->dispatcher,
-				null,
-				$config,
-			])
-			->onlyMethods(['isEnabled', 'triggerChange'])
-			->getMock();
-
-		$user->expects($this->once())
-			->method('isEnabled')
-			->willReturn(false);
-		$user->expects($this->never())
-			->method('triggerChange');
-
-		$user->setEnabled(false);
-	}
-
-	public function testGetEMailAddress(): void {
-		/**
-		 * @var Backend | MockObject $backend
-		 */
-		$backend = $this->createMock(\Test\Util\User\Dummy::class);
-
-		$config = $this->createMock(IConfig::class);
-		$config->method('getUserValue')
-			->willReturnCallback(function ($uid, $app, $key, $default) {
-				if ($uid === 'foo' && $app === 'settings' && $key === 'email') {
-					return 'foo@bar.com';
-				} else {
-					return $default;
-				}
-			});
-
-		$user = new User('foo', $backend, $this->dispatcher, null, $config);
-		$this->assertSame('foo@bar.com', $user->getEMailAddress());
-	}
+    /** @var IEventDispatcher|MockObject */
+    protected $dispatcher;
+
+    protected function setUp(): void {
+        parent::setUp();
+        $this->dispatcher = Server::get(IEventDispatcher::class);
+    }
+
+    public function testDisplayName(): void {
+        /**
+         * @var \OC\User\Backend | MockObject $backend
+         */
+        $backend = $this->createMock(\OC\User\Backend::class);
+        $backend->expects($this->once())
+            ->method('getDisplayName')
+            ->with($this->equalTo('foo'))
+            ->willReturn('Foo');
+
+        $backend->expects($this->any())
+            ->method('implementsActions')
+            ->with($this->equalTo(\OC\User\Backend::GET_DISPLAYNAME))
+            ->willReturn(true);
+
+        $user = new User('foo', $backend, $this->dispatcher);
+        $this->assertEquals('Foo', $user->getDisplayName());
+    }
+
+    /**
+     * if the display name contain whitespaces only, we expect the uid as result
+     */
+    public function testDisplayNameEmpty(): void {
+        /**
+         * @var \OC\User\Backend | MockObject $backend
+         */
+        $backend = $this->createMock(\OC\User\Backend::class);
+        $backend->expects($this->once())
+            ->method('getDisplayName')
+            ->with($this->equalTo('foo'))
+            ->willReturn('  ');
+
+        $backend->expects($this->any())
+            ->method('implementsActions')
+            ->with($this->equalTo(\OC\User\Backend::GET_DISPLAYNAME))
+            ->willReturn(true);
+
+        $user = new User('foo', $backend, $this->dispatcher);
+        $this->assertEquals('foo', $user->getDisplayName());
+    }
+
+    public function testDisplayNameNotSupported(): void {
+        /**
+         * @var \OC\User\Backend | MockObject $backend
+         */
+        $backend = $this->createMock(\OC\User\Backend::class);
+        $backend->expects($this->never())
+            ->method('getDisplayName');
+
+        $backend->expects($this->any())
+            ->method('implementsActions')
+            ->with($this->equalTo(\OC\User\Backend::GET_DISPLAYNAME))
+            ->willReturn(false);
+
+        $user = new User('foo', $backend, $this->dispatcher);
+        $this->assertEquals('foo', $user->getDisplayName());
+    }
+
+    public function testSetPassword(): void {
+        /**
+         * @var Backend | MockObject $backend
+         */
+        $backend = $this->createMock(\Test\Util\User\Dummy::class);
+        $backend->expects($this->once())
+            ->method('setPassword')
+            ->with($this->equalTo('foo'), $this->equalTo('bar'));
+
+        $backend->expects($this->any())
+            ->method('implementsActions')
+            ->willReturnCallback(function ($actions) {
+                if ($actions === \OC\User\Backend::SET_PASSWORD) {
+                    return true;
+                } else {
+                    return false;
+                }
+            });
+
+        $user = new User('foo', $backend, $this->dispatcher);
+        $this->assertTrue($user->setPassword('bar', ''));
+    }
+
+    public function testSetPasswordNotSupported(): void {
+        /**
+         * @var Backend | MockObject $backend
+         */
+        $backend = $this->createMock(\Test\Util\User\Dummy::class);
+        $backend->expects($this->never())
+            ->method('setPassword');
+
+        $backend->expects($this->any())
+            ->method('implementsActions')
+            ->willReturn(false);
+
+        $user = new User('foo', $backend, $this->dispatcher);
+        $this->assertFalse($user->setPassword('bar', ''));
+    }
+
+    public function testChangeAvatarSupportedYes(): void {
+        /**
+         * @var Backend | MockObject $backend
+         */
+        $backend = $this->createMock(AvatarUserDummy::class);
+        $backend->expects($this->once())
+            ->method('canChangeAvatar')
+            ->with($this->equalTo('foo'))
+            ->willReturn(true);
+
+        $backend->expects($this->any())
+            ->method('implementsActions')
+            ->willReturnCallback(function ($actions) {
+                if ($actions === \OC\User\Backend::PROVIDE_AVATAR) {
+                    return true;
+                } else {
+                    return false;
+                }
+            });
+
+        $user = new User('foo', $backend, $this->dispatcher);
+        $this->assertTrue($user->canChangeAvatar());
+    }
+
+    public function testChangeAvatarSupportedNo(): void {
+        /**
+         * @var Backend | MockObject $backend
+         */
+        $backend = $this->createMock(AvatarUserDummy::class);
+        $backend->expects($this->once())
+            ->method('canChangeAvatar')
+            ->with($this->equalTo('foo'))
+            ->willReturn(false);
+
+        $backend->expects($this->any())
+            ->method('implementsActions')
+            ->willReturnCallback(function ($actions) {
+                if ($actions === \OC\User\Backend::PROVIDE_AVATAR) {
+                    return true;
+                } else {
+                    return false;
+                }
+            });
+
+        $user = new User('foo', $backend, $this->dispatcher);
+        $this->assertFalse($user->canChangeAvatar());
+    }
+
+    public function testChangeAvatarNotSupported(): void {
+        /**
+         * @var Backend | MockObject $backend
+         */
+        $backend = $this->createMock(AvatarUserDummy::class);
+        $backend->expects($this->never())
+            ->method('canChangeAvatar');
+
+        $backend->expects($this->any())
+            ->method('implementsActions')
+            ->willReturn(false);
+
+        $user = new User('foo', $backend, $this->dispatcher);
+        $this->assertTrue($user->canChangeAvatar());
+    }
+
+    public function testDelete(): void {
+        /**
+         * @var Backend | MockObject $backend
+         */
+        $backend = $this->createMock(\Test\Util\User\Dummy::class);
+        $backend->expects($this->once())
+            ->method('deleteUser')
+            ->with($this->equalTo('foo'));
+
+        $user = new User('foo', $backend, $this->dispatcher);
+        $this->assertTrue($user->delete());
+    }
+
+    public function testDeleteWithDifferentHome(): void {
+        /** @var ObjectHomeMountProvider $homeProvider */
+        $homeProvider = \OC::$server->get(ObjectHomeMountProvider::class);
+        $user = $this->createMock(IUser::class);
+        $user->method('getUID')
+            ->willReturn('foo');
+        if ($homeProvider->getHomeMountForUser($user, $this->createMock(IStorageFactory::class)) !== null) {
+            $this->markTestSkipped('Skipping test for non local home storage');
+        }
+
+        /**
+         * @var Backend | MockObject $backend
+         */
+        $backend = $this->createMock(\Test\Util\User\Dummy::class);
+
+        $backend->expects($this->once())
+            ->method('implementsActions')
+            ->willReturnCallback(function ($actions) {
+                if ($actions === \OC\User\Backend::GET_HOME) {
+                    return true;
+                } else {
+                    return false;
+                }
+            });
+
+        // important: getHome MUST be called before deleteUser because
+        // once the user is deleted, getHome implementations might not
+        // return anything
+        $backend->expects($this->once())
+            ->method('getHome')
+            ->with($this->equalTo('foo'))
+            ->willReturn('/home/foo');
+
+        $backend->expects($this->once())
+            ->method('deleteUser')
+            ->with($this->equalTo('foo'));
+
+        $user = new User('foo', $backend, $this->dispatcher);
+        $this->assertTrue($user->delete());
+    }
+
+    public function testGetHome(): void {
+        /**
+         * @var Backend | MockObject $backend
+         */
+        $backend = $this->createMock(\Test\Util\User\Dummy::class);
+        $backend->expects($this->once())
+            ->method('getHome')
+            ->with($this->equalTo('foo'))
+            ->willReturn('/home/foo');
+
+        $backend->expects($this->any())
+            ->method('implementsActions')
+            ->willReturnCallback(function ($actions) {
+                if ($actions === \OC\User\Backend::GET_HOME) {
+                    return true;
+                } else {
+                    return false;
+                }
+            });
+
+        $user = new User('foo', $backend, $this->dispatcher);
+        $this->assertEquals('/home/foo', $user->getHome());
+    }
+
+    public function testGetBackendClassName(): void {
+        $user = new User('foo', new \Test\Util\User\Dummy(), $this->dispatcher);
+        $this->assertEquals('Dummy', $user->getBackendClassName());
+        $user = new User('foo', new \OC\User\Database(), $this->dispatcher);
+        $this->assertEquals('Database', $user->getBackendClassName());
+    }
+
+    public function testGetHomeNotSupported(): void {
+        /**
+         * @var Backend | MockObject $backend
+         */
+        $backend = $this->createMock(\Test\Util\User\Dummy::class);
+        $backend->expects($this->never())
+            ->method('getHome');
+
+        $backend->expects($this->any())
+            ->method('implementsActions')
+            ->willReturn(false);
+
+        $allConfig = $this->getMockBuilder(IConfig::class)
+            ->disableOriginalConstructor()
+            ->getMock();
+        $allConfig->expects($this->any())
+            ->method('getUserValue')
+            ->willReturn(true);
+        $allConfig->expects($this->any())
+            ->method('getSystemValueString')
+            ->with($this->equalTo('datadirectory'))
+            ->willReturn('arbitrary/path');
+
+        $user = new User('foo', $backend, $this->dispatcher, null, $allConfig);
+        $this->assertEquals('arbitrary/path/foo', $user->getHome());
+    }
+
+    public function testCanChangePassword(): void {
+        /**
+         * @var Backend | MockObject $backend
+         */
+        $backend = $this->createMock(\Test\Util\User\Dummy::class);
+
+        $backend->expects($this->any())
+            ->method('implementsActions')
+            ->willReturnCallback(function ($actions) {
+                if ($actions === \OC\User\Backend::SET_PASSWORD) {
+                    return true;
+                } else {
+                    return false;
+                }
+            });
+
+        $user = new User('foo', $backend, $this->dispatcher);
+        $this->assertTrue($user->canChangePassword());
+    }
+
+    public function testCanChangePasswordNotSupported(): void {
+        /**
+         * @var Backend | MockObject $backend
+         */
+        $backend = $this->createMock(\Test\Util\User\Dummy::class);
+
+        $backend->expects($this->any())
+            ->method('implementsActions')
+            ->willReturn(false);
+
+        $user = new User('foo', $backend, $this->dispatcher);
+        $this->assertFalse($user->canChangePassword());
+    }
+
+    public function testCanChangeDisplayName(): void {
+        /**
+         * @var Backend | MockObject $backend
+         */
+        $backend = $this->createMock(\Test\Util\User\Dummy::class);
+
+        $backend->expects($this->any())
+            ->method('implementsActions')
+            ->willReturnCallback(function ($actions) {
+                if ($actions === \OC\User\Backend::SET_DISPLAYNAME) {
+                    return true;
+                } else {
+                    return false;
+                }
+            });
+
+        $config = $this->createMock(IConfig::class);
+        $config->method('getSystemValueBool')
+            ->with('allow_user_to_change_display_name')
+            ->willReturn(true);
+
+        $user = new User('foo', $backend, $this->dispatcher, null, $config);
+        $this->assertTrue($user->canChangeDisplayName());
+    }
+
+    public function testCanChangeDisplayNameNotSupported(): void {
+        /**
+         * @var Backend | MockObject $backend
+         */
+        $backend = $this->createMock(\Test\Util\User\Dummy::class);
+
+        $backend->expects($this->any())
+            ->method('implementsActions')
+            ->willReturn(false);
+
+        $user = new User('foo', $backend, $this->dispatcher);
+        $this->assertFalse($user->canChangeDisplayName());
+    }
+
+    public function testSetDisplayNameSupported(): void {
+        /**
+         * @var Backend | MockObject $backend
+         */
+        $backend = $this->createMock(\OC\User\Database::class);
+
+        $backend->expects($this->any())
+            ->method('implementsActions')
+            ->willReturnCallback(function ($actions) {
+                if ($actions === \OC\User\Backend::SET_DISPLAYNAME) {
+                    return true;
+                } else {
+                    return false;
+                }
+            });
+
+        $backend->expects($this->once())
+            ->method('setDisplayName')
+            ->with('foo', 'Foo')
+            ->willReturn(true);
+
+        $user = new User('foo', $backend, $this->createMock(IEventDispatcher::class));
+        $this->assertTrue($user->setDisplayName('Foo'));
+        $this->assertEquals('Foo', $user->getDisplayName());
+    }
+
+    /**
+     * don't allow display names containing whitespaces only
+     */
+    public function testSetDisplayNameEmpty(): void {
+        /**
+         * @var Backend | MockObject $backend
+         */
+        $backend = $this->createMock(\OC\User\Database::class);
+
+        $backend->expects($this->any())
+            ->method('implementsActions')
+            ->willReturnCallback(function ($actions) {
+                if ($actions === \OC\User\Backend::SET_DISPLAYNAME) {
+                    return true;
+                } else {
+                    return false;
+                }
+            });
+
+        $user = new User('foo', $backend, $this->dispatcher);
+        $this->assertFalse($user->setDisplayName(' '));
+        $this->assertEquals('foo', $user->getDisplayName());
+    }
+
+    public function testSetDisplayNameNotSupported(): void {
+        /**
+         * @var Backend | MockObject $backend
+         */
+        $backend = $this->createMock(\OC\User\Database::class);
+
+        $backend->expects($this->any())
+            ->method('implementsActions')
+            ->willReturn(false);
+
+        $backend->expects($this->never())
+            ->method('setDisplayName');
+
+        $user = new User('foo', $backend, $this->dispatcher);
+        $this->assertFalse($user->setDisplayName('Foo'));
+        $this->assertEquals('foo', $user->getDisplayName());
+    }
+
+    public function testSetPasswordHooks(): void {
+        $hooksCalled = 0;
+        $test = $this;
+
+        /**
+         * @var Backend | MockObject $backend
+         */
+        $backend = $this->createMock(\Test\Util\User\Dummy::class);
+        $backend->expects($this->once())
+            ->method('setPassword');
+
+        /**
+         * @param User $user
+         * @param string $password
+         */
+        $hook = function ($user, $password) use ($test, &$hooksCalled) {
+            $hooksCalled++;
+            $test->assertEquals('foo', $user->getUID());
+            $test->assertEquals('bar', $password);
+        };
+
+        $emitter = new PublicEmitter();
+        $emitter->listen('\OC\User', 'preSetPassword', $hook);
+        $emitter->listen('\OC\User', 'postSetPassword', $hook);
+
+        $backend->expects($this->any())
+            ->method('implementsActions')
+            ->willReturnCallback(function ($actions) {
+                if ($actions === \OC\User\Backend::SET_PASSWORD) {
+                    return true;
+                } else {
+                    return false;
+                }
+            });
+
+        $user = new User('foo', $backend, $this->dispatcher, $emitter);
+
+        $user->setPassword('bar', '');
+        $this->assertEquals(2, $hooksCalled);
+    }
+
+    public static function dataDeleteHooks(): array {
+        return [
+            [true, 2],
+            [false, 1],
+        ];
+    }
+
+    /**
+     * @dataProvider dataDeleteHooks
+     * @param bool $result
+     * @param int $expectedHooks
+     */
+    public function testDeleteHooks($result, $expectedHooks): void {
+        $hooksCalled = 0;
+        $test = $this;
+
+        /**
+         * @var UserInterface&MockObject $backend
+         */
+        $backend = $this->createMock(\Test\Util\User\Dummy::class);
+        $backend->expects($this->once())
+            ->method('deleteUser')
+            ->willReturn($result);
+
+        $config = $this->createMock(IConfig::class);
+        $config->method('getSystemValue')
+            ->willReturnArgument(1);
+        $config->method('getSystemValueString')
+            ->willReturnArgument(1);
+        $config->method('getSystemValueBool')
+            ->willReturnArgument(1);
+        $config->method('getSystemValueInt')
+            ->willReturnArgument(1);
+
+        $emitter = new PublicEmitter();
+        $user = new User('foo', $backend, $this->dispatcher, $emitter, $config);
+
+        /**
+         * @param User $user
+         */
+        $hook = function ($user) use ($test, &$hooksCalled) {
+            $hooksCalled++;
+            $test->assertEquals('foo', $user->getUID());
+        };
+
+        $emitter->listen('\OC\User', 'preDelete', $hook);
+        $emitter->listen('\OC\User', 'postDelete', $hook);
+
+        $commentsManager = $this->createMock(ICommentsManager::class);
+        $notificationManager = $this->createMock(INotificationManager::class);
+
+        if ($result) {
+            $config->expects($this->atLeastOnce())
+                ->method('deleteAllUserValues')
+                ->with('foo');
+
+            $commentsManager->expects($this->once())
+                ->method('deleteReferencesOfActor')
+                ->with('users', 'foo');
+            $commentsManager->expects($this->once())
+                ->method('deleteReadMarksFromUser')
+                ->with($user);
+
+            $notification = $this->createMock(INotification::class);
+            $notification->expects($this->once())
+                ->method('setUser')
+                ->with('foo');
+
+            $notificationManager->expects($this->once())
+                ->method('createNotification')
+                ->willReturn($notification);
+            $notificationManager->expects($this->once())
+                ->method('markProcessed')
+                ->with($notification);
+        } else {
+            $config->expects($this->never())
+                ->method('deleteAllUserValues');
+
+            $commentsManager->expects($this->never())
+                ->method('deleteReferencesOfActor');
+            $commentsManager->expects($this->never())
+                ->method('deleteReadMarksFromUser');
+
+            $notificationManager->expects($this->never())
+                ->method('createNotification');
+            $notificationManager->expects($this->never())
+                ->method('markProcessed');
+        }
+
+        $this->overwriteService(\OCP\Notification\IManager::class, $notificationManager);
+        $this->overwriteService(\OCP\Comments\ICommentsManager::class, $commentsManager);
+
+        $this->assertSame($result, $user->delete());
+
+        $this->restoreService(AllConfig::class);
+        $this->restoreService(\OCP\Comments\ICommentsManager::class);
+        $this->restoreService(\OCP\Notification\IManager::class);
+
+        $this->assertEquals($expectedHooks, $hooksCalled);
+    }
+
+    public function testDeleteRecoverState() {
+        $backend = $this->createMock(\Test\Util\User\Dummy::class);
+        $backend->expects($this->once())
+            ->method('deleteUser')
+            ->willReturn(true);
+
+        $config = $this->createMock(IConfig::class);
+        $config->method('getSystemValue')
+            ->willReturnArgument(1);
+        $config->method('getSystemValueString')
+            ->willReturnArgument(1);
+        $config->method('getSystemValueBool')
+            ->willReturnArgument(1);
+        $config->method('getSystemValueInt')
+            ->willReturnArgument(1);
+
+        $userConfig = [];
+        $config->expects(self::atLeast(2))
+            ->method('setUserValue')
+            ->willReturnCallback(function () {
+                $userConfig[] = func_get_args();
+            });
+
+        $commentsManager = $this->createMock(ICommentsManager::class);
+        $commentsManager->expects($this->once())
+            ->method('deleteReferencesOfActor')
+            ->willThrowException(new \Error('Test exception'));
+
+        $this->overwriteService(\OCP\Comments\ICommentsManager::class, $commentsManager);
+        $this->expectException(\Error::class);
+
+        $user = $this->getMockBuilder(User::class)
+            ->onlyMethods(['getHome'])
+            ->setConstructorArgs(['foo', $backend, $this->dispatcher, null, $config])
+            ->getMock();
+
+        $user->expects(self::atLeastOnce())
+            ->method('getHome')
+            ->willReturn('/home/path');
+
+        $user->delete();
+
+        $this->assertEqualsCanonicalizing(
+            [
+                ['foo', 'core', 'deleted', 'true', null],
+                ['foo', 'core', 'deleted.backup-home', '/home/path', null],
+            ],
+            $userConfig,
+        );
+
+        $this->restoreService(\OCP\Comments\ICommentsManager::class);
+    }
+
+    public static function dataGetCloudId(): array {
+        return [
+            ['https://localhost:8888/nextcloud', 'foo@localhost:8888/nextcloud'],
+            ['http://localhost:8888/nextcloud', 'foo@http://localhost:8888/nextcloud'],
+        ];
+    }
+
+    /**
+     * @dataProvider dataGetCloudId
+     */
+    public function testGetCloudId(string $absoluteUrl, string $cloudId): void {
+        /** @var Backend|MockObject $backend */
+        $backend = $this->createMock(\Test\Util\User\Dummy::class);
+        $urlGenerator = $this->createMock(IURLGenerator::class);
+        $urlGenerator->method('getAbsoluteURL')
+            ->withAnyParameters()
+            ->willReturn($absoluteUrl);
+        $user = new User('foo', $backend, $this->dispatcher, null, null, $urlGenerator);
+        $this->assertEquals($cloudId, $user->getCloudId());
+    }
+
+    public function testSetEMailAddressEmpty(): void {
+        /**
+         * @var Backend | MockObject $backend
+         */
+        $backend = $this->createMock(\Test\Util\User\Dummy::class);
+
+        $test = $this;
+        $hooksCalled = 0;
+
+        /**
+         * @param IUser $user
+         * @param string $feature
+         * @param string $value
+         */
+        $hook = function (IUser $user, $feature, $value) use ($test, &$hooksCalled) {
+            $hooksCalled++;
+            $test->assertEquals('eMailAddress', $feature);
+            $test->assertEquals('', $value);
+        };
+
+        $emitter = new PublicEmitter();
+        $emitter->listen('\OC\User', 'changeUser', $hook);
+
+        $config = $this->createMock(IConfig::class);
+        $config->expects($this->once())
+            ->method('deleteUserValue')
+            ->with(
+                'foo',
+                'settings',
+                'email'
+            );
+
+        $user = new User('foo', $backend, $this->dispatcher, $emitter, $config);
+        $user->setEMailAddress('');
+    }
+
+    public function testSetEMailAddress(): void {
+        /**
+         * @var UserInterface | MockObject $backend
+         */
+        $backend = $this->createMock(\Test\Util\User\Dummy::class);
+
+        $test = $this;
+        $hooksCalled = 0;
+
+        /**
+         * @param IUser $user
+         * @param string $feature
+         * @param string $value
+         */
+        $hook = function (IUser $user, $feature, $value) use ($test, &$hooksCalled) {
+            $hooksCalled++;
+            $test->assertEquals('eMailAddress', $feature);
+            $test->assertEquals('foo@bar.com', $value);
+        };
+
+        $emitter = new PublicEmitter();
+        $emitter->listen('\OC\User', 'changeUser', $hook);
+
+        $config = $this->createMock(IConfig::class);
+        $config->expects($this->once())
+            ->method('setUserValue')
+            ->with(
+                'foo',
+                'settings',
+                'email',
+                'foo@bar.com'
+            );
+
+        $user = new User('foo', $backend, $this->dispatcher, $emitter, $config);
+        $user->setEMailAddress('foo@bar.com');
+    }
+
+    public function testSetEMailAddressNoChange(): void {
+        /**
+         * @var UserInterface | MockObject $backend
+         */
+        $backend = $this->createMock(\Test\Util\User\Dummy::class);
+
+        /** @var PublicEmitter|MockObject $emitter */
+        $emitter = $this->createMock(PublicEmitter::class);
+        $emitter->expects($this->never())
+            ->method('emit');
+
+        $dispatcher = $this->createMock(IEventDispatcher::class);
+        $dispatcher->expects($this->never())
+            ->method('dispatch');
+
+        $config = $this->createMock(IConfig::class);
+        $config->expects($this->any())
+            ->method('getUserValue')
+            ->willReturn('foo@bar.com');
+        $config->expects($this->any())
+            ->method('setUserValue');
+
+        $user = new User('foo', $backend, $dispatcher, $emitter, $config);
+        $user->setEMailAddress('foo@bar.com');
+    }
+
+    public function testSetQuota(): void {
+        /**
+         * @var UserInterface | MockObject $backend
+         */
+        $backend = $this->createMock(\Test\Util\User\Dummy::class);
+
+        $test = $this;
+        $hooksCalled = 0;
+
+        /**
+         * @param IUser $user
+         * @param string $feature
+         * @param string $value
+         */
+        $hook = function (IUser $user, $feature, $value) use ($test, &$hooksCalled) {
+            $hooksCalled++;
+            $test->assertEquals('quota', $feature);
+            $test->assertEquals('23 TB', $value);
+        };
+
+        $emitter = new PublicEmitter();
+        $emitter->listen('\OC\User', 'changeUser', $hook);
+
+        $config = $this->createMock(IConfig::class);
+        $config->expects($this->once())
+            ->method('setUserValue')
+            ->with(
+                'foo',
+                'files',
+                'quota',
+                '23 TB'
+            );
+
+        $user = new User('foo', $backend, $this->dispatcher, $emitter, $config);
+        $user->setQuota('23 TB');
+    }
+
+    public function testGetDefaultUnlimitedQuota(): void {
+        /**
+         * @var UserInterface | MockObject $backend
+         */
+        $backend = $this->createMock(\Test\Util\User\Dummy::class);
+
+        /** @var PublicEmitter|MockObject $emitter */
+        $emitter = $this->createMock(PublicEmitter::class);
+        $emitter->expects($this->never())
+            ->method('emit');
+
+        $config = $this->createMock(IConfig::class);
+        $user = new User('foo', $backend, $this->dispatcher, $emitter, $config);
+
+        $userValueMap = [
+            ['foo', 'files', 'quota', 'default', 'default'],
+        ];
+        $appValueMap = [
+            ['files', 'default_quota', 'none', 'none'],
+            // allow unlimited quota
+            ['files', 'allow_unlimited_quota', '1', '1'],
+        ];
+        $config->method('getUserValue')
+            ->will($this->returnValueMap($userValueMap));
+        $config->method('getAppValue')
+            ->will($this->returnValueMap($appValueMap));
+
+        $this->assertEquals('none', $user->getQuota());
+        $this->assertEquals(FileInfo::SPACE_UNLIMITED, $user->getQuotaBytes());
+    }
+
+    public function testGetDefaultUnlimitedQuotaForbidden(): void {
+        /**
+         * @var UserInterface | MockObject $backend
+         */
+        $backend = $this->createMock(\Test\Util\User\Dummy::class);
+
+        /** @var PublicEmitter|MockObject $emitter */
+        $emitter = $this->createMock(PublicEmitter::class);
+        $emitter->expects($this->never())
+            ->method('emit');
+
+        $config = $this->createMock(IConfig::class);
+        $user = new User('foo', $backend, $this->dispatcher, $emitter, $config);
+
+        $userValueMap = [
+            ['foo', 'files', 'quota', 'default', 'default'],
+        ];
+        $appValueMap = [
+            ['files', 'default_quota', 'none', 'none'],
+            // do not allow unlimited quota
+            ['files', 'allow_unlimited_quota', '1', '0'],
+            ['files', 'quota_preset', '1 GB, 5 GB, 10 GB', '1 GB, 5 GB, 10 GB'],
+            // expect seeing 1 GB used as fallback value
+            ['files', 'default_quota', '1 GB', '1 GB'],
+        ];
+        $config->method('getUserValue')
+            ->will($this->returnValueMap($userValueMap));
+        $config->method('getAppValue')
+            ->will($this->returnValueMap($appValueMap));
+
+        $this->assertEquals('1 GB', $user->getQuota());
+        $this->assertEquals(1024 * 1024 * 1024, $user->getQuotaBytes());
+    }
+
+    public function testSetQuotaAddressNoChange(): void {
+        /**
+         * @var UserInterface | MockObject $backend
+         */
+        $backend = $this->createMock(\Test\Util\User\Dummy::class);
+
+        /** @var PublicEmitter|MockObject $emitter */
+        $emitter = $this->createMock(PublicEmitter::class);
+        $emitter->expects($this->never())
+            ->method('emit');
+
+        $config = $this->createMock(IConfig::class);
+        $config->expects($this->any())
+            ->method('getUserValue')
+            ->willReturn('23 TB');
+        $config->expects($this->never())
+            ->method('setUserValue');
+
+        $user = new User('foo', $backend, $this->dispatcher, $emitter, $config);
+        $user->setQuota('23 TB');
+    }
+
+    public function testGetLastLogin(): void {
+        /**
+         * @var Backend | MockObject $backend
+         */
+        $backend = $this->createMock(\Test\Util\User\Dummy::class);
+
+        $config = $this->createMock(IConfig::class);
+        $config->method('getUserValue')
+            ->willReturnCallback(function ($uid, $app, $key, $default) {
+                if ($uid === 'foo' && $app === 'login' && $key === 'lastLogin') {
+                    return 42;
+                } else {
+                    return $default;
+                }
+            });
+
+        $user = new User('foo', $backend, $this->dispatcher, null, $config);
+        $this->assertSame(42, $user->getLastLogin());
+    }
+
+    public function testSetEnabled(): void {
+        /**
+         * @var Backend | MockObject $backend
+         */
+        $backend = $this->createMock(\Test\Util\User\Dummy::class);
+
+        $config = $this->createMock(IConfig::class);
+        $config->expects($this->once())
+            ->method('setUserValue')
+            ->with(
+                $this->equalTo('foo'),
+                $this->equalTo('core'),
+                $this->equalTo('enabled'),
+                'true'
+            );
+        /* dav event listener gets the manager list from config */
+        $config->expects(self::any())
+            ->method('getUserValue')
+            ->willReturnCallback(
+                fn ($user, $app, $key, $default) => ($key === 'enabled' ? 'false' : $default)
+            );
+
+        $user = new User('foo', $backend, $this->dispatcher, null, $config);
+        $user->setEnabled(true);
+    }
+
+    public function testSetDisabled(): void {
+        /**
+         * @var Backend | MockObject $backend
+         */
+        $backend = $this->createMock(\Test\Util\User\Dummy::class);
+
+        $config = $this->createMock(IConfig::class);
+        $config->expects($this->once())
+            ->method('setUserValue')
+            ->with(
+                $this->equalTo('foo'),
+                $this->equalTo('core'),
+                $this->equalTo('enabled'),
+                'false'
+            );
+
+        $user = $this->getMockBuilder(User::class)
+            ->setConstructorArgs([
+                'foo',
+                $backend,
+                $this->dispatcher,
+                null,
+                $config,
+            ])
+            ->onlyMethods(['isEnabled', 'triggerChange'])
+            ->getMock();
+
+        $user->expects($this->once())
+            ->method('isEnabled')
+            ->willReturn(true);
+        $user->expects($this->once())
+            ->method('triggerChange')
+            ->with(
+                'enabled',
+                false
+            );
+
+        $user->setEnabled(false);
+    }
+
+    public function testSetDisabledAlreadyDisabled(): void {
+        /**
+         * @var Backend | MockObject $backend
+         */
+        $backend = $this->createMock(\Test\Util\User\Dummy::class);
+
+        $config = $this->createMock(IConfig::class);
+        $config->expects($this->never())
+            ->method('setUserValue');
+
+        $user = $this->getMockBuilder(User::class)
+            ->setConstructorArgs([
+                'foo',
+                $backend,
+                $this->dispatcher,
+                null,
+                $config,
+            ])
+            ->onlyMethods(['isEnabled', 'triggerChange'])
+            ->getMock();
+
+        $user->expects($this->once())
+            ->method('isEnabled')
+            ->willReturn(false);
+        $user->expects($this->never())
+            ->method('triggerChange');
+
+        $user->setEnabled(false);
+    }
+
+    public function testGetEMailAddress(): void {
+        /**
+         * @var Backend | MockObject $backend
+         */
+        $backend = $this->createMock(\Test\Util\User\Dummy::class);
+
+        $config = $this->createMock(IConfig::class);
+        $config->method('getUserValue')
+            ->willReturnCallback(function ($uid, $app, $key, $default) {
+                if ($uid === 'foo' && $app === 'settings' && $key === 'email') {
+                    return 'foo@bar.com';
+                } else {
+                    return $default;
+                }
+            });
+
+        $user = new User('foo', $backend, $this->dispatcher, null, $config);
+        $this->assertSame('foo@bar.com', $user->getEMailAddress());
+    }
 }