accentinteractive/laravel-logcleaner

Keep your laravel logs small and tidy.

1.2.0 2023-04-26 09:27 UTC

Requires

• php: ^7.3|^8.0
• illuminate/console: ^6.0|^7.0|^8.0|^9.0|^10.0
• illuminate/filesystem: ^6.0|^7.0|^8.0|^9.0|^10.0
• illuminate/support: ^6.0|^7.0|^8.0|^9.0|^10.0

Requires (Dev)

• orchestra/testbench: 4.*|5.*|6.*|^7.0|^8.0
• phpunit/phpunit: ^8.4|^9.0

MIT

• Joost van Veen

• accentinteractive
• laravel-logcleaner

README

Logs can get quite out of hand. This package helps save server space and keep your Laravel log files small.

1. Trim your daily log to a given number of lines do it does not grow huge.
2. Delete old daily logs, only keeping a given number of the latest log files.

• Laravel 10 support as of 1.2.0.

• Laravel 9 support as of 1.1.0.

• Versions before that support Laravel 6, 7, 8.

• Installation

• Examples

• Config settings

Installation

You can install the package via composer:

composer require accentinteractive/laravel-logcleaner

Optionally you can publish the config file with:

php artisan vendor:publish --provider="Accentinteractive\LaravelLogcleaner\LaravelLogcleanerServiceProvider" --tag="config"

Usage

You can use logcleaner:run from the command line or set it as a cron job.

Command line usage;

// Get info about the command and options
php artisan logcleaner:run --help

// Trim big log files and delete old log files
php artisan logcleaner:run

// Pass the number of lines to keep when trimming log files. Overrides the config setting.
// This overrides the default set in config
php artisan logcleaner:run --keeplines=10000

// Pass the number of files to keep when deleting old log files. Overrides the config setting.
// This overrides the default set in config
php artisan logcleaner:run --keepfiles=7

// Run without actually cleaning any logs
php artisan logcleaner:run --dry-run

Cron job usage, add this to App\Console\Kernel:

protected function schedule(Schedule $schedule)
{
    $schedule->command('logcleaner:run')->daily()->at('01:00');
}

Of course, you can also pass options when defining a cron job.

protected function schedule(Schedule $schedule)
{
    $schedule->command('logcleaner:run', ['--keeplines' => 5000, '--keepfiles' => 14])->daily()->at('01:00');
}

Config settings

You can pass config settings to modify the behaviour.

• log_files_to_keep : the number of log files to keep when deleting old log files. This config setting is overridden by option --keepfiles
• log_lines_to_keep : the number of lines to leave intact when trimming log files. This config setting is overridden by option --keeplines
• exclude : an array of filenames to exclude from processing, using wildcards.
• trimming_enabled : enables log file trimming. true by default.
• deleting_enabled : enables old log file deletions. true by default.

You can also pass options directly.

• --keeplines=2000
• --keepfiles=7
• --dry-run

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 [e-mail] instead of using the issue tracker.

Credits

• Joost van Veen
• All Contributors

License

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