PHPackages                             lase-peco/records - 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. lase-peco/records

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

lase-peco/records
=================

1.0(4y ago)15MITPHPPHP ^7.4|^8.0

Since Dec 21Pushed 4y agoCompare

[ Source](https://github.com/lase-peco/records)[ Packagist](https://packagist.org/packages/lase-peco/records)[ RSS](/packages/lase-peco-records/feed)WikiDiscussions master Synced today

READMEChangelog (1)Dependencies (2)Versions (2)Used By (0)

Record the activities in your Laravel project.
==============================================

[](#record-the-activities-in-your-laravel-project)

[![Latest Version on Packagist](https://camo.githubusercontent.com/08f73ce8b15e2f57fdcd8b064e1528b265611d2e3557ce7a571974701aa854e0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6c6173652d7065636f2f7265636f7264732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/lase-peco/records)[![Total Downloads](https://camo.githubusercontent.com/f3df16ba4b6151bde3d6c94bbb2725bd9e279e47574dac480ce0256f8082d7c4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6c6173652d7065636f2f7265636f7264732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/lase-peco/records)

The `lase-peco/records` is a simple library to record all kind of activities inside your Laravel project. It has practical functions to record the activities in your project. the records will be stored in the `records` table.

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require lase-peco/records
```

After installing the package you can create the `records` table by running the migrations:

```
php artisan migrate
```

Usage
-----

[](#usage)

The simplest way to use the package is to use the included helper function `record()`:

```
record('Oh, Something happened here!') // yes, it is that simple!
```

You can fetch all the records using the Model `LasePeCo\Records\Models\Record`

```
use LasePeCo\Records\Models\Record;

Record::all();
```

Now an advanced example:

```
record()
    ->by($anElequentModel)
    ->onSubject($anElequentModel)
    ->properties(['someProperty' => 'someValue'])
    ->message('Oh, Something happened here!');
```

You can retrieve the data from the record as following:

```
use LasePeCo\Records\Models\Record;

$record = Record::all()->last();

$record->subject; //returns an instance of an eloquent model
$record->causer; //returns an instance of an eloquent model
$record->properties; //returns an array ['someProperty' => 'someValue']
$record->message; //returns 'Oh, Something happened here!'
```

If you don't provide the causer, when creating the record, then by default the authenticated user will be added as a causer for the record. If there is no authenticated user, then the causer will be null.

### Options

[](#options)

Optionally you can save the `IP` of the request in your record by chaining the `withIp()` method on the helper function `record()`. The IP will be anonymized and saved in the record.

```
record('Oh, Something happened here!')->withIp();

use LasePeCo\Records\Models\Record;

$record = Record::all()->last();

$record->ip // return 12.214.31.***
```

Testing
-------

[](#testing)

```
composer test
```

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

### Security

[](#security)

If you discover any security related issues, please email  instead of using the issue tracker.

Credits
-------

[](#credits)

- [Ahmed Dabak](https://github.com/lase-peco)
- [Abdulsalam Emesh](https://github.com/lase-peco)
- [All Contributors](CONTRIBUTING.md)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity5

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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

Unknown

Total

1

Last Release

1600d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/080a1234e6194cdfdf036f405d60e4456fde92754160a1b0d1e1035ef6e03b9e?d=identicon)[ahmeddabak](/maintainers/ahmeddabak)

---

Top Contributors

[![ahmeddabak](https://avatars.githubusercontent.com/u/11370582?v=4)](https://github.com/ahmeddabak "ahmeddabak (4 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/lase-peco-records/health.svg)

```
[![Health](https://phpackages.com/badges/lase-peco-records/health.svg)](https://phpackages.com/packages/lase-peco-records)
```

###  Alternatives

[doctrine/orm

Object-Relational-Mapper for PHP

10.2k285.3M6.2k](/packages/doctrine-orm)[jdorn/sql-formatter

a PHP SQL highlighting library

3.9k115.1M102](/packages/jdorn-sql-formatter)[illuminate/database

The Illuminate Database package.

2.8k52.4M9.3k](/packages/illuminate-database)[mongodb/mongodb

MongoDB driver library

1.6k64.0M543](/packages/mongodb-mongodb)[ramsey/uuid-doctrine

Use ramsey/uuid as a Doctrine field type.

90340.3M209](/packages/ramsey-uuid-doctrine)[reliese/laravel

Reliese Components for Laravel Framework code generation.

1.7k3.4M16](/packages/reliese-laravel)

PHPackages © 2026

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