Capture HTTP requests, Artisan CLI commands, and outgoing API responses into a unified audit trail using a single Laravel Event Subscriber.
Applications frequently need to log key lifecycle actions for debugging and compliance. Instead of scattering logging logic across various middleware, commands, and service classes, Laravel Event Subscribers let you listen to multiple framework events from a single centralized class.
The ActivityLogEventSubscriber
namespace App\Listeners;
use Illuminate\Console\Events\CommandFinished;
use Illuminate\Events\Dispatcher;
use Illuminate\Foundation\Http\Events\RequestHandled;
use Illuminate\Http\Client\Events\ResponseReceived;
use Illuminate\Support\Facades\Log;
class ActivityLogEventSubscriber
{
public function handleHttpRequest(RequestHandled $event): void
{
$this->logActivity('RequestHandled', [
'method' => $event->request->method(),
'url' => $event->request->fullUrl(),
'status' => $event->response->getStatusCode(),
'user_id' => $event->request->user()?->id,
]);
}
public function handleConsoleCommand(CommandFinished $event): void
{
$this->logActivity('CommandFinished', [
'command' => $event->command,
'exit_code' => $event->exitCode,
]);
}
public function handleHttpClientResponse(ResponseReceived $event): void
{
$this->logActivity('HttpClientResponse', [
'url' => (string) $event->request->url(),
'status' => $event->response->status(),
]);
}
private function logActivity(string $eventType, array $payload): void
{
Log::channel('activity')->info("Activity [{$eventType}]", $payload);
}
public function subscribe(Dispatcher $events): array
{
return [
RequestHandled::class => 'handleHttpRequest',
CommandFinished::class => 'handleConsoleCommand',
ResponseReceived::class => 'handleHttpClientResponse',
];
}
}Registering the Subscriber
In Laravel 11+, register the subscriber inside your AppServiceProvider::boot() method (or EventServiceProvider in earlier versions):
namespace App\Providers;
use App\Listeners\ActivityLogEventSubscriber;
use Illuminate\Support\Facades\Event;
use Illuminate\Support\ServiceProvider;
class AppServiceProvider extends ServiceProvider
{
public function boot(): void
{
Event::subscribe(ActivityLogEventSubscriber::class);
}
}Summary
- Use an Event Subscriber to group related event handlers into a single cohesive class.
- Listen to built-in framework events like
RequestHandled,CommandFinished, andResponseReceivedfor comprehensive audit logging. - Decouples monitoring and logging logic from core HTTP controllers and console commands.
Related Articles
View all articles →Instantly Broadcast Real-Time Database Notifications Using Model Observers
Automatically broadcast WebSocket events to private user channels whenever a database notification is saved using an observer on Laravel's DatabaseNotification model.
Monitor Aggregate Queue Metrics with Total Size Helpers in Laravel 13.27
Laravel 13.27 adds totalPendingSize(), totalDelayedSize(), and totalReservedSize() to the Queue facade, making it easy to aggregate queue metrics for dashboards and health checks.