bradietilley/laravel-audit-logs

Log changes to your models in your Laravel application

dev-main 2026-07-23 10:21 UTC

Requires

• php: ^8.3
• laravel/framework: ^13.0
• spatie/laravel-package-tools: ^1.16

Requires (Dev)

• laravel/pint: ^1.18
• orchestra/testbench: ^11.0
• pestphp/pest: ^4.0
• phpstan/phpstan: ^2.0

MIT

• Bradie Tilley

• logging
• Audit
• laravel
• audit-logs

Published on Packagist.org on 2026-07-30 07:56 UTC

README

A simple yet flexible implementation of audit logging in Laravel.

Documentation

Full documentation is available at bradietilley.dev/laravel-audit-logs.

Installation

composer require bradietilley/laravel-audit-logs
php artisan vendor:publish --tag="audit-logs-migrations"
php artisan migrate

use BradieTilley\AuditLogs\Concerns\HasAuditLogs;
use BradieTilley\AuditLogs\Contracts\WithAuditLogs;
use Illuminate\Database\Eloquent\Model;

class Product extends Model implements WithAuditLogs
{
    use HasAuditLogs;
}

$product = Product::create(['name' => 'Widget']);
// → "Product created"

$product->update(['name' => 'Gadget']);
// → "Product updated" with human-readable change details

See the documentation for activity logs, auth events, change filtering, and customization.

Credits

• Bradie Tilley