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 Tips
View all tips →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.
Send On-Demand Notifications Without User Models with Notification::route()
Use Notification::route() to send emails, SMS messages, or Slack webhooks to ad-hoc recipients without creating database User records.