mrpunyapal/laravel-auth-jobs

This package allows you to access the authenticated user while processing jobs in the queue.

1.0.0 2025-04-18 16:21 UTC

This package is auto-updated.

Last update: 2025-04-22 17:44:53 UTC


README

Latest Version on Packagist GitHub Tests Action Status Total Downloads

Installation

You can install the package via composer:

composer require mrpunyapal/laravel-auth-jobs

You can publish the config file with:

php artisan vendor:publish --tag="laravel-auth-jobs-config"

This is the contents of the published config file:

return [
   // the middleware groups that are dispatching the jobs which need authentication
    'middleware_groups' => [
        'web',
        // 'api',
    ],
];

Usage

This package provides two middleware: AuthenticateJob, you can add this middleware to your job class. and you can now access auth()->user() in your job class.

Job Class

use App\Models\Example;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Queue\Queueable;
use MrPunyapal\LaravelAuthJobs\Jobs\Middleware\AuthenticateJob;

class ExampleJob implements ShouldQueue
{
    use Queueable;

    /**
     * Get the middleware the job should pass through.
     *
     * @return array<int, object>
     */
    public function middleware(): array
    {
        return [new AuthenticateJob];
    }

    public function handle()
    {
        // You can now access auth()->user() here
        $user = auth()->user();

        // authorize your actions
        Gate::authorize('view', Example::class);
    }
}

Use Cases

  • Authorization: Authorize actions in your job class based on the authenticated user's permissions.
  • User Context: Access the authenticated user's data within jobs to perform user-specific operations.
  • Role-Based Processing: Execute different logic in your jobs based on the user's roles or permissions.
  • Personalization: Apply user preferences and settings during job execution for customized processing.
  • Audit Trail: Create comprehensive audit logs that include user information, improving traceability and accountability.

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

License

The MIT License (MIT). Please see License File for more information.