Download the PHP package carlosdev/model-change-logger without Composer
On this page you can find all versions of the php package carlosdev/model-change-logger. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download carlosdev/model-change-logger
More information about carlosdev/model-change-logger
Files in carlosdev/model-change-logger
Package model-change-logger
Short Description Laravel package to log create, update, and delete events in Eloquent models with JSON snapshots and user attribution.
License MIT
Informations about the package model-change-logger
Model Change Logger
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:
Make sure you have PHP 8.0+ and Laravel 10 - 13.
๐ง Configuration
Publish and run migrations:
Use the trait in the model you want to audit:
(Optional) Audit only specific attributes: If you want to record only certain attributes, define the $auditFields property in your model:
๐งช Examples
Create
Recorded values:
Update
Recorded values:
Delete
Recorded values:
๐ง 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