You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

191 lines
4.5 KiB

3 years ago
  1. <?php
  2. /**
  3. * @copyright Copyright (c) 2016, ownCloud, Inc.
  4. *
  5. * @author Arthur Schiwon <blizzz@arthur-schiwon.de>
  6. * @author Christoph Wurst <christoph@winzerhof-wurst.at>
  7. * @author Joas Schilling <coding@schilljs.com>
  8. * @author Jörn Friedrich Dreyer <jfd@butonic.de>
  9. * @author Lukas Reschke <lukas@statuscode.ch>
  10. * @author Morris Jobke <hey@morrisjobke.de>
  11. * @author Robin Appelman <robin@icewind.nl>
  12. * @author Roeland Jago Douma <roeland@famdouma.nl>
  13. * @author Thomas Müller <thomas.mueller@tmit.eu>
  14. *
  15. * @license AGPL-3.0
  16. *
  17. * This code is free software: you can redistribute it and/or modify
  18. * it under the terms of the GNU Affero General Public License, version 3,
  19. * as published by the Free Software Foundation.
  20. *
  21. * This program is distributed in the hope that it will be useful,
  22. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  23. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  24. * GNU Affero General Public License for more details.
  25. *
  26. * You should have received a copy of the GNU Affero General Public License, version 3,
  27. * along with this program. If not, see <http://www.gnu.org/licenses/>
  28. *
  29. */
  30. namespace OCP;
  31. /**
  32. * Class Manager
  33. *
  34. * Hooks available in scope \OC\User:
  35. * - preSetPassword(\OC\User\User $user, string $password, string $recoverPassword)
  36. * - postSetPassword(\OC\User\User $user, string $password, string $recoverPassword)
  37. * - preDelete(\OC\User\User $user)
  38. * - postDelete(\OC\User\User $user)
  39. * - preCreateUser(string $uid, string $password)
  40. * - postCreateUser(\OC\User\User $user, string $password)
  41. * - assignedUserId(string $uid)
  42. * - preUnassignedUserId(string $uid)
  43. * - postUnassignedUserId(string $uid)
  44. *
  45. * @since 8.0.0
  46. */
  47. interface IUserManager {
  48. /**
  49. * register a user backend
  50. *
  51. * @param \OCP\UserInterface $backend
  52. * @since 8.0.0
  53. */
  54. public function registerBackend($backend);
  55. /**
  56. * Get the active backends
  57. * @return \OCP\UserInterface[]
  58. * @since 8.0.0
  59. */
  60. public function getBackends();
  61. /**
  62. * remove a user backend
  63. *
  64. * @param \OCP\UserInterface $backend
  65. * @since 8.0.0
  66. */
  67. public function removeBackend($backend);
  68. /**
  69. * remove all user backends
  70. * @since 8.0.0
  71. */
  72. public function clearBackends() ;
  73. /**
  74. * get a user by user id
  75. *
  76. * @param string $uid
  77. * @return \OCP\IUser|null Either the user or null if the specified user does not exist
  78. * @since 8.0.0
  79. */
  80. public function get($uid);
  81. /**
  82. * check if a user exists
  83. *
  84. * @param string $uid
  85. * @return bool
  86. * @since 8.0.0
  87. */
  88. public function userExists($uid);
  89. /**
  90. * Check if the password is valid for the user
  91. *
  92. * @param string $loginName
  93. * @param string $password
  94. * @return mixed the User object on success, false otherwise
  95. * @since 8.0.0
  96. */
  97. public function checkPassword($loginName, $password);
  98. /**
  99. * search by user id
  100. *
  101. * @param string $pattern
  102. * @param int $limit
  103. * @param int $offset
  104. * @return \OCP\IUser[]
  105. * @since 8.0.0
  106. */
  107. public function search($pattern, $limit = null, $offset = null);
  108. /**
  109. * search by displayName
  110. *
  111. * @param string $pattern
  112. * @param int $limit
  113. * @param int $offset
  114. * @return \OCP\IUser[]
  115. * @since 8.0.0
  116. */
  117. public function searchDisplayName($pattern, $limit = null, $offset = null);
  118. /**
  119. * @param string $uid
  120. * @param string $password
  121. * @throws \InvalidArgumentException
  122. * @return bool|\OCP\IUser the created user or false
  123. * @since 8.0.0
  124. */
  125. public function createUser($uid, $password);
  126. /**
  127. * @param string $uid
  128. * @param string $password
  129. * @param UserInterface $backend
  130. * @return IUser|null
  131. * @throws \InvalidArgumentException
  132. * @since 12.0.0
  133. */
  134. public function createUserFromBackend($uid, $password, UserInterface $backend);
  135. /**
  136. * returns how many users per backend exist (if supported by backend)
  137. *
  138. * @return array an array of backend class as key and count number as value
  139. * @since 8.0.0
  140. */
  141. public function countUsers();
  142. /**
  143. * @param \Closure $callback
  144. * @param string $search
  145. * @since 9.0.0
  146. */
  147. public function callForAllUsers(\Closure $callback, $search = '');
  148. /**
  149. * returns how many users have logged in once
  150. *
  151. * @return int
  152. * @since 11.0.0
  153. */
  154. public function countDisabledUsers();
  155. /**
  156. * returns how many users have logged in once
  157. *
  158. * @return int
  159. * @since 11.0.0
  160. */
  161. public function countSeenUsers();
  162. /**
  163. * @param \Closure $callback
  164. * @since 11.0.0
  165. */
  166. public function callForSeenUsers(\Closure $callback);
  167. /**
  168. * @param string $email
  169. * @return IUser[]
  170. * @since 9.1.0
  171. */
  172. public function getByEmail($email);
  173. }