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 3w ago

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 31% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity5

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity55

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

1656d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/11370582?v=4)[Ahmed Dabak](/maintainers/ahmeddabak)[@ahmeddabak](https://github.com/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

[jdorn/sql-formatter

a PHP SQL highlighting library

3.9k117.2M118](/packages/jdorn-sql-formatter)[propel/propel1

Propel is an open-source Object-Relational Mapping (ORM) for PHP5.

8351.6M87](/packages/propel-propel1)[jfelder/oracledb

Oracle DB driver for Laravel

11518.4k](/packages/jfelder-oracledb)

PHPackages © 2026

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