nextcloud/lib/private/User/User.php

444 lines
11 KiB
PHP
Raw Normal View History

2013-05-29 01:46:57 +04:00
<?php
/**
2016-07-21 18:07:57 +03:00
* @copyright Copyright (c) 2016, ownCloud, Inc.
*
2016-05-26 20:56:05 +03:00
* @author Arthur Schiwon <blizzz@arthur-schiwon.de>
2015-03-26 13:44:34 +03:00
* @author Bart Visscher <bartv@thisnet.nl>
2016-05-26 20:56:05 +03:00
* @author Björn Schießle <bjoern@schiessle.org>
* @author Jörn Friedrich Dreyer <jfd@butonic.de>
2016-05-26 20:56:05 +03:00
* @author Lukas Reschke <lukas@statuscode.ch>
2015-03-26 13:44:34 +03:00
* @author Morris Jobke <hey@morrisjobke.de>
2016-07-21 19:13:36 +03:00
* @author Robin Appelman <robin@icewind.nl>
2016-07-21 18:07:57 +03:00
* @author Roeland Jago Douma <roeland@famdouma.nl>
2015-03-26 13:44:34 +03:00
* @author Thomas Müller <thomas.mueller@tmit.eu>
*
* @license AGPL-3.0
*
* This code is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License, version 3,
* as published by the Free Software Foundation.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Affero General Public License for more details.
*
* You should have received a copy of the GNU Affero General Public License, version 3,
* along with this program. If not, see <http://www.gnu.org/licenses/>
*
2013-05-29 01:46:57 +04:00
*/
2013-05-29 01:46:57 +04:00
namespace OC\User;
2016-08-11 10:52:02 +03:00
use OC\Files\Cache\Storage;
2013-05-29 01:46:57 +04:00
use OC\Hooks\Emitter;
use OC_Helper;
use OCP\IAvatarManager;
use OCP\IImage;
2015-11-30 15:57:54 +03:00
use OCP\IURLGenerator;
use OCP\IUser;
2014-11-27 20:19:14 +03:00
use OCP\IConfig;
use OCP\UserInterface;
2016-08-11 10:52:02 +03:00
use \OCP\IUserBackend;
2013-05-29 01:46:57 +04:00
class User implements IUser {
2015-11-30 15:57:54 +03:00
/** @var string $uid */
2013-05-29 01:46:57 +04:00
private $uid;
2015-11-30 15:57:54 +03:00
/** @var string $displayName */
2013-05-29 01:46:57 +04:00
private $displayName;
/** @var UserInterface $backend */
2013-05-29 01:46:57 +04:00
private $backend;
2015-11-30 15:57:54 +03:00
/** @var bool $enabled */
2013-05-29 01:46:57 +04:00
private $enabled;
2015-11-30 15:57:54 +03:00
/** @var Emitter|Manager $emitter */
2013-05-29 01:46:57 +04:00
private $emitter;
2015-11-30 15:57:54 +03:00
/** @var string $home */
2013-12-11 19:22:26 +04:00
private $home;
2015-11-30 15:57:54 +03:00
/** @var int $lastLogin */
private $lastLogin;
2015-11-30 15:57:54 +03:00
/** @var \OCP\IConfig $config */
private $config;
/** @var IAvatarManager */
private $avatarManager;
2015-11-30 15:57:54 +03:00
/** @var IURLGenerator */
private $urlGenerator;
2013-05-29 01:46:57 +04:00
/**
* @param string $uid
* @param UserInterface $backend
* @param \OC\Hooks\Emitter $emitter
2015-12-02 16:25:07 +03:00
* @param IConfig|null $config
* @param IURLGenerator $urlGenerator
2013-05-29 01:46:57 +04:00
*/
2015-12-02 16:25:07 +03:00
public function __construct($uid, $backend, $emitter = null, IConfig $config = null, $urlGenerator = null) {
2013-05-29 01:46:57 +04:00
$this->uid = $uid;
$this->backend = $backend;
$this->emitter = $emitter;
if(is_null($config)) {
$config = \OC::$server->getConfig();
}
$this->config = $config;
2015-12-01 16:50:13 +03:00
$this->urlGenerator = $urlGenerator;
$enabled = $this->config->getUserValue($uid, 'core', 'enabled', 'true');
$this->enabled = ($enabled === 'true');
$this->lastLogin = $this->config->getUserValue($uid, 'login', 'lastLogin', 0);
2015-11-30 15:57:54 +03:00
if (is_null($this->urlGenerator)) {
$this->urlGenerator = \OC::$server->getURLGenerator();
}
2013-05-29 01:46:57 +04:00
}
/**
2013-06-03 15:33:56 +04:00
* get the user id
*
2013-05-29 01:46:57 +04:00
* @return string
*/
public function getUID() {
return $this->uid;
}
/**
2015-12-02 16:25:07 +03:00
* get the display name for the user, if no specific display name is set it will fallback to the user id
2013-06-03 15:33:56 +04:00
*
2013-05-29 01:46:57 +04:00
* @return string
*/
public function getDisplayName() {
if (!isset($this->displayName)) {
$displayName = '';
2016-08-11 10:52:02 +03:00
if ($this->backend and $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;
}
}
2013-05-29 01:46:57 +04:00
return $this->displayName;
}
/**
2013-06-03 15:33:56 +04:00
* set the displayname for the user
*
2013-05-29 01:46:57 +04:00
* @param string $displayName
* @return bool
*/
public function setDisplayName($displayName) {
$displayName = trim($displayName);
2016-08-11 10:52:02 +03:00
if ($this->backend->implementsActions(Backend::SET_DISPLAYNAME) && !empty($displayName)) {
2013-06-03 15:39:34 +04:00
$result = $this->backend->setDisplayName($this->uid, $displayName);
if ($result) {
$this->displayName = $displayName;
$this->triggerChange('displayName', $displayName);
}
2013-06-03 15:39:34 +04:00
return $result !== false;
2013-05-29 01:46:57 +04:00
} else {
return false;
}
}
/**
* set the email address of the user
*
* @param string|null $mailAddress
* @return void
* @since 9.0.0
*/
public function setEMailAddress($mailAddress) {
if($mailAddress === '') {
$this->config->deleteUserValue($this->uid, 'settings', 'email');
} else {
$this->config->setUserValue($this->uid, 'settings', 'email', $mailAddress);
}
$this->triggerChange('eMailAddress', $mailAddress);
}
/**
* returns the timestamp of the user's last login or 0 if the user did never
* login
*
* @return int
*/
public function getLastLogin() {
return $this->lastLogin;
}
/**
* updates the timestamp of the most recent login of this user
*/
public function updateLastLoginTimestamp() {
$firstTimeLogin = ($this->lastLogin === 0);
$this->lastLogin = time();
$this->config->setUserValue(
$this->uid, 'login', 'lastLogin', $this->lastLogin);
return $firstTimeLogin;
}
2013-05-29 01:46:57 +04:00
/**
2013-06-03 15:33:56 +04:00
* Delete the user
*
2013-05-29 01:46:57 +04:00
* @return bool
*/
public function delete() {
if ($this->emitter) {
$this->emitter->emit('\OC\User', 'preDelete', array($this));
}
// get the home now because it won't return it after user deletion
$homePath = $this->getHome();
2013-05-29 01:46:57 +04:00
$result = $this->backend->deleteUser($this->uid);
if ($result) {
// FIXME: Feels like an hack - suggestions?
$groupManager = \OC::$server->getGroupManager();
// We have to delete the user from all groups
foreach ($groupManager->getUserGroupIds($this) as $groupId) {
$group = $groupManager->get($groupId);
if ($group) {
\OC_Hook::emit("OC_Group", "pre_removeFromGroup", ["run" => true, "uid" => $this->uid, "gid" => $groupId]);
$group->removeUser($this);
\OC_Hook::emit("OC_User", "post_removeFromGroup", ["uid" => $this->uid, "gid" => $groupId]);
}
}
// Delete the user's keys in preferences
\OC::$server->getConfig()->deleteAllUserValues($this->uid);
// Delete user files in /data/
if ($homePath !== false) {
// FIXME: this operates directly on FS, should use View instead...
// also this is not testable/mockable...
\OC_Helper::rmdirr($homePath);
}
// Delete the users entry in the storage table
2016-08-11 10:52:02 +03:00
Storage::remove('home::' . $this->uid);
2016-02-03 21:28:15 +03:00
\OC::$server->getCommentsManager()->deleteReferencesOfActor('users', $this->uid);
\OC::$server->getCommentsManager()->deleteReadMarksFromUser($this);
$notification = \OC::$server->getNotificationManager()->createNotification();
$notification->setUser($this->uid);
\OC::$server->getNotificationManager()->markProcessed($notification);
if ($this->emitter) {
$this->emitter->emit('\OC\User', 'postDelete', array($this));
}
2013-05-29 01:46:57 +04:00
}
return !($result === false);
}
/**
2013-06-03 15:33:56 +04:00
* Set the password of the user
*
2013-05-29 01:46:57 +04:00
* @param string $password
* @param string $recoveryPassword for the encryption app to reset encryption keys
* @return bool
*/
public function setPassword($password, $recoveryPassword = null) {
if ($this->emitter) {
$this->emitter->emit('\OC\User', 'preSetPassword', array($this, $password, $recoveryPassword));
}
2016-08-11 10:52:02 +03:00
if ($this->backend->implementsActions(Backend::SET_PASSWORD)) {
2013-05-29 01:46:57 +04:00
$result = $this->backend->setPassword($this->uid, $password);
if ($this->emitter) {
$this->emitter->emit('\OC\User', 'postSetPassword', array($this, $password, $recoveryPassword));
}
return !($result === false);
} else {
return false;
}
}
/**
* get the users home folder to mount
*
* @return string
*/
public function getHome() {
2013-12-11 19:22:26 +04:00
if (!$this->home) {
2016-08-11 10:52:02 +03:00
if ($this->backend->implementsActions(Backend::GET_HOME) and $home = $this->backend->getHome($this->uid)) {
2013-12-11 19:22:26 +04:00
$this->home = $home;
} elseif ($this->config) {
$this->home = $this->config->getSystemValue('datadirectory', \OC::$SERVERROOT . '/data') . '/' . $this->uid;
} else {
$this->home = \OC::$SERVERROOT . '/data/' . $this->uid;
2013-12-11 19:22:26 +04:00
}
2013-05-29 01:46:57 +04:00
}
2013-12-11 19:22:26 +04:00
return $this->home;
2013-05-29 01:46:57 +04:00
}
/**
* Get the name of the backend class the user is connected with
*
* @return string
*/
public function getBackendClassName() {
2016-08-11 10:52:02 +03:00
if($this->backend instanceof IUserBackend) {
return $this->backend->getBackendName();
}
return get_class($this->backend);
}
/**
* check if the backend allows the user to change his avatar on Personal page
*
* @return bool
*/
public function canChangeAvatar() {
2016-08-11 10:52:02 +03:00
if ($this->backend->implementsActions(Backend::PROVIDE_AVATAR)) {
return $this->backend->canChangeAvatar($this->uid);
}
return true;
}
2013-05-29 01:46:57 +04:00
/**
2013-06-03 15:33:56 +04:00
* check if the backend supports changing passwords
*
2013-05-29 01:46:57 +04:00
* @return bool
*/
public function canChangePassword() {
2016-08-11 10:52:02 +03:00
return $this->backend->implementsActions(Backend::SET_PASSWORD);
2013-05-29 01:46:57 +04:00
}
/**
2013-06-03 15:33:56 +04:00
* check if the backend supports changing display names
*
2013-05-29 01:46:57 +04:00
* @return bool
*/
public function canChangeDisplayName() {
if ($this->config->getSystemValue('allow_user_to_change_display_name') === false) {
return false;
}
2016-08-11 10:52:02 +03:00
return $this->backend->implementsActions(Backend::SET_DISPLAYNAME);
2013-05-29 01:46:57 +04:00
}
/**
2013-06-03 15:33:56 +04:00
* check if the user is enabled
*
2013-05-29 01:46:57 +04:00
* @return bool
*/
public function isEnabled() {
return $this->enabled;
}
/**
2013-06-03 15:33:56 +04:00
* set the enabled status for the user
*
2013-05-29 01:46:57 +04:00
* @param bool $enabled
*/
public function setEnabled($enabled) {
$this->enabled = $enabled;
$enabled = ($enabled) ? 'true' : 'false';
$this->config->setUserValue($this->uid, 'core', 'enabled', $enabled);
2013-05-29 01:46:57 +04:00
}
/**
* get the users email address
*
* @return string|null
* @since 9.0.0
*/
public function getEMailAddress() {
return $this->config->getUserValue($this->uid, 'settings', 'email', null);
}
/**
* get the users' quota
*
* @return string
* @since 9.0.0
*/
public function getQuota() {
$quota = $this->config->getUserValue($this->uid, 'files', 'quota', 'default');
if($quota === 'default') {
$quota = $this->config->getAppValue('files', 'default_quota', 'none');
}
return $quota;
}
/**
* set the users' quota
*
* @param string $quota
* @return void
* @since 9.0.0
*/
public function setQuota($quota) {
if($quota !== 'none' and $quota !== 'default') {
2016-02-09 19:41:04 +03:00
$quota = OC_Helper::computerFileSize($quota);
$quota = OC_Helper::humanFileSize($quota);
}
$this->config->setUserValue($this->uid, 'files', 'quota', $quota);
$this->triggerChange('quota', $quota);
}
/**
* get the avatar image if it exists
*
* @param int $size
* @return IImage|null
* @since 9.0.0
*/
public function getAvatarImage($size) {
2015-12-02 16:25:07 +03:00
// delay the initialization
if (is_null($this->avatarManager)) {
$this->avatarManager = \OC::$server->getAvatarManager();
}
$avatar = $this->avatarManager->getAvatar($this->uid);
$image = $avatar->get(-1);
if ($image) {
return $image;
}
return null;
}
2015-11-30 15:57:54 +03:00
/**
* get the federation cloud id
*
* @return string
* @since 9.0.0
*/
public function getCloudId() {
$uid = $this->getUID();
$server = $this->urlGenerator->getAbsoluteURL('/');
$server = rtrim( $this->removeProtocolFromUrl($server), '/');
return \OC::$server->getCloudIdManager()->getCloudId($uid, $server)->getId();
2015-11-30 15:57:54 +03:00
}
/**
* @param string $url
* @return string
*/
private function removeProtocolFromUrl($url) {
if (strpos($url, 'https://') === 0) {
return substr($url, strlen('https://'));
} else if (strpos($url, 'http://') === 0) {
return substr($url, strlen('http://'));
}
return $url;
}
public function triggerChange($feature, $value = null) {
if ($this->emitter) {
$this->emitter->emit('\OC\User', 'changeUser', array($this, $feature, $value));
}
}
2013-05-29 01:46:57 +04:00
}