Download the PHP package digitalindoorsmen/laravel-actor-trails without Composer

Laravel Actor Trails

Track created_by, modified_by, and deleted_by as JSON objects in your Laravel models, with support for multiple guards and polymorphic actors.

✨ What It Does

This package automatically tracks who created, modified, or deleted your Eloquent models.
Instead of just storing a raw user_id, it stores a self‑contained JSON object with details about the actor at the time of the action:

This makes your audit trails:

• Polymorphic → works with multiple authenticatable models (User, Admin, Member, etc.)
• Immutable → keeps a snapshot of the actor’s display name and type, even if the user record changes later
• Automatic → hooks into Eloquent events (creating, updating, deleting)
• Configurable → choose which attributes to store in the JSON

🚀 Installation

You can install the package via composer:

Publish the config file:

Generate a migration for a specific table:

This will add created_by, modified_by, and deleted_by JSON columns to the posts table.

⚡ Usage

Add the HasActorTrails trait to any model you want to track:

Now whenever you create, update, or soft delete a Post, the actor will be stored automatically:

⚙️ Config

The published config file (config/actor-trails.php) lets you define which attributes are stored:

You can override this per model if needed.

🧪 Testing

📜 Changelog

Please see CHANGELOG for more information on what has changed recently.

🤝 Contributing

Please see CONTRIBUTING for details.

🔒 Security

Please review our security policy on how to report security vulnerabilities.

👏 Credits

• Clay Bitner
• All Contributors

📄 License

The MIT License (MIT). Please see License File for more information.