1 | <?php |
||
19 | class PasswordReset { |
||
20 | |||
21 | /** |
||
22 | * Holds the user Data instance. |
||
23 | */ |
||
24 | protected $userData; |
||
25 | |||
26 | /** |
||
27 | * Holds the password reset Data instance. |
||
28 | */ |
||
29 | protected $passwordResetData; |
||
30 | |||
31 | /** |
||
32 | * Constructor. |
||
33 | * |
||
34 | * @param CRUDlex\Data $userData |
||
35 | * the user data instance |
||
36 | * @param CRUDlex\Data $passwordResetData |
||
37 | * the password reset data instance |
||
38 | */ |
||
39 | public function __construct($userData, $passwordResetData) { |
||
43 | |||
44 | /** |
||
45 | * Creates a password reset request. |
||
46 | * |
||
47 | * @param string $identifyingField |
||
48 | * the identifying field to grab an user, likely the email |
||
49 | * @param string $identifyingValue |
||
50 | * the identifying value to grab an user, likely the email |
||
51 | * |
||
52 | * @return null|string |
||
53 | * the token of the password reset instance ready to be send to the user via |
||
54 | * a secondary channel like email; might be null if the user could not be |
||
55 | * identified uniquly via the given parameters: either zero or more than one |
||
56 | * users were found |
||
57 | */ |
||
58 | public function requestPasswordReset($identifyingField, $identifyingValue) { |
||
80 | |||
81 | /** |
||
82 | * Resets the password of an user belonging to the given password reset |
||
83 | * token. |
||
84 | * |
||
85 | * @param string $token |
||
86 | * the password reset token |
||
87 | * @param string $newPassword |
||
88 | * the new password |
||
89 | * |
||
90 | * @return boolean |
||
91 | * true on success, false on failure with one of this reasons: |
||
92 | * - no or more than one password reset request found for this token |
||
93 | * - the password request for this token is older than 48h |
||
94 | * - the password request for this token has already been used |
||
95 | */ |
||
96 | public function resetPassword($token, $newPassword) { |
||
123 | |||
124 | } |
||
125 |