Dispatching jobs in Laravel - Mini Project: Build & Apply

Dispatching Jobs in Laravel

📖 Scenario: You are building a Laravel application that needs to send welcome emails to new users without slowing down the main app. To do this, you will use Laravel's job dispatching system to handle email sending in the background.

🎯 Goal: Build a Laravel job that sends a welcome email and dispatch it from a controller.

📋 What You'll Learn

Create a job class named SendWelcomeEmail that accepts a User object.

Add a handle method in the job to simulate sending an email.

Dispatch the SendWelcomeEmail job from a controller method called sendEmail.

Use the dispatch() helper to queue the job.

💡 Why This Matters

🌍 Real World

Dispatching jobs in Laravel is used to handle time-consuming tasks like sending emails, processing files, or calling APIs without blocking the main application flow.

💼 Career

Understanding job dispatching is essential for backend developers working with Laravel to build scalable and responsive applications.

1

Create the SendWelcomeEmail job class

Create a Laravel job class named SendWelcomeEmail that accepts a User object in its constructor and stores it in a public property called user.

Laravel

<?php

namespace App\Jobs;

use App\Models\User;

class SendWelcomeEmail
{
    public User $user;

    // Your code here
}

Need a hint?

Use the __construct method to accept the User object and assign it to the user property.

2

Add the handle method to the job

Add a public method called handle inside the SendWelcomeEmail job class. Inside it, add a comment // Simulate sending welcome email.

Laravel

user = $user;
    }

    // Add the handle method below
    // Your code here
}

Need a hint?

The handle method is where the job's main work happens.

3

Create a controller method to dispatch the job

In a controller named UserController, create a public method called sendEmail that accepts a User object as a parameter. Inside this method, dispatch the SendWelcomeEmail job using the dispatch() helper and pass the User object to it.

Laravel

user = $user;
    }

    public function handle()
    {
        // Simulate sending welcome email
    }
}

namespace App\Http\Controllers;

use App\Models\User;
use App\Jobs\SendWelcomeEmail;

class UserController
{
    // Add the sendEmail method below
    // Your code here
}

Need a hint?

Use the dispatch() helper to send the job to the queue.

4

Complete the job dispatching setup

Add the ShouldQueue interface and the Dispatchable trait to the SendWelcomeEmail job class to make it queueable.

Laravel

user = $user;
    }

    public function handle()
    {
        // Simulate sending welcome email
    }
}

namespace App\Http\Controllers;

use App\Models\User;
use App\Jobs\SendWelcomeEmail;

class UserController
{
    public function sendEmail(User $user)
    {
        dispatch(new SendWelcomeEmail($user));
    }
}

Need a hint?

Implement ShouldQueue and use the Dispatchable trait to enable queueing.