Event subscribers in Laravel - Mini Project: Build & Apply

Laravel Event Subscribers Setup

📖 Scenario: You are building a Laravel application that needs to respond to user registration events. Instead of handling events directly in controllers, you want to organize event handling using an event subscriber class.

🎯 Goal: Create an event subscriber class that listens to the Registered event and handles it by calling a method. Then, register this subscriber in the EventServiceProvider.

📋 What You'll Learn

Create an event subscriber class named UserEventSubscriber in the app/Listeners directory

Inside UserEventSubscriber, define a subscribe method that listens to the IlluminateAuthEventsRegistered event

Create a handler method named onUserRegistered inside UserEventSubscriber that will be called when the event fires

Register the UserEventSubscriber class in the EventServiceProvider $subscribe array

💡 Why This Matters

🌍 Real World

Event subscribers help keep Laravel applications organized by grouping event handlers in one class, making code easier to maintain.

💼 Career

Understanding event subscribers is important for Laravel developers to build scalable and maintainable applications that respond to system events.

1

Create the UserEventSubscriber class

Create a PHP class named UserEventSubscriber inside the app/Listeners directory with a public method onUserRegistered that accepts a parameter named $event. The method body can be empty for now.

Laravel

<?php

namespace App\Listeners;

class UserEventSubscriber
{
    // Your code here
}

Need a hint?

Remember to declare the namespace App\Listeners and create a public method onUserRegistered with a parameter $event.

2

Add the subscribe method to UserEventSubscriber

Inside the UserEventSubscriber class, add a public method named subscribe that accepts a parameter $events. Inside this method, use $events->listen() to listen to the Illuminate\Auth\Events\Registered event and map it to the onUserRegistered method.

Laravel

<?php

namespace App\Listeners;

class UserEventSubscriber
{
    public function onUserRegistered($event)
    {
        // Handle the event
    }

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

Need a hint?

The subscribe method registers event listeners. Use $events->listen() with the full event class name and the handler method.

3

Register the subscriber in EventServiceProvider

Open the app/Providers/EventServiceProvider.php file. Add the UserEventSubscriber::class to the protected $subscribe array property inside the EventServiceProvider class.

Laravel

listen(
            \Illuminate\Auth\Events\Registered::class,
            [self::class, 'onUserRegistered']
        );
    }
}

// EventServiceProvider.php

namespace App\Providers;

use Illuminate\Foundation\Support\Providers\EventServiceProvider as ServiceProvider;

class EventServiceProvider extends ServiceProvider
{
    protected $subscribe = [
        // Add UserEventSubscriber here
        // Your code here
    ];
}

Need a hint?

Remember to import UserEventSubscriber with a use statement and add it to the $subscribe array.

4

Complete the event subscriber setup

Ensure the UserEventSubscriber class and the EventServiceProvider are correctly defined and saved. The subscriber should now listen to the Registered event and call onUserRegistered when a user registers.

Laravel

listen(
            \Illuminate\Auth\Events\Registered::class,
            [self::class, 'onUserRegistered']
        );
    }
}

// EventServiceProvider.php

namespace App\Providers;

use Illuminate\Foundation\Support\Providers\EventServiceProvider as ServiceProvider;

use App\Listeners\UserEventSubscriber;

class EventServiceProvider extends ServiceProvider
{
    protected $subscribe = [
        UserEventSubscriber::class,
    ];
}

// Confirm the setup is complete

Need a hint?

Double-check that the subscriber class and the event provider are properly set up and saved.