+1
日增长
5,918
stars
751
forks
89
watchers
548
prs
617
issues
133
releases
README
Log activity inside your Laravel app
The spatie/laravel-activitylog package provides easy to use functions to log the activities of the users of your app. It can also automatically log model events.
The package stores all activity in the activity_log table.
Here's a demo of how you can use it:
php
activity()-log('Look, I logged something');
You can retrieve all activity using the Spatie\Activitylog\Models\Activity model.
php
Activity::all();
Here's a more advanced example:
php
activity()
-performedOn($anEloquentModel)
-causedBy($user)
-withProperties(['customProperty' = 'customValue'])
-log('Look, I logged something');
$lastLoggedActivity = Activity::all()-last();
$lastLoggedActivity-subject; //returns an instance of an eloquent model
$lastLoggedActivity-causer; //returns an instance of your user model
$lastLoggedActivity-getProperty('customProperty'); //returns 'customValue'
$lastLoggedActivity-description; //returns 'Look, I logged something'
Here's an example on event logging.
php
$newsItem-name = 'updated name';
$newsItem-save();
//updating the newsItem will cause the logging of an activity
$activity = Activity::all()-last();
$activity-description; //returns 'updated'
$activity-subject; //returns the instance of NewsItem that was saved
Calling $activity-attribute_changes will return this collection:
php
[
'attributes' = [
'name' = 'updated name',
'text' = 'Lorem',
],
'old' = [
'name' = 'original name',
'text' = 'Lorem',
],
];
Support us
We invest a lot of resources into creating best in class open source packages. You can support us by buying one of our paid products.
We highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on our contact page. We publish all received postcards on our virtual postcard wall.
Documentation
You'll find the documentation on https://spatie.be/docs/laravel-activitylog/introduction.
Find yourself stuck using the package? Found a bug? Do you have general questions or suggestions for improving the activity log? Feel free to create an issue on GitHub, we'll try to address it as soon as possible.
Installation
You can install the package via composer:
bash
composer require spatie/laravel-activitylog
The package will automatically register itself.
You can publish the migration with:
bash
php artisan vendor:publish --provider="Spatie\Activitylog\ActivitylogServiceProvider" --tag="activitylog-migrations"
_Note_: The default migration assumes you are using integers for your model IDs. If you are using UUIDs, or some other format, adjust the format of the subject_id and causer_id fields in the published migration before continuing.
After publishing the migration you can create the activity_log table by running the migrations:
bash
php artisan migrate
You can optionally publish the config file with:
bash
php artisan vendor:publish Discussions
#1482Add flag to recover disk space rebuilding the table1 comments · 2026-11-11#1471v5.1.0 contains breaking changes0 comments · 2026-08-27#1470Add option to disable 'clean_after_days'0 comments · 2026-08-06#1469Redact encrypted and hashed attributes0 comments · 2026-07-31#1458HasActivity trait1 comments · 2026-05-13#1456Octane aware batch column from docs1 comments · 2026-04-09#1445Allow custom attribute comparison in LogsActivity trait0 comments · 2026-02-05#1433Support to v11 and v12?0 comments · 2025-12-08
Latest release
5.1.5 5.1.5 2026-11-13What changed - Fix buffered logging for custom activity models with renamed timestamp columns, UPDATED_AT = null, or $timestamps = false. - Use Eloquent's timestamp handling when preparing buffered activities, preserving supplied dates and explicit null values. - Add database-backed regression tests for custom timestamp settings and delayed flushing. Compatibility and release scope This release contains only the timestamp fix from 1481, backported onto 5.1.4. PHP ^8.4 and Laravel ^12.0 || ^13.0 support are unchanged. Other unreleased changes on main are not included. Thanks to @skybleak33