@@ -15,5 +15,8 @@ |
||
15 | 15 | |
16 | 16 | interface CanonicalizerInterface |
17 | 17 | { |
18 | + /** |
|
19 | + * @return string |
|
20 | + */ |
|
18 | 21 | public function canonicalize(?string $string): ?string; |
19 | 22 | } |
@@ -15,8 +15,14 @@ discard block |
||
15 | 15 | |
16 | 16 | interface CredentialsHolderInterface |
17 | 17 | { |
18 | + /** |
|
19 | + * @return string|null |
|
20 | + */ |
|
18 | 21 | public function getPlainPassword(): ?string; |
19 | 22 | |
23 | + /** |
|
24 | + * @return void |
|
25 | + */ |
|
20 | 26 | public function setPlainPassword(?string $plainPassword): void; |
21 | 27 | |
22 | 28 | /** |
@@ -29,6 +35,9 @@ discard block |
||
29 | 35 | */ |
30 | 36 | public function getPassword(); |
31 | 37 | |
38 | + /** |
|
39 | + * @return void |
|
40 | + */ |
|
32 | 41 | public function setPassword(?string $encodedPassword): void; |
33 | 42 | |
34 | 43 | /** |
@@ -45,6 +54,7 @@ discard block |
||
45 | 54 | * |
46 | 55 | * This is important if, at any given point, sensitive information like |
47 | 56 | * the plain-text password is stored on this object. |
57 | + * @return void |
|
48 | 58 | */ |
49 | 59 | public function eraseCredentials(); |
50 | 60 | } |
@@ -520,6 +520,9 @@ |
||
520 | 520 | ] = $data; |
521 | 521 | } |
522 | 522 | |
523 | + /** |
|
524 | + * @param \DateTimeInterface|null $date |
|
525 | + */ |
|
523 | 526 | protected function hasExpired(?\DateTimeInterface $date): bool |
524 | 527 | { |
525 | 528 | return null !== $date && new \DateTime() >= $date; |
@@ -15,7 +15,15 @@ |
||
15 | 15 | |
16 | 16 | interface UserAwareInterface |
17 | 17 | { |
18 | + /** |
|
19 | + * @return UserInterface|null |
|
20 | + */ |
|
18 | 21 | public function getUser(): ?UserInterface; |
19 | 22 | |
23 | + /** |
|
24 | + * @param User $user |
|
25 | + * |
|
26 | + * @return void |
|
27 | + */ |
|
20 | 28 | public function setUser(?UserInterface $user); |
21 | 29 | } |
@@ -31,58 +31,120 @@ discard block |
||
31 | 31 | { |
32 | 32 | public const DEFAULT_ROLE = 'ROLE_USER'; |
33 | 33 | |
34 | + /** |
|
35 | + * @return string|null |
|
36 | + */ |
|
34 | 37 | public function getEmail(): ?string; |
35 | 38 | |
39 | + /** |
|
40 | + * @return void |
|
41 | + */ |
|
36 | 42 | public function setEmail(?string $email): void; |
37 | 43 | |
38 | 44 | /** |
39 | 45 | * Gets normalized email (should be used in search and sort queries). |
46 | + * @return string|null |
|
40 | 47 | */ |
41 | 48 | public function getEmailCanonical(): ?string; |
42 | 49 | |
50 | + /** |
|
51 | + * @return void |
|
52 | + */ |
|
43 | 53 | public function setEmailCanonical(?string $emailCanonical): void; |
44 | 54 | |
55 | + /** |
|
56 | + * @return void |
|
57 | + */ |
|
45 | 58 | public function setUsername(?string $username): void; |
46 | 59 | |
47 | 60 | /** |
48 | 61 | * Gets normalized username (should be used in search and sort queries). |
62 | + * @return string|null |
|
49 | 63 | */ |
50 | 64 | public function getUsernameCanonical(): ?string; |
51 | 65 | |
66 | + /** |
|
67 | + * @return void |
|
68 | + */ |
|
52 | 69 | public function setUsernameCanonical(?string $usernameCanonical): void; |
53 | 70 | |
71 | + /** |
|
72 | + * @return void |
|
73 | + */ |
|
54 | 74 | public function setLocked(bool $locked): void; |
55 | 75 | |
76 | + /** |
|
77 | + * @return string|null |
|
78 | + */ |
|
56 | 79 | public function getEmailVerificationToken(): ?string; |
57 | 80 | |
81 | + /** |
|
82 | + * @return void |
|
83 | + */ |
|
58 | 84 | public function setEmailVerificationToken(?string $verificationToken): void; |
59 | 85 | |
86 | + /** |
|
87 | + * @return string|null |
|
88 | + */ |
|
60 | 89 | public function getPasswordResetToken(): ?string; |
61 | 90 | |
91 | + /** |
|
92 | + * @return void |
|
93 | + */ |
|
62 | 94 | public function setPasswordResetToken(?string $passwordResetToken): void; |
63 | 95 | |
96 | + /** |
|
97 | + * @return \DateTimeInterface|null |
|
98 | + */ |
|
64 | 99 | public function getPasswordRequestedAt(): ?\DateTimeInterface; |
65 | 100 | |
101 | + /** |
|
102 | + * @return void |
|
103 | + */ |
|
66 | 104 | public function setPasswordRequestedAt(?\DateTimeInterface $date): void; |
67 | 105 | |
68 | 106 | public function isPasswordRequestNonExpired(\DateInterval $ttl): bool; |
69 | 107 | |
70 | 108 | public function isVerified(): bool; |
71 | 109 | |
110 | + /** |
|
111 | + * @return \DateTimeInterface|null |
|
112 | + */ |
|
72 | 113 | public function getVerifiedAt(): ?\DateTimeInterface; |
73 | 114 | |
115 | + /** |
|
116 | + * @return void |
|
117 | + */ |
|
74 | 118 | public function setVerifiedAt(?\DateTimeInterface $verifiedAt): void; |
75 | 119 | |
120 | + /** |
|
121 | + * @return \DateTimeInterface|null |
|
122 | + */ |
|
76 | 123 | public function getExpiresAt(): ?\DateTimeInterface; |
77 | 124 | |
125 | + /** |
|
126 | + * @return void |
|
127 | + */ |
|
78 | 128 | public function setExpiresAt(?\DateTimeInterface $date): void; |
79 | 129 | |
130 | + /** |
|
131 | + * @return \DateTimeInterface|null |
|
132 | + */ |
|
80 | 133 | public function getCredentialsExpireAt(): ?\DateTimeInterface; |
81 | 134 | |
135 | + /** |
|
136 | + * @return void |
|
137 | + */ |
|
82 | 138 | public function setCredentialsExpireAt(?\DateTimeInterface $date): void; |
83 | 139 | |
140 | + /** |
|
141 | + * @return \DateTimeInterface|null |
|
142 | + */ |
|
84 | 143 | public function getLastLogin(): ?\DateTimeInterface; |
85 | 144 | |
145 | + /** |
|
146 | + * @return void |
|
147 | + */ |
|
86 | 148 | public function setLastLogin(?\DateTimeInterface $time): void; |
87 | 149 | |
88 | 150 | /** |
@@ -95,8 +157,14 @@ discard block |
||
95 | 157 | */ |
96 | 158 | public function hasRole(string $role): bool; |
97 | 159 | |
160 | + /** |
|
161 | + * @return void |
|
162 | + */ |
|
98 | 163 | public function addRole(string $role): void; |
99 | 164 | |
165 | + /** |
|
166 | + * @return void |
|
167 | + */ |
|
100 | 168 | public function removeRole(string $role): void; |
101 | 169 | |
102 | 170 | /** |
@@ -106,7 +174,13 @@ discard block |
||
106 | 174 | |
107 | 175 | public function getOAuthAccount(string $provider): ?UserOAuthInterface; |
108 | 176 | |
177 | + /** |
|
178 | + * @return void |
|
179 | + */ |
|
109 | 180 | public function addOAuthAccount(UserOAuthInterface $oauth): void; |
110 | 181 | |
182 | + /** |
|
183 | + * @return void |
|
184 | + */ |
|
111 | 185 | public function setEncoderName(?string $encoderName): void; |
112 | 186 | } |
@@ -17,19 +17,43 @@ |
||
17 | 17 | |
18 | 18 | interface UserOAuthInterface extends UserAwareInterface, ResourceInterface |
19 | 19 | { |
20 | + /** |
|
21 | + * @return string|null |
|
22 | + */ |
|
20 | 23 | public function getProvider(): ?string; |
21 | 24 | |
25 | + /** |
|
26 | + * @return void |
|
27 | + */ |
|
22 | 28 | public function setProvider(?string $provider): void; |
23 | 29 | |
30 | + /** |
|
31 | + * @return string|null |
|
32 | + */ |
|
24 | 33 | public function getIdentifier(): ?string; |
25 | 34 | |
35 | + /** |
|
36 | + * @return void |
|
37 | + */ |
|
26 | 38 | public function setIdentifier(?string $identifier): void; |
27 | 39 | |
40 | + /** |
|
41 | + * @return string|null |
|
42 | + */ |
|
28 | 43 | public function getAccessToken(): ?string; |
29 | 44 | |
45 | + /** |
|
46 | + * @return void |
|
47 | + */ |
|
30 | 48 | public function setAccessToken(?string $accessToken): void; |
31 | 49 | |
50 | + /** |
|
51 | + * @return string|null |
|
52 | + */ |
|
32 | 53 | public function getRefreshToken(): ?string; |
33 | 54 | |
55 | + /** |
|
56 | + * @return void |
|
57 | + */ |
|
34 | 58 | public function setRefreshToken(?string $refreshToken): void; |
35 | 59 | } |
@@ -17,5 +17,8 @@ |
||
17 | 17 | |
18 | 18 | interface PasswordUpdaterInterface |
19 | 19 | { |
20 | + /** |
|
21 | + * @return void |
|
22 | + */ |
|
20 | 23 | public function updatePassword(CredentialsHolderInterface $user): void; |
21 | 24 | } |