Queue worker supervision in Laravel - Mini Project: Build & Apply

Queue Worker Supervision in Laravel

📖 Scenario: You are building a Laravel application that processes tasks in the background using queue workers. To keep your application reliable, you want to supervise these queue workers so they restart automatically if they fail or stop unexpectedly.

🎯 Goal: Set up a supervised queue worker in Laravel using the queue:work command with a process monitor to ensure the worker restarts automatically if it stops.

📋 What You'll Learn

Create a Laravel command to run the queue worker

Define a supervisor configuration variable for the worker

Use the queue:work command with the --tries option

Add a process monitor command to restart the worker automatically

💡 Why This Matters

🌍 Real World

Supervising queue workers ensures background jobs run reliably without manual restarts, which is critical for applications processing emails, notifications, or data imports.

💼 Career

Understanding queue worker supervision is important for backend developers and DevOps engineers to maintain application uptime and handle background job failures gracefully.

1

Create a Laravel command to run the queue worker

Create a Laravel Artisan command called queue:work that runs the queue worker using php artisan queue:work.

Laravel

# Create the command to run the queue worker
# Your code here

Need a hint?

Use php artisan make:command RunQueueWorker to create the command, then set $signature and call queue:work inside handle().

2

Define a supervisor configuration variable for the worker

Add a protected variable called $tries in the RunQueueWorker command class and set it to 3 to limit the number of attempts for failed jobs.

Laravel

call('queue:work');
    }
}

Need a hint?

Define protected $tries = 3; inside the command class but outside any method.

3

Use the queue:work command with the --tries option

Modify the handle() method in the RunQueueWorker command to call queue:work with the --tries=3 option using $this->call().

Laravel

<?php

namespace App\Console\Commands;

use Illuminate\Console\Command;

class RunQueueWorker extends Command
{
    protected $signature = 'queue:work';
    protected $description = 'Run the Laravel queue worker';
    protected $tries = 3;

    public function handle()
    {
        // Call queue:work with --tries=3
        # Your code here
    }
}

Need a hint?

Use $this->call('queue:work', ['--tries' => 3]); inside the handle() method.

4

Add a process monitor command to restart the worker automatically

Add a supervisor configuration command in config/queue.php under 'supervisor' key with 'command' => 'php artisan queue:work --tries=3' to supervise the queue worker process.

Laravel

<?php

return [
    // Add supervisor configuration here
    # Your code here
];

Need a hint?

In config/queue.php, add a 'supervisor' array with a 'command' key set to 'php artisan queue:work --tries=3'.