README

A simple and powerful Laravel package that automatically logs Eloquent model events (Created, Updated, Deleted) into a database or a log file.

✨ Features

• 🔄 Automatically logs created, updated, and deleted events.
• 💾 Choose between database logging or file logging.
• ⚙️ Fully configurable.
• 📜 Easy to integrate using a simple trait.
• 🧩 Compatible with Laravel 10, 11, and 12.

🧱 Installation

1️⃣ Add the repository (if you’re developing locally)

In your Laravel project’s composer.json:

"repositories": [
    {
        "type": "path",
        "url": "app/packages/laravellogger/modellogger",
        "options": { "symlink": true }
    }
]

2️⃣ Require the package

composer require nayan/model-logger:@dev

3️⃣ Publish config (optional)

php artisan vendor:publish --tag=config 

(This will create: config/model-logger.php)

4️⃣ Run migrations (if using database logging)

php artisan migrate

⚙️ Configuration

config/model-logger.php:

return [
    'log_to' => 'database', // or 'file'
    'log_file' => storage_path('logs/model-events.log'),
];

You can switch between logging to a database or to a log file easily.

🧩 Usage

Add the LogsModelEvents trait to any Eloquent model you want to monitor.

use laravelLogger\ModelLogger\Traits\LogsModelEvents;

class Post extends Model
{
    use LogsModelEvents;
}

That’s it! 🎉

Whenever this model is created, updated, or deleted, an entry will automatically be logged.

📊 Example Log Entries

🗃️ Database Example