carlosdev / model-change-logger

v2.0.0 2026-03-31 07:02 UTC

Requires

• php: ^8.0
• illuminate/support: ^10.0 || ^11.0 || ^12.0 || ^13.0

Requires (Dev)

• orchestra/testbench: ^8.0 || ^9.0 || ^10.0
• phpunit/phpunit: ^10.0 || ^11.0

MIT

• carlosdlrb-dev

• logger
• Audit
• laravel
• Audit Log
• activity log
• activity logger
• change log
• laravel audit
• model changes
• change logger
• model logger
• tracks changes
• laravel model audit
• eloquent audit
• eloquent changes
• model change logger
• model change tracking
• laravel model change
• eloquent model changes
• eloquent model audit
• eloquent observer
• change tracking

Published on Packagist.org on 2026-03-31 07:13 UTC

README

Leer en Espanol

Laravel library for recording changes (create, update, delete) in models.
Records JSON snapshots of changes, the responsible user, and the date of the change in a database table.

📦 Installation

Add the package to your project via Composer:

composer require carlosdev/model-change-logger

Make sure you have PHP 8.0+ and Laravel 10 - 13.

🔧 Configuration

Publish and run migrations:

php artisan migrate

Use the trait in the model you want to audit:

use CarlosDev\ModelChangeLogger\Traits\TracksChanges;

class JobOffer extends Model
{
    use TracksChanges;
}

(Optional) Audit only specific attributes: If you want to record only certain attributes, define the $auditFields property in your model:

protected array $auditFields = ['job_offer_status_id', 'title'];

🧪 Examples

Create

$post = Post::create([
        'title' => 'Hello World',
        'content' => 'First post',
]);

Recorded values:

{
    "event": "created",
    "old_value": null,
    "new_value": {
        "title": "Hello World",
        "content": "First post"
    }
}

Update

$post->update(['title' => 'New title']);

Recorded values:

{
    "event": "updated",
    "old_value": {
        "title": "Hello World"
    },
    "new_value": {
        "title": "New title"
    }
}

Delete

$post->delete();

Recorded values:

{
    "event": "deleted",
    "old_value": {
        "title": "New title",
        "content": "First post"
    },
    "new_value": null
}

🧠 What does it record?

• JSON payload with old/new values for changed attributes on update().
• JSON payload with all tracked attributes on create.
• Deletions (delete and forceDelete), saving a JSON snapshot of tracked attributes in old_value.
• Responsible user (Auth::id()).
• Affected model and ID.
• Date and time of the change.

📄 Structure of the model_changes table

Column	Description
model_type	Class of the affected model (App\Models\X)
model_id	ID of the modified model
old_value	Previous value
new_value	New value
user_id	ID of the user who made the change
event	Type of event (updated, deleted, etc.)
changed_at	Date and time of the change

✅ Compatibility

• PHP: >= 8.0
• Laravel: ^10.0 - ^13.0

📬 Contributions

Suggestions, improvements, and pull requests are welcome! 🚀

This package is designed for projects that require change traceability without depending on complex auditing packages.

📄 License

MIT © CarlosDev