abdi.zbn / simple-audit-log

dev-main 2026-09-29 10:32 UTC

Requires

• php: ^8.2
• ext-json: *
• illuminate/database: ^12.0 || ^13.0
• illuminate/support: ^12.0 || ^13.0

Requires (Dev)

• orchestra/testbench: ^10.0 || ^11.0
• phpunit/phpunit: ^11.5.3 || ^12.0

MIT

• Zeinab Abdi

• log
• Audit
• laravel
• eloquent

Published on Packagist.org on 2026-09-29 10:32 UTC

README

Laravel Simple Audit Log Package

This Package makes it easy to keep the history of the Eloquent's Model changes. just use the trait in the model and you're good to go.

Requirements

Laravel	PHP
13.x	8.3 - 8.5
12.x	8.2 - 8.5

Composer Install

composer require abdi.zbn/simple-audit-log

Publish and Run the migrations

php artisan vendor:publish --provider="AbdiZbn\SimpleAuditLog\SimpleAuditLogServiceProvider" --tag=migrations

php artisan migrate

The package will be auto-discovered by Laravel. If you have disabled package discovery, register the service provider manually in bootstrap/providers.php.

\AbdiZbn\SimpleAuditLog\SimpleAuditLogServiceProvider::class,

Configuration (optional)

The default configuration is loaded automatically. To customize it, publish the config file to config/audit.php:

php artisan vendor:publish --provider="AbdiZbn\SimpleAuditLog\SimpleAuditLogServiceProvider" --tag=config

Auditing can also be turned off with AUDITING_ENABLED=false in your .env file.

Setup models - just use the Trait in the Model.

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use AbdiZbn\SimpleAuditLog\AuditableTrait;

class Post extends Model
{
    use AuditableTrait;

    public function getModule()
    {
        return 'post';
    }

}

Running the tests

composer install
composer test

Credits

• Zeinab Abdi- [e-mail]