Log HTTP requests
This package adds a middleware which can log incoming requests to the default log. If anything goes wrong during a user's request, you'll still be able to access the original request data sent by that user.
This log acts as an extra safety net for critical user submissions, such as forms that generate leads.
Support us
We invest a lot of resources into creating best in class open source packages. You can support us by buying one of our paid products.
We highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on our contact page. We publish all received postcards on our virtual postcard wall.
Installation
You can install the package via composer:
composer require spatie/laravel-http-logger
Optionally you can publish the configfile with:
php artisan vendor:publish --provider="Spatie\HttpLogger\HttpLoggerServiceProvider" --tag="config"
This is the contents of the published config file:
return [
/*
* The log profile which determines whether a request should be logged.
* It should implement `LogProfile`.
*/
'log_profile' => \Spatie\HttpLogger\LogNonGetRequests::class,
/*
* The log writer used to write the request to a log.
* It should implement `LogWriter`.
*/
'log_writer' => \Spatie\HttpLogger\DefaultLogWriter::class,
/*
* Filter out body fields which will never be logged.
*/
'except' => [
'password',
'password_confirmation',
],
];
Usage
This packages provides a middleware which can be added as a global middleware or as a single route.
// in `app/Http/Kernel.php`
protected $middleware = [
// ...
\Spatie\HttpLogger\Middlewares\HttpLogger::class
];
// in a routes file
Route::post('/submit-form', function () {
//
})->middleware(\Spatie\HttpLogger\Middlewares\HttpLogger::class);
Logging
Two classes are used to handle the logging of incoming requests:
a LogProfile
class will determine whether the request should be logged,
and LogWriter
class will write the request to a log.
A default log implementation is added within this package.
It will only log POST
, PUT
, PATCH
, and DELETE
requests
and it will write to the default Laravel logger.
You're free to implement your own log profile and/or log writer classes,
and configure it in config/http-logger.php
.
A custom log profile must implement \Spatie\HttpLogger\LogProfile
.
This interface requires you to implement shouldLogRequest
.
// Example implementation from `\Spatie\HttpLogger\LogNonGetRequests`
public function shouldLogRequest(Request $request): bool
{
return in_array(strtolower($request->method()), ['post', 'put', 'patch', 'delete']);
}
A custom log writer must implement \Spatie\HttpLogger\LogWriter
.
This interface requires you to implement logRequest
.
// Example implementation from `\Spatie\HttpLogger\DefaultLogWriter`
public function logRequest(Request $request): void
{
$method = strtoupper($request->getMethod());
$uri = $request->getPathInfo();
$bodyAsJson = json_encode($request->except(config('http-logger.except')));
$message = "{$method} {$uri} - {$bodyAsJson}";
Log::info($message);
}
Testing
composer test
Changelog
Please see CHANGELOG for more information what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
Credits
License
The MIT License (MIT). Please see License File for more information.