jorisvanw/apilogger

Small laravel package for viewing api logs which can be used in debugging.

0.1.13 2020-10-05 13:30 UTC

MIT

• Joris van Willigen
• aung win thant

README

Clone of aungwinthant/apilogger

This is a small package that can helps in debugging api logs. It can log request method, url, duration, request payload, which models are retrieved, controller and method.

Installation

1. Install the package via composer

composer require jorisvanw/apilogger

Usage

1. Laravel 5.5 and higher uses Package Auto-Discovery, so doesn't require you to manually add the ServiceProvider. If you use a lower version of Laravel you must register it in your app.php file:

JorisvanW\Providers\ApiLogServiceProvider::class

1. Publish the config file with:

php artisan vendor:publish --tag=config --provider="JorisvanW\Providers\ApiLogServiceProvider"

The config file is called apilogs.php. Currently supported drivers are db and file

By default the logger will use file to log the data. But if you want to use Database for logging, migrate table by using

You can also configure which fields should not be logged like passwords, secrets, etc.

You dont need to migrate if you are just using file driver

php artisan migrate

1. Add middleware named apilogger to the route or controller you want to log data

//in route.php or web.php
Route::middleware('apilogger')->post('/test',function(){
    return response()->json("test");
});

1. Add a controller and your routes

/**
 * View API logs
 *
 * @param \JorisvanW\Contracts\ApiLoggerInterface $logger
 *
 * @return \Illuminate\Contracts\View\Factory|\Illuminate\Foundation\Application|\Illuminate\View\View
 */
public function getApiLogger(ApiLoggerInterface $logger)
{
    $apilogs = $logger->getLogsPaginated();

    return view('apilog::index', compact('apilogs'));
}

/**
 * Delete API logs.
 *
 * @param \JorisvanW\Contracts\ApiLoggerInterface $logger
 *
 * @return \Illuminate\Http\RedirectResponse
 */
public function deleteApiLogs(ApiLoggerInterface $logger): \Illuminate\Http\RedirectResponse
{
    $logger->deleteLogs();

    return redirect()->back();

}

1. Dashboard can be accessible via your routes.

Clear the logs

You can permenently clear the logs by using the following command.

php artisan apilog:clear

Implement your own log driver

1. Your driver class must implement ApiLoggerInterface for saving, retrieving and deleting the logs.
2. Your driver class may extends AbstractLogger class which provide helpful methods such as logData and mapArrayToModel.
3. Substitude in your new class name instead of db or file as the driver. eg: \App\Apilogs\CustomLogger::class

Security

If you discover any security related issues, please email [e-mail] instead of using the issue tracker.

License

The MIT License (MIT). Please see License File for more information.

[]: https://github.com/aungwinthant/apilogger