PHPackages                             kentjerone/fluent-activity-logger - 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. kentjerone/fluent-activity-logger

ActiveLibrary[Logging & Monitoring](/categories/logging)

kentjerone/fluent-activity-logger
=================================

A fluent activity logger for models

v1.0.1(6mo ago)02MITPHPPHP ^8.2CI passing

Since Sep 30Pushed 6mo agoCompare

[ Source](https://github.com/ramosramosramos/fluent-activity-logger)[ Packagist](https://packagist.org/packages/kentjerone/fluent-activity-logger)[ RSS](/packages/kentjerone-fluent-activity-logger/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (2)Dependencies (6)Versions (3)Used By (0)

---

Laravel Activity Logger
=======================

[](#laravel-activity-logger)

An activity logger for Eloquent models.

---

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

[](#installation)

Install via Composer:

```
composer require kentjerone/laravel-activity-logger
```

Publish the config and migrations:

```
php artisan vendor:publish --tag="activity-logger-config"
php artisan vendor:publish --tag="activity-logger-migrations"
```

Run the migrations:

```
php artisan migrate
```

This will publish:

- `config/activitylogger.php` → package configuration
- `database/migrations/xxxx_xx_xx_xxxxxx_create_activity_logs_table.php` → migration file

---

Configuration
-------------

[](#configuration)

Inside `config/activitylogger.php` you can configure:

```
declare(strict_types=1);

return [

    'table_name' => (string) env('ACTIVITY_LOGGER_TABLE', 'activity_logs'),

    'model_events' => (array) [

        'created' => true,
        'updated' => true,
        'deleted' => true,

        'restored' => false,
        'forceDeleted' => false,

        'creating' => false,
        'updating' => false,
        'deleting' => false,

    ],

    'request_payload' => [
        'except' => [
            'password',
            'password_confirmation',
            'remember_token',
        ],
    ],

];
```

---

In Model
--------

[](#in-model)

To enable automatic logging for a model:

```
use KentJerone\ActivityLogger\Models\Concerns\HasAuthActivityLogger;

class User extends Authenticatable
{
   use HasAuthActivityLogger;
}
```

---

Usage
-----

[](#usage)

> **Note:** If you don’t pass a model (`made_by_model`), the logger will automatically use the currently authenticated user (`auth()->user()`).

```
// Example 1: Quick log without passing a model (defaults to auth()->user())
createActivityLog(
    human_message: 'Profile updated'
);

// Example 2: Quick log with a model
$user = \App\Models\User::factory()->create()->fresh();

createActivityLog(
    made_by_model:$user,
    human_message: 'User registered',
    human_extra_message: ['email' => $user->email]
);

// Example 3: Using the CreateActivityLog action directly
$user = \App\Models\User::factory()->create()->fresh();

createActivityLog()->handle(
    made_by_model:$user,
    human_message: 'User created via factory',
    developer_message: 'POST /register',
    developer_extra_message: ['ip' => request()->ip()],
    application_extra_message: ['debug' => 'custom app info']
);
```

---

Fluent Activity Builder
-----------------------

[](#fluent-activity-builder)

You can also use the `activity()` helper for a clean, chainable syntax:

```
// Minimal log
activity()
    ->humanMessage('User updated profile')
    ->create();

// With model and extra messages
$user = \App\Models\User::factory()->create()->fresh();

activity()
    ->madeByModel($user)
    ->humanMessage('User registered')
    ->humanExtraMessage(['email' => $user->email])
    ->developerMessage('POST /register')
    ->developerExtraMessage(['ip' => request()->ip()])
    ->applicationExtraMessage(['debug' => 'custom app info'])
    ->create();
```

---

Which Style to Use?
-------------------

[](#which-style-to-use)

StyleExampleWhen to Use**Quick helper**`activityLog($user, human_message: 'User registered')`Simple one-liner logs.**Action**`createActivityLog()->handle($user, ...)`When you need full control and explicit arguments.**Builder**`Activity::make()->humanMessage(...)->create()`When building logs step by step.**Helper Builder**`activity()->humanMessage(...)->create()`Cleanest, most expressive way for everyday use.---

Human vs Developer Messages
---------------------------

[](#human-vs-developer-messages)

- **human\_message / human\_extra\_message** → Intended for business or end-user context (e.g., *"User updated their profile"*)
- **developer\_message / developer\_extra\_message** → Intended for debugging, HTTP request details, or developer insight (e.g., *"PATCH /users/1"*)
- **application\_message / application\_extra\_message** → Automatic or extra system-level context (IP, user agent, URL, old/new changes, etc.)

---

Getting the Log Activities
--------------------------

[](#getting-the-log-activities)

```
activityLog()->all();
```

You can also query directly via the model:

```
use KentJerone\ActivityLogger\ActivityLog;

$logs = ActivityLog::latest()->take(10)->get();
```

---

License
-------

[](#license)

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

---

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance65

Regular maintenance activity

Popularity2

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity49

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

Every ~11 days

Total

2

Last Release

209d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/abaefc12178b443df4d2fc9fff1e00ce5b7749598d8d3bac9f8a607d69d86eba?d=identicon)[ramosramosramos](/maintainers/ramosramosramos)

---

Top Contributors

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

---

Tags

laravelfluentloggeractivity logger

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/kentjerone-fluent-activity-logger/health.svg)

```
[![Health](https://phpackages.com/badges/kentjerone-fluent-activity-logger/health.svg)](https://phpackages.com/packages/kentjerone-fluent-activity-logger)
```

###  Alternatives

[marvinlabs/laravel-discord-logger

Logging to a discord channel in Laravel

2081.1M2](/packages/marvinlabs-laravel-discord-logger)[ytake/laravel-aspect

Aspect Oriented Programming library for laravel framework, and lumen

138132.2k1](/packages/ytake-laravel-aspect)[ytake/laravel-fluent-logger

fluent logger for laravel and lumen

63541.6k1](/packages/ytake-laravel-fluent-logger)[illuminated/console-logger

Logging and Notifications for Laravel Console Commands.

8674.9k](/packages/illuminated-console-logger)[kabbouchi/laravel-logger-discord-channel

A Discord based Monolog driver for Laravel

149.5k](/packages/kabbouchi-laravel-logger-discord-channel)[hryha/laravel-request-logger

A Laravel package to log requests and responses

102.2k](/packages/hryha-laravel-request-logger)

PHPackages © 2026

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