Blame view

sources/lib/private/user/manager.php 7.01 KB
31b7f2792   Kload   Upgrade to ownclo...
1
2
3
4
5
6
7
8
9
10
11
12
  <?php
  
  /**
   * Copyright (c) 2013 Robin Appelman <icewind@owncloud.com>
   * This file is licensed under the Affero General Public License version 3 or
   * later.
   * See the COPYING-README file.
   */
  
  namespace OC\User;
  
  use OC\Hooks\PublicEmitter;
6d9380f96   Cédric Dupont   Update sources OC...
13
  use OCP\IUserManager;
31b7f2792   Kload   Upgrade to ownclo...
14
15
16
17
18
19
20
21
22
23
24
25
26
27
  
  /**
   * Class Manager
   *
   * Hooks available in scope \OC\User:
   * - preSetPassword(\OC\User\User $user, string $password, string $recoverPassword)
   * - postSetPassword(\OC\User\User $user, string $password, string $recoverPassword)
   * - preDelete(\OC\User\User $user)
   * - postDelete(\OC\User\User $user)
   * - preCreateUser(string $uid, string $password)
   * - postCreateUser(\OC\User\User $user, string $password)
   *
   * @package OC\User
   */
6d9380f96   Cédric Dupont   Update sources OC...
28
  class Manager extends PublicEmitter implements IUserManager {
31b7f2792   Kload   Upgrade to ownclo...
29
  	/**
6d9380f96   Cédric Dupont   Update sources OC...
30
  	 * @var \OC_User_Interface[] $backends
31b7f2792   Kload   Upgrade to ownclo...
31
32
33
34
35
36
37
  	 */
  	private $backends = array();
  
  	/**
  	 * @var \OC\User\User[] $cachedUsers
  	 */
  	private $cachedUsers = array();
a293d369c   Kload   Update sources to...
38
39
40
41
42
43
44
45
46
47
  	/**
  	 * @var \OC\AllConfig $config
  	 */
  	private $config;
  
  	/**
  	 * @param \OC\AllConfig $config
  	 */
  	public function __construct($config = null) {
  		$this->config = $config;
31b7f2792   Kload   Upgrade to ownclo...
48
49
50
51
52
53
54
  		$cachedUsers = $this->cachedUsers;
  		$this->listen('\OC\User', 'postDelete', function ($user) use (&$cachedUsers) {
  			$i = array_search($user, $cachedUsers);
  			if ($i !== false) {
  				unset($cachedUsers[$i]);
  			}
  		});
6d9380f96   Cédric Dupont   Update sources OC...
55
56
57
58
59
60
  		$this->listen('\OC\User', 'postLogin', function ($user) {
  			$user->updateLastLoginTimestamp();
  		});
  		$this->listen('\OC\User', 'postRememberedLogin', function ($user) {
  			$user->updateLastLoginTimestamp();
  		});
31b7f2792   Kload   Upgrade to ownclo...
61
62
63
64
65
  	}
  
  	/**
  	 * register a user backend
  	 *
6d9380f96   Cédric Dupont   Update sources OC...
66
  	 * @param \OC_User_Interface $backend
31b7f2792   Kload   Upgrade to ownclo...
67
68
69
70
71
72
73
74
  	 */
  	public function registerBackend($backend) {
  		$this->backends[] = $backend;
  	}
  
  	/**
  	 * remove a user backend
  	 *
6d9380f96   Cédric Dupont   Update sources OC...
75
  	 * @param \OC_User_Interface $backend
31b7f2792   Kload   Upgrade to ownclo...
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
  	 */
  	public function removeBackend($backend) {
  		$this->cachedUsers = array();
  		if (($i = array_search($backend, $this->backends)) !== false) {
  			unset($this->backends[$i]);
  		}
  	}
  
  	/**
  	 * remove all user backends
  	 */
  	public function clearBackends() {
  		$this->cachedUsers = array();
  		$this->backends = array();
  	}
  
  	/**
  	 * get a user by user id
  	 *
  	 * @param string $uid
  	 * @return \OC\User\User
  	 */
  	public function get($uid) {
  		if (isset($this->cachedUsers[$uid])) { //check the cache first to prevent having to loop over the backends
  			return $this->cachedUsers[$uid];
  		}
  		foreach ($this->backends as $backend) {
  			if ($backend->userExists($uid)) {
  				return $this->getUserObject($uid, $backend);
  			}
  		}
  		return null;
  	}
  
  	/**
  	 * get or construct the user object
  	 *
  	 * @param string $uid
6d9380f96   Cédric Dupont   Update sources OC...
114
  	 * @param \OC_User_Interface $backend
31b7f2792   Kload   Upgrade to ownclo...
115
116
117
118
119
120
  	 * @return \OC\User\User
  	 */
  	protected function getUserObject($uid, $backend) {
  		if (isset($this->cachedUsers[$uid])) {
  			return $this->cachedUsers[$uid];
  		}
a293d369c   Kload   Update sources to...
121
  		$this->cachedUsers[$uid] = new User($uid, $backend, $this, $this->config);
31b7f2792   Kload   Upgrade to ownclo...
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
  		return $this->cachedUsers[$uid];
  	}
  
  	/**
  	 * check if a user exists
  	 *
  	 * @param string $uid
  	 * @return bool
  	 */
  	public function userExists($uid) {
  		$user = $this->get($uid);
  		return ($user !== null);
  	}
  
  	/**
  	 * remove deleted user from cache
  	 *
  	 * @param string $uid
  	 * @return bool
  	 */
  	public function delete($uid) {
  		if (isset($this->cachedUsers[$uid])) {
  			unset($this->cachedUsers[$uid]);
  			return true;
  		}
  		return false;
  	}
  
  	/**
  	 * Check if the password is valid for the user
  	 *
6d9380f96   Cédric Dupont   Update sources OC...
153
154
  	 * @param string $loginname
  	 * @param string $password
31b7f2792   Kload   Upgrade to ownclo...
155
156
157
158
  	 * @return mixed the User object on success, false otherwise
  	 */
  	public function checkPassword($loginname, $password) {
  		foreach ($this->backends as $backend) {
a293d369c   Kload   Update sources to...
159
  			if ($backend->implementsActions(\OC_USER_BACKEND_CHECK_PASSWORD)) {
31b7f2792   Kload   Upgrade to ownclo...
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
  				$uid = $backend->checkPassword($loginname, $password);
  				if ($uid !== false) {
  					return $this->getUserObject($uid, $backend);
  				}
  			}
  		}
  		return false;
  	}
  
  	/**
  	 * search by user id
  	 *
  	 * @param string $pattern
  	 * @param int $limit
  	 * @param int $offset
  	 * @return \OC\User\User[]
  	 */
  	public function search($pattern, $limit = null, $offset = null) {
  		$users = array();
  		foreach ($this->backends as $backend) {
  			$backendUsers = $backend->getUsers($pattern, $limit, $offset);
  			if (is_array($backendUsers)) {
  				foreach ($backendUsers as $uid) {
837968727   Kload   [enh] Upgrade to ...
183
  					$users[$uid] = $this->getUserObject($uid, $backend);
31b7f2792   Kload   Upgrade to ownclo...
184
185
186
  				}
  			}
  		}
837968727   Kload   [enh] Upgrade to ...
187
  		uasort($users, function ($a, $b) {
31b7f2792   Kload   Upgrade to ownclo...
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
  			/**
  			 * @var \OC\User\User $a
  			 * @var \OC\User\User $b
  			 */
  			return strcmp($a->getUID(), $b->getUID());
  		});
  		return $users;
  	}
  
  	/**
  	 * search by displayName
  	 *
  	 * @param string $pattern
  	 * @param int $limit
  	 * @param int $offset
  	 * @return \OC\User\User[]
  	 */
  	public function searchDisplayName($pattern, $limit = null, $offset = null) {
  		$users = array();
  		foreach ($this->backends as $backend) {
  			$backendUsers = $backend->getDisplayNames($pattern, $limit, $offset);
  			if (is_array($backendUsers)) {
  				foreach ($backendUsers as $uid => $displayName) {
  					$users[] = $this->getUserObject($uid, $backend);
31b7f2792   Kload   Upgrade to ownclo...
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
  				}
  			}
  		}
  
  		usort($users, function ($a, $b) {
  			/**
  			 * @var \OC\User\User $a
  			 * @var \OC\User\User $b
  			 */
  			return strcmp($a->getDisplayName(), $b->getDisplayName());
  		});
  		return $users;
  	}
  
  	/**
  	 * @param string $uid
  	 * @param string $password
  	 * @throws \Exception
6d9380f96   Cédric Dupont   Update sources OC...
230
  	 * @return bool|\OC\User\User the created user of false
31b7f2792   Kload   Upgrade to ownclo...
231
232
  	 */
  	public function createUser($uid, $password) {
6d9380f96   Cédric Dupont   Update sources OC...
233
  		$l = \OC_L10N::get('lib');
31b7f2792   Kload   Upgrade to ownclo...
234
235
236
  		// Check the name for bad characters
  		// Allowed are: "a-z", "A-Z", "0-9" and "_.@-"
  		if (preg_match('/[^a-zA-Z0-9 _\.@\-]/', $uid)) {
6d9380f96   Cédric Dupont   Update sources OC...
237
238
  			throw new \Exception($l->t('Only the following characters are allowed in a username:'
  				. ' "a-z", "A-Z", "0-9", and "_.@-"'));
31b7f2792   Kload   Upgrade to ownclo...
239
240
241
  		}
  		// No empty username
  		if (trim($uid) == '') {
6d9380f96   Cédric Dupont   Update sources OC...
242
  			throw new \Exception($l->t('A valid username must be provided'));
31b7f2792   Kload   Upgrade to ownclo...
243
244
245
  		}
  		// No empty password
  		if (trim($password) == '') {
6d9380f96   Cédric Dupont   Update sources OC...
246
  			throw new \Exception($l->t('A valid password must be provided'));
31b7f2792   Kload   Upgrade to ownclo...
247
248
249
250
  		}
  
  		// Check if user already exists
  		if ($this->userExists($uid)) {
6d9380f96   Cédric Dupont   Update sources OC...
251
  			throw new \Exception($l->t('The username is already being used'));
31b7f2792   Kload   Upgrade to ownclo...
252
253
254
255
256
257
258
259
260
261
262
263
264
  		}
  
  		$this->emit('\OC\User', 'preCreateUser', array($uid, $password));
  		foreach ($this->backends as $backend) {
  			if ($backend->implementsActions(\OC_USER_BACKEND_CREATE_USER)) {
  				$backend->createUser($uid, $password);
  				$user = $this->getUserObject($uid, $backend);
  				$this->emit('\OC\User', 'postCreateUser', array($user, $password));
  				return $user;
  			}
  		}
  		return false;
  	}
a293d369c   Kload   Update sources to...
265
266
267
268
  
  	/**
  	 * returns how many users per backend exist (if supported by backend)
  	 *
6d9380f96   Cédric Dupont   Update sources OC...
269
  	 * @return array an array of backend class as key and count number as value
a293d369c   Kload   Update sources to...
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
  	 */
  	public function countUsers() {
  		$userCountStatistics = array();
  		foreach ($this->backends as $backend) {
  			if ($backend->implementsActions(\OC_USER_BACKEND_COUNT_USERS)) {
  				$backendusers = $backend->countUsers();
  				if($backendusers !== false) {
  					if(isset($userCountStatistics[get_class($backend)])) {
  						$userCountStatistics[get_class($backend)] += $backendusers;
  					} else {
  						$userCountStatistics[get_class($backend)] = $backendusers;
  					}
  				}
  			}
  		}
  		return $userCountStatistics;
  	}
31b7f2792   Kload   Upgrade to ownclo...
287
  }