PHPackages                             konekt/history - 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. [Database & ORM](/categories/database)
4. /
5. konekt/history

ActiveLibrary[Database & ORM](/categories/database)

konekt/history
==============

Eloquent Model History for Laravel

1.10.1(1mo ago)03.4kMITPHPPHP ^8.3CI passing

Since Nov 16Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/artkonekt/history)[ Packagist](https://packagist.org/packages/konekt/history)[ GitHub Sponsors](https://github.com/fulopattila122)[ RSS](/packages/konekt-history/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (24)Versions (19)Used By (0)

Eloquent Model History
======================

[](#eloquent-model-history)

[![Tests](https://camo.githubusercontent.com/bf4af6923d7fca2581f9d097ee69a053d1b9f29686fdd36b1a8987fb00364827/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6172746b6f6e656b742f686973746f72792f74657374732e796d6c3f6272616e63683d6d6173746572267374796c653d666c61742d737175617265)](https://github.com/artkonekt/history/actions?query=workflow%3Atests)[![Packagist version](https://camo.githubusercontent.com/84e2eda8723b60996ac7bd3a486168bfb24355c2339ac4727cd5a404d2bd1843/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6b6f6e656b742f686973746f72792e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/konekt/history)[![Packagist downloads](https://camo.githubusercontent.com/d58391026e8c1b0c4f32a1189c616fcc9c063987e7c5c8004c4ba114cb34d902/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6b6f6e656b742f686973746f72792e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/konekt/history)[![StyleCI](https://camo.githubusercontent.com/63ac41f6b4391483556bdb009eefda1caa21279ef54ccaf4eafe68b662fb4bf6/68747470733a2f2f7374796c6563692e696f2f7265706f732f3731373735363636332f736869656c643f6272616e63683d6d6173746572)](https://styleci.io/repos/717756663)[![MIT Software License](https://camo.githubusercontent.com/942e017bf0672002dd32a857c95d66f28c5900ab541838c6c664442516309c8a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)

This package provides features to:

1. Log changes, diff and comments to **Eloquent Models**;
2. Track and log the execution history of Laravel **Background Jobs**;

Model History
-------------

[](#model-history)

**Features**:

- Record model creation, update, delete, and retrieval
- Add optional comments to events
- Add comment-only history events
- Automatically record the IP, URL, user agent and user ids when in an HTTP context
- Automatically detect the CLI, the command name when in an artisan command
- Automatically detect the queue and the job when running in a queued job
- Define included/excluded fields on a per-model basis
- Has a diff of the changed fields (old/new values)

```
$task = Task::create(['title' => 'Get milk', 'status' => 'todo']);
History::begin($task);

$task->update(['status' => 'done']);
History::logRecentUpdate($task);
```

Job History
-----------

[](#job-history)

The goal of tracking a job is to be able to show the status and updates of a background job on frontends. It is similar to logging, but is always scoped to a given job execution, and adds state to each job execution.

**Features**:

- Track the execution status of Laravel Jobs
- Set and read the completion % of a job execution
- Write logs for job executions
- Detect the user that has executed the job

```
class MyJob implements \Konekt\History\Contracts\TrackableJob
{
    use \Konekt\History\Concerns\CanBeTracked;

    public function __construct(private array $dataToProcess)
    {
    }

    public function handle()
    {
        $tracker = $this->jobTracker();
        $tracker->setProgressMax(count($this->dataToProcess));
        $tracker->started();
        try {
            foreach ($this->dataToProcess as $data) {
                Do::something()->withThe($data);
                $tracker->advance();
                $tracker->logInfo('An entry was processed');
            }
            $tracker->completed();
        } catch (\Throwable $e) {
            $tracker->failed($e->getMessage());
        }
    }
}

MyJob::dispatch($myDataToProcess);
```

Requirements
------------

[](#requirements)

The current version of this package requires PHP 8.3+ and Laravel 11 - 13. PHP 8.1, 8.2 and Laravel 10 are supported in earlier releases.

It has been tested with:

- PHP 8.1, 8.2, 8.3, 8.4 & 8.5
- SQLite,
- MySQL 5.7, 8.0, 8.2 & 8.4,
- PostgreSQL 12, 15, 16, 17, 18.

It is known that this library, **Laravel 11.0/12.0 and PostgreSQL 11 don't work together**, therefore it is recommended to use at least Postgres version 12 or higher in case your DB engine is Postgres.

Documentation
-------------

[](#documentation)

For Installation and usage instruction see the Documentation;

###  Health Score

50

—

FairBetter than 95% of packages

Maintenance93

Actively maintained with recent releases

Popularity20

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor1

Top contributor holds 90.4% of commits — single point of failure

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

Every ~54 days

Recently: every ~38 days

Total

18

Last Release

36d ago

Major Versions

1.x-dev → 2.x-dev2026-05-28

PHP version history (3 changes)1.0.0PHP ^8.1

1.8.0PHP ^8.2

1.10.0PHP ^8.3

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/5520702?v=4)[konekt](/maintainers/konekt)[@konekt](https://github.com/konekt)

---

Top Contributors

[![fulopattila122](https://avatars.githubusercontent.com/u/1162360?v=4)](https://github.com/fulopattila122 "fulopattila122 (103 commits)")[![StyleCIBot](https://avatars.githubusercontent.com/u/11048387?v=4)](https://github.com/StyleCIBot "StyleCIBot (11 commits)")

---

Tags

laraveleloquenthistorykonekt

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/konekt-history/health.svg)

```
[![Health](https://phpackages.com/badges/konekt-history/health.svg)](https://phpackages.com/packages/konekt-history)
```

###  Alternatives

[mongodb/laravel-mongodb

A MongoDB based Eloquent model and Query builder for Laravel

7.1k8.4M96](/packages/mongodb-laravel-mongodb)[kirschbaum-development/eloquent-power-joins

The Laravel magic applied to joins.

1.6k32.6M46](/packages/kirschbaum-development-eloquent-power-joins)[psalm/plugin-laravel

Psalm plugin for Laravel

3355.3M346](/packages/psalm-plugin-laravel)[yajra/laravel-oci8

Oracle DB driver for Laravel via OCI8

8793.2M25](/packages/yajra-laravel-oci8)[glushkovds/phpclickhouse-laravel

Adapter of the most popular library https://github.com/smi2/phpClickHouse to Laravel

2051.5M2](/packages/glushkovds-phpclickhouse-laravel)[cybercog/laravel-love

Make Laravel Eloquent models reactable with any type of emotions in a minutes!

1.2k332.0k1](/packages/cybercog-laravel-love)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)