PHPackages                             xianghuawe/laravel-admin-operation-log-statistic - 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. [Admin Panels](/categories/admin)
4. /
5. xianghuawe/laravel-admin-operation-log-statistic

ActiveLibrary[Admin Panels](/categories/admin)

xianghuawe/laravel-admin-operation-log-statistic
================================================

laravel admin operation log statistic

v1.0.1.1(3mo ago)0321MITPHPPHP >=8.1.0CI passing

Since Nov 29Pushed 3mo agoCompare

[ Source](https://github.com/xianghuawe/laravel-admin-operation-log-statistic)[ Packagist](https://packagist.org/packages/xianghuawe/laravel-admin-operation-log-statistic)[ Docs](https://github.com/xianghuawe/laravel-admin-operation-log-statistic)[ RSS](/packages/xianghuawe-laravel-admin-operation-log-statistic/feed)WikiDiscussions main Synced 3w ago

READMEChangelog (10)Dependencies (8)Versions (13)Used By (0)

Laravel Admin Operation Log Statistic
=====================================

[](#laravel-admin-operation-log-statistic)

项目介绍
----

[](#项目介绍)

Laravel Admin Operation Log Statistic 是一个为 laravel-admin 框架开发的操作日志统计扩展包。它可以自动统计后台用户的操作日志，提供直观的数据报表，并在操作频率异常时发送警告通知。

功能特性
----

[](#功能特性)

- ✅ 自动统计每日操作日志
- ✅ 提供操作频率异常警告
- ✅ 支持按日期、用户、角色等条件筛选统计数据
- ✅ 可视化展示统计结果
- ✅ 支持邮件通知功能
- ✅ 可配置的统计规则

安装
--

[](#安装)

### 1. 安装依赖

[](#1-安装依赖)

使用 Composer 安装扩展包：

```
composer require xianghuawe/laravel-admin-operation-log-statistic
```

### 2. 发布配置和迁移文件

[](#2-发布配置和迁移文件)

```
# 发布配置文件
php artisan vendor:publish --tag=operation-log-statistic-config

# 发布迁移文件
php artisan vendor:publish --tag=operation-log-statistic-migrations

# 发布语言文件
php artisan vendor:publish --tag=operation-log-statistic-lang
```

### 3. 运行迁移

[](#3-运行迁移)

```
php artisan migrate
```

### 4. 配置环境变量

[](#4-配置环境变量)

在 `.env` 文件中添加以下配置：

```
# 启用操作日志统计功能
OPERATION_LOG_STATISTIC_ENABLE=true

# 统计任务执行时间（24小时制）
OPERATION_LOG_STATISTIC_AT=09:55

# 操作频率限制（超过此值会触发警告）
ADMIN_OPERATION_LOG_REQUEST_RATE_LIMIT_COUNT=100

# 通知相关配置（可选）
ADMIN_NOTIFICATION_CLIENT_ID=
ADMIN_NOTIFICATION_CLIENT_SECRET=
ADMIN_NOTIFICATION_URI=
ADMIN_NOTIFICATION_ENDPOINT=notifications
```

配置说明
----

[](#配置说明)

扩展包的配置文件位于 `config/admin.php`，主要配置项如下：

```
'operation-log-statistic' => [
    'enable'   => env('OPERATION_LOG_STATISTIC_ENABLE', false), // 是否启用统计功能
    'daily_at' => env('OPERATION_LOG_STATISTIC_AT', '09:55'), // 统计任务执行时间
],
```

使用
--

[](#使用)

### 1. 查看统计报表

[](#1-查看统计报表)

安装完成后，在 laravel-admin 后台可以看到「操作日志统计」菜单，点击进入即可查看统计报表。

统计报表支持以下筛选条件：

- 用户角色
- 邀请码
- 用户名
- 姓名
- 日期范围
- 操作总数

### 2. 定时任务

[](#2-定时任务)

扩展包会自动注册一个每日执行的定时任务，用于统计前一天的操作日志。确保你的 Laravel 应用已经配置了定时任务：

```
# 启动定时任务处理器
php artisan schedule:work
```

### 3. 手动执行统计

[](#3-手动执行统计)

如果需要手动执行统计任务，可以使用以下命令：

```
php artisan admin-operation-logs:statistic
```

数据结构
----

[](#数据结构)

### 统计数据表 `admin_operation_log_statistics`

[](#统计数据表-admin_operation_log_statistics)

字段名类型描述idbigint主键datedate统计日期user\_idbigint用户IDcompany\_idbigint公司ID（可选）totalint当日操作总数top\_numint最频繁操作的次数top\_pathstring最频繁操作的路径created\_attimestamp创建时间updated\_attimestamp更新时间注意事项
----

[](#注意事项)

1. 确保 laravel-admin 已经安装并配置完成
2. 确保操作日志表 `admin_operation_logs` 存在
3. 定时任务需要正常运行才能自动统计
4. 邮件通知功能需要配置正确的通知服务

代码质量检查
------

[](#代码质量检查)

本项目集成了完整的代码质量检查工具，确保代码的规范性和稳定性。

### 本地运行代码质量检查

[](#本地运行代码质量检查)

使用以下命令在本地运行完整的代码质量检查：

```
# 运行所有代码质量检查
./scripts/run-code-quality.sh

# 单独运行 Laravel Pint（代码风格检查）
php vendor/bin/pint --test

# 单独运行 PHPStan（静态代码分析）
php vendor/bin/phpstan analyze

# 单独运行 PHPUnit（单元测试）
php vendor/bin/phpunit
```

### GitHub Actions 工作流

[](#github-actions-工作流)

项目配置了 GitHub Actions 工作流，会在每次推送和拉取请求时自动运行代码质量检查：

- **代码风格检查**：使用 Laravel Pint 检查代码风格
- **静态代码分析**：使用 PHPStan 进行静态代码分析
- **单元测试**：使用 PHPUnit 运行单元测试

工作流配置文件位于 `.github/workflows/code-quality.yml`。

贡献
--

[](#贡献)

欢迎提交 Issue 和 Pull Request！

### 贡献指南

[](#贡献指南)

1. 确保你的代码符合项目的代码风格规范
2. 运行本地代码质量检查确保没有问题
3. 提交 Pull Request 前确保所有检查通过

许可证
---

[](#许可证)

MIT License

作者
--

[](#作者)

xianghuawe - [xianghua\_we@163.com](mailto:xianghua_we@163.com)

###  Health Score

39

—

LowBetter than 85% of packages

Maintenance81

Actively maintained with recent releases

Popularity8

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

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

11

Last Release

101d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/5b7843c155246e6fddcc55487944304511a9a01329639f36a07ba48c3014f04a?d=identicon)[xianghua\_we](/maintainers/xianghua_we)

---

Top Contributors

[![hanhanwink](https://avatars.githubusercontent.com/u/25213792?v=4)](https://github.com/hanhanwink "hanhanwink (41 commits)")[![nmasd](https://avatars.githubusercontent.com/u/68934899?v=4)](https://github.com/nmasd "nmasd (9 commits)")

---

Tags

laravel-adminoperation-log-statistic

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/xianghuawe-laravel-admin-operation-log-statistic/health.svg)

```
[![Health](https://phpackages.com/badges/xianghuawe-laravel-admin-operation-log-statistic/health.svg)](https://phpackages.com/packages/xianghuawe-laravel-admin-operation-log-statistic)
```

###  Alternatives

[backpack/crud

Quickly build admin interfaces using Laravel, Bootstrap and JavaScript.

3.4k3.6M217](/packages/backpack-crud)[printnow/laravel-admin

Dcat admin 永久分叉版 / 支持 Laravel 10-13, PHP 版本限制 >= 8.1（支持 PHP 8.5）

472.4k](/packages/printnow-laravel-admin)

PHPackages © 2026

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