Auth provides a collection of events for extending its functionality. Modules and plugins can register event listeners, typically in their init()
methods, to modify Auth’s behavior.
beforeAuthorizationRedirect
event#The event that is triggered before a user is redirect to the provider.
use verbb\auth\events\AuthorizationUrlEvent;
use verbb\auth\services\OAuth;
use yii\base\Event;
Event::on(OAuth::class, OAuth::EVENT_BEFORE_AUTHORIZATION_REDIRECT, function(AuthorizationUrlEvent $event) {
$provider = $event->provider;
$ownerHandle = $event->ownerHandle;
$authUrl = $event->authUrl;
// ...
});
beforeFetchAccessToken
event#The event that is triggered before an access token is fetched from the provider.
use verbb\auth\events\AccessTokenEvent;
use verbb\auth\services\OAuth;
use yii\base\Event;
Event::on(OAuth::class, OAuth::EVENT_BEFORE_FETCH_ACCESS_TOKEN, function(AccessTokenEvent $event) {
$provider = $event->provider;
$ownerHandle = $event->ownerHandle;
// ...
});
afterFetchAccessToken
event#The event that is triggered before an access token is fetched from the provider.
use verbb\auth\events\AccessTokenEvent;
use verbb\auth\services\OAuth;
use yii\base\Event;
Event::on(OAuth::class, OAuth::EVENT_AFTER_FETCH_ACCESS_TOKEN, function(AccessTokenEvent $event) {
$provider = $event->provider;
$ownerHandle = $event->ownerHandle;
$accessToken = $event->accessToken;
$token = $event->token;
// ...
});
beforeSaveToken
event#The event that is triggered before a token is saved.
use verbb\auth\events\TokenEvent;
use verbb\auth\services\Tokens;
use yii\base\Event;
Event::on(Tokens::class, Tokens::EVENT_BEFORE_SAVE_TOKEN, function(TokenEvent $event) {
$token = $event->token;
$isNew = $event->isNew;
// ...
});
afterSaveToken
event#The event that is triggered after a token is saved.
use verbb\auth\events\TokenEvent;
use verbb\auth\services\Tokens;
use yii\base\Event;
Event::on(Tokens::class, Tokens::EVENT_AFTER_SAVE_TOKEN, function(TokenEvent $event) {
$token = $event->token;
$isNew = $event->isNew;
// ...
});
beforeDeleteToken
event#The event that is triggered before a token is deleted.
use verbb\auth\events\TokenEvent;
use verbb\auth\services\Tokens;
use yii\base\Event;
Event::on(Tokens::class, Tokens::EVENT_BEFORE_DELETE_TOKEN, function(TokenEvent $event) {
$token = $event->token;
// ...
});
afterDeleteToken
event#The event that is triggered after a token is deleted.
use verbb\auth\events\TokenEvent;
use verbb\auth\services\Tokens;
use yii\base\Event;
Event::on(Tokens::class, Tokens::EVENT_AFTER_DELETE_TOKEN, function(TokenEvent $event) {
$token = $event->token;
// ...
});