spatie/laravel-activitylog
Laravel Activitylog
This is a Laravel package that provides a database audit trail by automatically logging user actions and Eloquent model events. It records create, update, and delete operations on models into a dedicated database table, creating a searchable record of changes for tracking and review.
The package distinguishes itself through extensive configuration and customization options. You can control which model attributes are logged, specify which events trigger logging, customize activity descriptions, and modify activity records before they are saved. It supports logging changes to pivot models, tracking attributes from related models using dot notation, and monitoring specific sub-keys within JSON columns. Batch logging groups related activities into single entries, and event-based filtering allows conditional inclusion or exclusion of activities based on runtime logic.
Additional capabilities include query scopes for filtering logs by subject model, causing user, or event type, automatic resolution of the authenticated user as the causer, and the ability to temporarily disable logging for specific model instances or suppress empty logs when no attributes have changed. The package is installed as a Composer dependency and integrates with Laravel's service container and configuration system.
Features
- Activity Logging Packages - Records user actions and model events into a database table for auditing within Laravel applications.
- User Activity Logs - Records user actions and model events into a database table for auditing and review.
- Laravel Audit Log Packages - Logs user actions and model events into a database table for tracking and review within Laravel applications.
- Database Change Tracking - Automatically logs create, update, and delete events on Eloquent models with configurable attributes.
- Eloquent Model Event Listeners - Hooks into Laravel's Eloquent model lifecycle events to automatically capture and log changes to database records.
- Eloquent Model Subjects - Provides the ability to associate any Eloquent model as the subject of an activity log entry.
- Database Audit Trails - Stores activity logs in a dedicated database table with query scopes for filtering.
- Selective Attribute Logging - Ships configuration options to selectively log model attributes, relations, and custom properties.
- User Action Audit Trackers - Captures user-initiated activities such as logins and custom actions for audit trails.
- Model Attribute Selection - Allows selecting which model attributes to track using fillable, guarded, or explicit lists.
- Authorization Event Loggers - Records create, update, and delete events on Eloquent models with configurable attributes and context.
- Eloquent Model Event Loggers - Automatically logs create, update, and delete events on Eloquent models with configurable attributes.
- User Action Audit Logging - Captures user-initiated activities such as logins and custom actions for audit trails.
- Activity Log Database Drivers - Stores activity logs in a dedicated database table using Laravel's query builder and schema migration system.
- Eloquent Model Event Loggers - Automatically logs create, update, and delete events on Eloquent models with configurable attributes.
- Log Event Filters - Provides mechanisms to specify which model events trigger an activity log entry.
- Attribute Filtering - Allows selective inclusion or exclusion of model attributes from logs using fillable, guarded, or explicit property lists.
- Activity Description Customizers - Replaces default event names with custom text for each logged model event.
- JSON Sub-key Tracking - Tracks changes to specific sub-keys inside JSON columns using arrow notation.
- Activity Log Batchers - Groups multiple related activities into a single log entry to reduce storage overhead and improve query performance.
- Activity Log - Offers pre-built query scopes to filter activity logs by subject model, causing user, or event type for efficient retrieval.
- Pivot Model Loggers - Records activity on pivot models by adding a primary key and using a logging trait.
- JSON Sub-key Change Trackers - Monitors changes to specific sub-keys inside JSON columns using arrow notation for granular change detection.
- Related Model Attribute Loggers - Includes attributes from directly related models in the activity log using dot notation.
- Pre-Save Activity Modifiers - Fills custom properties on the activity record just before it is saved to the database.
- Activity Causer Resolvers - Automatically resolves the authenticated user or system process responsible for each logged activity.
- Attribute Exclusions - Provides the ability to exclude specified attributes from activity log entries.
- Activity Log Query Engines - Filters activity records by subject model, causing user, or event type using provided query scopes.
- Empty Log Suppression - Prevents saving activity log entries when no tracked attributes have changed.
- Per-Instance Log Suppression - Allows temporarily preventing a specific model instance from generating activity logs.
- General Utilities - Logs user activity within the application.
