كيفية تشغيل المهام في الخلفية باستخدام طوابير Laravel

# .env
QUEUE_CONNECTION=database

# Generate and run the migrations
php artisan queue:table
php artisan queue:failed-table
php artisan migrate

php artisan make:job SendWelcomeEmail

<?php

namespace App\Jobs;

use App\Mail\WelcomeMail;
use App\Models\User;
use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Bus\Dispatchable;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Queue\SerializesModels;
use Illuminate\Support\Facades\Mail;

class SendWelcomeEmail implements ShouldQueue
{
    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;

    public int $tries = 3;          // Retry up to 3 times
    public int $backoff = 60;       // Wait 60s between retries

    public function __construct(
        public readonly User $user
    ) {}

    public function handle(): void
    {
        Mail::to($this->user)->send(new WelcomeMail($this->user));
    }

    public function failed(\Throwable $exception): void
    {
        // Notify the team, log, or clean up
        logger()->error('SendWelcomeEmail failed', [
            'user_id' => $this->user->id,
            'error'   => $exception->getMessage(),
        ]);
    }
}

use App\Jobs\SendWelcomeEmail;

// In a controller after registration
SendWelcomeEmail::dispatch($user);

// Delay by 5 minutes
SendWelcomeEmail::dispatch($user)->delay(now()->addMinutes(5));

// Send to a specific queue (useful for prioritisation)
SendWelcomeEmail::dispatch($user)->onQueue('emails');

// Dispatch only if condition is met
SendWelcomeEmail::dispatchIf($user->wants_email, $user);

# Development
php artisan queue:work

# Process a specific queue with timeout and memory limit
php artisan queue:work --queue=emails,default --timeout=60 --memory=128

# Process a single job then exit (useful in cron-based setups)
php artisan queue:work --once

[program:laravel-worker]
process_name=%(program_name)s_%(process_num)02d
command=php /var/www/esb1995.com/artisan queue:work database --sleep=3 --tries=3 --timeout=90
autostart=true
autorestart=true
stopasgroup=true
killasgroup=true
user=apache
numprocs=2
redirect_stderr=true
stdout_logfile=/var/log/worker.log
stopwaitsecs=3600

# List all failed jobs
php artisan queue:failed

# Retry a specific failed job by its UUID
php artisan queue:retry 5

# Retry all failed jobs
php artisan queue:retry all

# Delete a specific failed job
php artisan queue:forget 5

# Delete all failed jobs
php artisan queue:flush

# Add this to your deploy script after git pull + optimize
php artisan queue:restart

# Supervisor will automatically start fresh workers with new code
# (queue:restart signals via the cache — ensure your cache driver is shared)