PHPackages alexgithubp/laravel-history-tracking - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Logging & Monitoring](/categories/logging) 4. / 5. alexgithubp/laravel-history-tracking ActiveLibrary[Logging & Monitoring](/categories/logging) alexgithubp/laravel-history-tracking ==================================== A custom history tracking system for users + reporting, based on the https://github.com/spatie/laravel-activitylog package v1(1y ago)02.3k↓50%MITPHPPHP ^8.1 Since May 17Pushed 1y agoCompare [ Source](https://github.com/AlexGitHubP/laravel-history-tracking)[ Packagist](https://packagist.org/packages/alexgithubp/laravel-history-tracking)[ Docs](https://github.com/AlexGitHubP/laravel-history-tracking)[ Fund](https://spatie.be/open-source/support-us)[ GitHub Sponsors](https://github.com/spatie)[ RSS](/packages/alexgithubp-laravel-history-tracking/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (1)Dependencies (6)Versions (2)Used By (0) [![Social Card of Laravel Activity Log](/art/socialcard.png)](/art/socialcard.png) Log activity inside your Laravel app ==================================== [](#log-activity-inside-your-laravel-app) [![Latest Version on Packagist](https://camo.githubusercontent.com/e2a0ed0e93c655300cd023ece53b902d4be9771a8c5e5473f64c31502308cec5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7370617469652f6c61726176656c2d686973746f72792d747261636b696e672e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/spatie/laravel-activitylog)[![GitHub Workflow Status](https://camo.githubusercontent.com/8493380c85f4f8c43382306c68f2c2cb959fd115eb8f3260bcf3d32a11c38af1/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f7370617469652f6c61726176656c2d61637469766974796c6f672f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d5465737473)](https://github.com/spatie/laravel-activitylog/actions/workflows/run-tests.yml)[![Check & fix styling](https://github.com/spatie/laravel-activitylog/workflows/Check%20&%20fix%20styling/badge.svg)](https://github.com/spatie/laravel-activitylog/actions/workflows/php-cs-fixer.yml)[![Total Downloads](https://camo.githubusercontent.com/323770d6f3f5f20a687f64c8c7035e923a1f99dfb6fb88af34d0bd2d5e93eb71/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7370617469652f6c61726176656c2d686973746f72792d747261636b696e672e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/spatie/laravel-activitylog) A custom history tracking system for users + reporting, based on the package. The Package stores all activity in the `history_tracking` table. Here's a demo of how you can use it: ``` activity()->log('Look, I logged something'); ``` You can retrieve all activity using the `Jobful\HistoryTracking\Models\HistoryTracking` model. ``` Activity::all(); ``` Here's a more advanced example: ``` 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->getExtraProperty('customProperty'); //returns 'customValue' $lastLoggedActivity->description; //returns 'Look, I logged something' ``` Here's an example on [event logging](https://spatie.be/docs/laravel-activitylog/advanced-usage/logging-model-events). ``` $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->changes()` will return this array: ``` [ 'attributes' => [ 'name' => 'updated name', 'text' => 'Lorum', ], 'old' => [ 'name' => 'original name', 'text' => 'Lorum', ], ]; ``` Support us ---------- [](#support-us) [![](https://camo.githubusercontent.com/b471c2a5c692bc6f88f14e77f7a380a71584d12e9db4b6d5b6a8dca2cd315871/68747470733a2f2f6769746875622d6164732e73332e65752d63656e7472616c2d312e616d617a6f6e6177732e636f6d2f6c61726176656c2d686973746f72792d747261636b696e672e6a70673f743d31)](https://spatie.be/github-ad-click/laravel-activitylog) We invest a lot of resources into creating [best in class open source packages](https://spatie.be/open-source). You can support us by [buying one of our paid products](https://spatie.be/open-source/support-us). 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](https://spatie.be/about-us). We publish all received postcards on [our virtual postcard wall](https://spatie.be/open-source/postcards). Documentation ------------- [](#documentation) You'll find the documentation on . 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](https://github.com/spatie/laravel-activitylog/issues), we'll try to address it as soon as possible. Installation ------------ [](#installation) You can install the package via composer: ``` composer require spatie/laravel-activitylog ``` The package will automatically register itself. You can publish the migration with: ``` php artisan vendor:publish --tag="historytrack-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 `history_tracking` table by running the migrations: ``` php artisan migrate ``` You can optionally publish the config file with: ``` php artisan vendor:publish --tag="historytrack-config" ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information about recent changes. Upgrading --------- [](#upgrading) Please see [UPGRADING](UPGRADING.md) for details. Testing ------- [](#testing) ``` composer test ``` Contributing ------------ [](#contributing) Please see [CONTRIBUTING](https://github.com/spatie/.github/blob/main/CONTRIBUTING.md) for details. Security -------- [](#security) If you've found a bug regarding security please mail instead of using the issue tracker. Credits ------- [](#credits) - [Freek Van der Herten](https://github.com/freekmurze) - [Sebastian De Deyne](https://github.com/sebastiandedeyne) - [Tom Witkowski](https://github.com/Gummibeer) - [All Contributors](../../contributors) And a special thanks to [Caneco](https://twitter.com/caneco) for the logo and [Ahmed Nagi](https://github.com/nagi1) for all the work he put in `v4`. License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 32 — LowBetter than 71% of packages Maintenance32 Infrequent updates — may be unmaintained Popularity21 Limited adoption so far Community19 Small or concentrated contributor base Maturity49 Maturing project, gaining track record Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 722d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/8196b6135760e8c82a936aebfc0b887f76dffbf6db2be02649c358af25c16986?d=identicon)[AlexPPackag](/maintainers/AlexPPackag) --- Top Contributors [![Gummibeer](https://avatars.githubusercontent.com/u/6187884?v=4)](https://github.com/Gummibeer "Gummibeer (286 commits)")[![freekmurze](https://avatars.githubusercontent.com/u/483853?v=4)](https://github.com/freekmurze "freekmurze (235 commits)")[![nagi1](https://avatars.githubusercontent.com/u/16584220?v=4)](https://github.com/nagi1 "nagi1 (35 commits)")[![AlexAndweb](https://avatars.githubusercontent.com/u/56642732?v=4)](https://github.com/AlexAndweb "AlexAndweb (24 commits)")[![AlexVanderbist](https://avatars.githubusercontent.com/u/6287961?v=4)](https://github.com/AlexVanderbist "AlexVanderbist (23 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (13 commits)")[![mallardduck](https://avatars.githubusercontent.com/u/619938?v=4)](https://github.com/mallardduck "mallardduck (11 commits)")[![ReeceM](https://avatars.githubusercontent.com/u/2767904?v=4)](https://github.com/ReeceM "ReeceM (10 commits)")[![stevebauman](https://avatars.githubusercontent.com/u/6421846?v=4)](https://github.com/stevebauman "stevebauman (10 commits)")[![akoSalman](https://avatars.githubusercontent.com/u/17239230?v=4)](https://github.com/akoSalman "akoSalman (8 commits)")[![laravel-shift](https://avatars.githubusercontent.com/u/15991828?v=4)](https://github.com/laravel-shift "laravel-shift (8 commits)")[![AdrianMrn](https://avatars.githubusercontent.com/u/12762044?v=4)](https://github.com/AdrianMrn "AdrianMrn (7 commits)")[![AbdullahFaqeir](https://avatars.githubusercontent.com/u/1428547?v=4)](https://github.com/AbdullahFaqeir "AbdullahFaqeir (7 commits)")[![leMaur](https://avatars.githubusercontent.com/u/2118799?v=4)](https://github.com/leMaur "leMaur (6 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (5 commits)")[![sebastiandedeyne](https://avatars.githubusercontent.com/u/1561079?v=4)](https://github.com/sebastiandedeyne "sebastiandedeyne (4 commits)")[![patinthehat](https://avatars.githubusercontent.com/u/5508707?v=4)](https://github.com/patinthehat "patinthehat (4 commits)")[![mvdnbrk](https://avatars.githubusercontent.com/u/802681?v=4)](https://github.com/mvdnbrk "mvdnbrk (4 commits)")[![rubenvanassche](https://avatars.githubusercontent.com/u/619804?v=4)](https://github.com/rubenvanassche "rubenvanassche (4 commits)")[![chrisrhymes](https://avatars.githubusercontent.com/u/4160546?v=4)](https://github.com/chrisrhymes "chrisrhymes (3 commits)") --- Tags logspatielaravelusertrackingactivityhistory ### Code Quality TestsPest ### Embed Badge ![Health badge](/badges/alexgithubp-laravel-history-tracking/health.svg) ``` [![Health](https://phpackages.com/badges/alexgithubp-laravel-history-tracking/health.svg)](https://phpackages.com/packages/alexgithubp-laravel-history-tracking) ``` ### Alternatives [spatie/laravel-activitylog A very simple activity logger to monitor the users of your website or application 5.8k45.4M309](/packages/spatie-laravel-activitylog) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)