taema/laravel-extended-events

There is no license information available for the latest version (v8.0.1) of this package.

Adds a few key events to the Laravel ecosystem

v8.0.1 2021-06-22 18:33 UTC

This package is auto-updated.

Last update: 2024-04-30 00:45:25 UTC


README

Adds two new key events to the Laravel ecosystem

JobFailedEvent

\Taema\LaravelExtendedEvents\Events\JobFailedEvent is dispatched when a job fails. The job needs to use the trait Taema\LaravelExtendedEvents\Behavior\InteractsWithQueue instead of the one provided by Laravel. This enables a way to react to all jobs in the project (Logging or reporting via Sentry for example).

Event Attributes

PRoperty Type Description
$exception \Exception The caught exception during the job execution

AuthorizationFailedEvent

\Taema\LaravelExtendedEvents\Events\AuthorizationFailedEvent is dispatched when a Gate or Policy fails in Laravel. This will help debugging where a 403 comes from.

The package will replace the Illuminate\Auth\Access\Gate with Taema\LaravelExtendedEvents\Services\Gate

Event Attributes

Property Type Description
$ability string The tested ability in the Gate or Policy (Usually via the $this->authorize() in a controller)
$arguments array The arguments passed to the ability test (Usually one or many Models). Note that even if the argument is passed a scalar value instead of an array it will be converted to an array (Ex. $this->authorize('view', $movie) will provide $arguments === [$movie])
$user User|null The authenticated user if it was available at the moment of the Gate/Policy failure