PHPackages                             hosseinesteki/activity\_log - 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. [Utility & Helpers](/categories/utility)
4. /
5. hosseinesteki/activity\_log

ActiveLibrary[Utility & Helpers](/categories/utility)

hosseinesteki/activity\_log
===========================

Laravel Activity Log Module for CRUD tracking and analytics

1.0.0(3mo ago)01PHP

Since Feb 5Pushed 3mo agoCompare

[ Source](https://github.com/HosseinEsteki/activity-log)[ Packagist](https://packagist.org/packages/hosseinesteki/activity_log)[ RSS](/packages/hosseinesteki-activity-log/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)DependenciesVersions (2)Used By (0)

Laravel Activity Log 📊
======================

[](#laravel-activity-log-)

ماژول **Activity Log** یک پکیج مستقل برای لاراول است که عملیات CRUD روی مدل‌ها را ثبت می‌کند و امکان تحلیل داده‌ها، جستجو و فیلتر پیشرفته را فراهم می‌سازد. این پکیج به شما کمک می‌کند تا رفتار کاربران و تغییرات داده‌ها را به صورت دقیق ردیابی کنید.

---

✨ ویژگی‌ها
----------

[](#-ویژگی‌ها)

- ثبت عملیات `create`, `update`, `delete` روی مدل‌ها
- ذخیره اطلاعات کاربر، IP، User Agent و URL درخواست
- ذخیره تغییرات قبل و بعد (before/after values)
- امکان افزودن داده‌های اضافی در ستون `meta`
- Facade برای دسترسی ساده به داده‌ها
- جستجو و فیلتر پیشرفته روی لاگ‌ها
- API آماده برای دریافت لاگ‌ها و آمار

---

📦 نصب
-----

[](#-نصب)

```
composer require hosseinesteki/activity-log
```

---

⚙️ پیکربندی
-----------

[](#️-پیکربندی)

پکیج به صورت خودکار ServiceProvider و Facade را رجیستر می‌کند. اگر نیاز به تنظیمات خاص دارید، می‌توانید فایل‌های migration را publish کنید:

```
php artisan vendor:publish --provider="Vendor\ActivityLog\ActivityLogServiceProvider" --tag=migrations
php artisan migrate
```

---

🛠 استفاده
---------

[](#-استفاده)

### افزودن Trait به مدل‌ها

[](#افزودن-trait-به-مدل‌ها)

```
use ActivityLog\Traits\HasActivityLog;

class Post extends Model
{
    use HasActivityLog;

    protected $fillable = ['title', 'content'];
}
```

### ذخیره لاگ دستی

[](#ذخیره-لاگ-دستی)

```
use ActivityLog;

ActivityLog::log([
    'user_id' => auth()->id(),
    'model'   => 'App\Models\Post',
    'action'  => 'update',
    'model_id'=> 12,
    'changes' => ['title' => ['old' => 'A', 'new' => 'B']],
]);
```

### دریافت لاگ‌ها با فیلتر

[](#دریافت-لاگ‌ها-با-فیلتر)

```
$logs = ActivityLog::all([
    'user_id' => 1,
    'action'  => 'update',
    'date_from' => '2026-02-01',
    'date_to'   => '2026-02-05',
]);
```

### جستجو

[](#جستجو)

```
$results = ActivityLog::search('Post', [
    'user_id' => 2,
]);
```

### آمار

[](#آمار)

```
$stats = ActivityLog::stats();
```

---

🌐 API Endpoints
---------------

[](#-api-endpoints)

پکیج دارای API آماده است:

- `GET /api/activity-log` → دریافت همه لاگ‌ها با فیلتر
- `GET /api/activity-log/search?q=keyword` → جستجو
- `GET /api/activity-log/stats` → دریافت آمار

نمونه:

```
GET /api/activity-log?user_id=1&action=update&date_from=2026-02-01&date_to=2026-02-05

```

---

📊 تحلیل داده‌ها
---------------

[](#-تحلیل-داده‌ها)

- بیشترین کاربر فعال
- بیشترین مدل تغییر یافته
- فیلدهایی که بیشتر تغییر کرده‌اند
- امکان اتصال به ابزارهای گزارش‌گیری مثل Chart.js یا PowerBI

---

📝 License
---------

[](#-license)

این پکیج تحت مجوز MIT منتشر شده است.

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance81

Actively maintained with recent releases

Popularity1

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity34

Early-stage or recently created project

 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

102d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/7d015f9519b649129f440267633506be9ca34b7edb313857dba3fbd9579b79c2?d=identicon)[HosseinEsteki](/maintainers/HosseinEsteki)

---

Top Contributors

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

### Embed Badge

![Health badge](/badges/hosseinesteki-activity-log/health.svg)

```
[![Health](https://phpackages.com/badges/hosseinesteki-activity-log/health.svg)](https://phpackages.com/packages/hosseinesteki-activity-log)
```

PHPackages © 2026

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