PHPackages                             garcia1901l/laravel-activity-lite - 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 &amp; ORM](/categories/database)
4. /
5. garcia1901l/laravel-activity-lite

ActiveLaravel-package[Database &amp; ORM](/categories/database)

garcia1901l/laravel-activity-lite
=================================

Lightweight activity logger for Laravel

2.0.1(1y ago)03MITPHPPHP ^8.1

Since Apr 10Pushed 1y ago1 watchersCompare

[ Source](https://github.com/garcia1901l/laravel-activity-lite)[ Packagist](https://packagist.org/packages/garcia1901l/laravel-activity-lite)[ RSS](/packages/garcia1901l-laravel-activity-lite/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (3)Versions (8)Used By (0)

Laravel Activity Lite
=====================

[](#laravel-activity-lite)

[![Latest Version](https://camo.githubusercontent.com/dcaf8a76f3884857740d0b81a3766bd0f0d6875d8bfa6d6d512ba3758a84a1b0/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f676172636961313930316c2f6c61726176656c2d61637469766974792d6c697465)](https://packagist.org/packages/garcia1901l/laravel-activity-lite)
[![PHP Version](https://camo.githubusercontent.com/76372889b8e9e5a0cb88b0e56d362dfabddbb8cca8599c68f409b87805dd94af/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d372e322e352532422d626c7565)](https://php.net)
[![Laravel Version](https://camo.githubusercontent.com/0026beefea4fe68a4490014600e6c87191f4ddebafa78ee088202981f4d27cce/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d372e78253230746f25323031322e782d6f72616e6765)](https://laravel.com)
[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](LICENSE)

Lightweight activity logger for Laravel using MongoDB (Laravel 10–12 compatible).

---

✨ Features
----------

[](#-features)

- 🚀 Automatic model activity tracking (create/update/delete)
- 🔍 MongoDB database for lightweight operation
- 👤 Tracks causer (user, artisan, queue jobs)
- ⚡ Configurable event logging
- 📊 Powerful querying capabilities
- 📦 Easy installation and setup

---

Requisitos de MongoDB
---------------------

[](#requisitos-de-mongodb)

El paquete es compatible con estas versiones del driver oficial:

- `mongodb/laravel-mongodb`: 3.8+ (incluye v4 y v5)
- PHP extension `mongodb`: 1.10+

Si necesitas usar una versión diferente, instálala manualmente:

```
composer require mongodb/laravel-mongodb:"YOUR_VERSION"

## 📦 Installation

### 1. Install via Composer

```bash
composer require garcia1901l/laravel-activity-lite
```

**Optional:** Publish the configuration file:

```
php artisan vendor:publish --provider="Garcia1901l\LaravelActivityLite\ActivityLiteServiceProvider"
```

### 2. Run the installation command

[](#2-run-the-installation-command)

```
php artisan activity-lite:install
```

This will:

- Create the MongoDB database
- Run the required migrations

---

🧑‍💻 Basic Usage
---------------

[](#‍-basic-usage)

Add the trait to your models:

```
use Garcia1901l\LaravelActivityLite\Traits\LogsActivity;
use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    use LogsActivity;
}
```

---

🔧 Advanced Usage
----------------

[](#-advanced-usage)

### Manual Logging

[](#manual-logging)

```
User::logManualAction('custom_action', [
    'message' => 'Special event occurred',
    'data' => ['key' => 'value']
]);
```

### Query Logs

[](#query-logs)

```
# View recent activity
php artisan activity-lite:query --days=7

# Filter by model
php artisan activity-lite:query --model=User

# Filter by action
php artisan activity-lite:query --action=updated

# Export results
php artisan activity-lite:query --days=30 --json
php artisan activity-lite:query --days=30 --csv
```

---

⚙️ Configuration
----------------

[](#️-configuration)

Publish the config file:

```
php artisan vendor:publish --tag=activity-lite-config
```

Example of `config/activity-lite.php`:

```
return [
    'enabled' => true,
    'database_name' => 'activity_lite',
    'events' => ['created', 'updated', 'deleted', 'soft_deleted', 'force_deleted', 'restored'],
    'except' => [], // Models to exclude
];
```

---

🗃️ Database Structure
---------------------

[](#️-database-structure)

The `activity_logs` table includes:

ColumnTypeDescriptionidbigintPrimary keyactionstringPerformed actionlog\_typestring'model' or 'manual'model\_typestringModel classmodel\_idbigintModel IDcauser\_typestringWho performed the actioncauser\_idbigintCauser IDdatajsonChange datacreated\_attimestampCreation timeupdated\_attimestampLast update time---

🛠️ Customization
----------------

[](#️-customization)

### Temporarily disable logging

[](#temporarily-disable-logging)

```
config(['activity-lite.enabled' => false]);
```

### Exclude specific models

[](#exclude-specific-models)

```
'except' => [
    App\Models\SensitiveModel::class,
],
```

### Log only specific attributes and ignore others

[](#log-only-specific-attributes-and-ignore-others)

```
public function getActivityLogOptions(): array
{
    return [
        'log_attributes' => ['name', 'email'],
        'ignore_attributes' => ['password', 'remember_token']
    ];
}
```

---

✅ Requirements
--------------

[](#-requirements)

- PHP 8.1+
- Laravel 10.x to 12.x
- MongoDB extension for PHP

---

📄 License
---------

[](#-license)

MIT License. See [LICENSE](LICENSE) for details.

---

👤 Author
--------

[](#-author)

Frank Garcia

###  Health Score

29

—

LowBetter than 60% of packages

Maintenance48

Moderate activity, may be stable

Popularity3

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity51

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 ~3 days

Total

7

Last Release

380d ago

Major Versions

v1.0.2 → 2.0.02025-04-27

1.0.3 → 2.0.12025-04-28

PHP version history (2 changes)v1.0.0PHP ^7.2.5|^8.0

2.0.0PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/2cf4112a341a016f0c24ddf192795ed91f7dfc03e1e4ea924a652a56798c925b?d=identicon)[garcia1901l](/maintainers/garcia1901l)

---

Top Contributors

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

---

Tags

laravelmonitoringtrackingactivityAuditmongodblogger

### Embed Badge

![Health badge](/badges/garcia1901l-laravel-activity-lite/health.svg)

```
[![Health](https://phpackages.com/badges/garcia1901l-laravel-activity-lite/health.svg)](https://phpackages.com/packages/garcia1901l-laravel-activity-lite)
```

###  Alternatives

[mongodb/laravel-mongodb

A MongoDB based Eloquent model and Query builder for Laravel

7.1k7.2M71](/packages/mongodb-laravel-mongodb)[owen-it/laravel-auditing

Audit changes of your Eloquent models in Laravel

3.4k33.0M95](/packages/owen-it-laravel-auditing)[watson/validating

Eloquent model validating trait.

9723.3M47](/packages/watson-validating)[cybercog/laravel-ban

Laravel Ban simplify blocking and banning Eloquent models.

1.1k651.8k11](/packages/cybercog-laravel-ban)[dyrynda/laravel-model-uuid

This package allows you to easily work with UUIDs in your Laravel models.

4802.8M8](/packages/dyrynda-laravel-model-uuid)[pdphilip/elasticsearch

An Elasticsearch implementation of Laravel's Eloquent ORM

145360.2k4](/packages/pdphilip-elasticsearch)

PHPackages © 2026

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