Authentication
This section will introduce you to the authentication service and how to user it.
User Authenticator
This class will go over the \Anomaly\UsersModule\User\UserAuthenticator
class and how to use it.
UserAuthenticator::attempt()
The attempt
method attempts to authorize a user. The login
method is ran if the authentication succeeds.
Returns: \Anomaly\UsersModule\User\Contract\UserInterface
or false
Arguments
Key | Required | Type | Default | Description |
---|---|---|---|---|
$credentials |
true |
array |
none |
The credentials array of email/username and password. |
$remember |
false |
boolean |
false |
The "remember me" flag. |
Example
$authenticator->attempt(['email' => '[email protected]', 'password' => 'secret']);
UserAuthenticator::authenticate()
The authenticate
method authenticates credentials without logging the user in.
Returns: \Anomaly\UsersModule\User\Contract\UserInterface
or false
Arguments
Key | Required | Type | Default | Description |
---|---|---|---|---|
$credentials |
true |
array |
none |
The credentials array of email/username and password. |
Example
$authenticator->authenticate(['email' => '[email protected]', 'password' => 'secret password']);
UserAuthenticator::login()
The login
method logs in the user.
Returns: void
Arguments
Key | Required | Type | Default | Description |
---|---|---|---|---|
$user |
true |
object |
none |
The user instance. |
Example
$authenticator->login($user);
UserAuthenticator::logout()
The logout
method logs out the user.
Returns: void
Arguments
Key | Required | Type | Default | Description |
---|---|---|---|---|
$user |
true |
object |
none |
The user to logout. |
Example
$authenticator->logout($user);
UserAuthenticator::kickOut()
The kickOut
method kicks a user. The kickOut
method is similar to logout
but a different event is fired for you to hook into as needed.
Returns: void
Arguments
Key | Required | Type | Default | Description |
---|---|---|---|---|
$user |
true |
object |
none |
The user to kick out. |
Example
$authenticator->kickOut($user);