# easyadmin81

**Repository Path**: mr-dxy/easyadmin81

## Basic Information

- **Project Name**: easyadmin81
- **Description**: 最新easyadmin，升级了TP8.1.4、orm4.0.5，增加了安全管理等功能，外包或者个人项目可以使用该开发框架
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-10
- **Last Updated**: 2026-09-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


![EasyAdmin-logo](public/static/common/images/logo-2.png)

[![Php Version](https://img.shields.io/badge/php-%3E=8.4-brightgreen.svg?maxAge=2592000&color=yellow)](https://github.com/php/php-src)
[![Mysql Version](https://img.shields.io/badge/mysql-%3E=5.7-brightgreen.svg?maxAge=2592000&color=orange)](https://www.mysql.com/)
[![Thinkphp Version](https://img.shields.io/badge/thinkphp-8.1.x-brightgreen.svg?maxAge=2592000)](https://github.com/top-think/framework)
[![Layui Version](https://img.shields.io/badge/layui-2.13.9-brightgreen.svg?maxAge=2592000&color=critical)](https://github.com/sentsin/layui)
[![EasyAdmin License](https://img.shields.io/badge/license-MIT-green?maxAge=2592000&color=blue)](LICENSE)

## 项目介绍

基于 ThinkPHP 8.1 和 layui 2.13 的快速开发后台管理系统。

本仓库是基于官方 [zhongshaofa/easyadmin v2](https://github.com/zhongshaofa/easyadmin/tree/v2) → [cshaptx4869/easyadmin](https://gitee.com/cshaptx4869/easyadmin) 的**个人深度定制维护版**，面向 PHP 8.4 做了全面兼容升级，并新增了安全防护、深色模式、备份体系等一整套自用功能。

> 文档地址：
> - 官方文档：http://easyadmin.99php.cn/docs
> - cshaptx4869 维护版 Wiki：https://github.com/cshaptx4869/easyadmin/wiki
> - 本仓库 Wiki：https://gitee.com/mr-dxy/easyadmin_v8/wikis/pages

## 感谢巨人

- 感谢原作者：[zhongshaofa/easyadmin](https://github.com/zhongshaofa/easyadmin)
- 感谢维护者：[cshaptx4869/easyadmin](https://gitee.com/cshaptx4869/easyadmin)

## 环境要求

- PHP >= 8.4
- MySQL >= 5.7
- Composer

## 安装教程

```bash
# 克隆项目
git clone https://gitee.com/mr-dxy/easyadmin_v8.git

# 安装依赖
composer install

# 复制环境配置并按需修改数据库等参数
cp .example.env .env
```

随后访问站点进入 Web 安装向导（或手动导入 `config/install/sql/install.sql`），安装完成后请删除/锁定 `config/install/lock/install.lock` 状态。

## 本仓库相对上游的主要改动

### PHP 8.4 兼容与依赖升级
- ThinkPHP 框架升级至 8.1.4、think-orm 4.0.51，并修复 PHP 8.2+ 兼容问题
- think-filesystem 升级 3.0（消除 flysystem v1 的 PHP 8.4 弃用提示）
- 七牛 SDK 替换为社区维护版 `wolfcode/qiniu-php-sdk ^8.0`
- RequireJS 升级 2.3.8
- 修复批量删除等 POST 传参绑定失败（`action_bind_param=param`）

### 安全防护模块（新增）
- IP 黑白名单管理、安全日志查看
- 密码爆破防护：窗口期内登录失败达到阈值自动封禁 IP，到期自动解封
- 简易 WAF：SQL 注入 / XSS / 代码执行 / 文件包含 / 命令执行特征检测，命中可自动拉黑
- 已登录管理员跳过特征扫描、敏感字段排除，避免误伤（详见 `config/security.php`）
- CSRF 中间件（`.env` 中 `IS_CSRF` 开关）

### 深色模式（新增）
- 完整的后台深色主题（`layui-theme-dark.css`，`.dark` 作用域统一维护）
- 浅/深色切换，iframe 与弹窗主题自动跟随
- tableSelect、公告弹窗、页签控制面板等组件均已适配深浅色

### 数据库备份 / 附件备份（增强）
- 全库备份补齐触发器、存储过程/函数、事件（EVENT），使用 utf8mb4 连接
- 全库备份自动打包上传文件，备份列表支持下载与勾选批量删除
- 独立的附件备份功能（仅备份上传文件）
- 备份列表页改为左侧类型菜单 + 右侧内容布局

### 定时任务（增强）
- 新增内置任务类型：数据库全库备份 / 附件备份 / 超 30 天日志清理，UI 下拉直接可选
- 频率选择器、内置任务识别与类型筛选
- 任务表单字段白名单过滤、内置任务下隐藏字段不再触发 required 校验
- 任务日志输出剥离 ANSI 颜色转义序列

### 其他
- 操作日志按月分表记录
- 本地上传 URL 改存相对路径，摆脱域名绑定
- 重写 `Uploadfile::delete`，修复删除记录时的文件清理逻辑缺陷
- 修复日志列表操作内容显示 `[object Object]` 的问题

### 继承自 cshaptx4869 维护版的功能
1. 数据库备份、还原功能
2. 修复删除图片时将文件删除
3. 修复 tableSelect 组件的 bug
4. 颜色模式切换、主题元素切换
5. 计划任务启动和关闭
6. 登录页面背景图片设置
7. 登录页面动态效果开关
8. table 中时间格式化 `dateYmd`
9. table 使用 layui 原生 toolbar 的功能

## 项目特性

* 快速 CURD 命令行
    * 一键生成控制器、模型、视图、JS 文件
    * 支持关联查询、字段设置等等
* 基于 `auth` 的权限管理系统
    * 通过注解方式实现 auth 权限节点管理
    * 一键更新 auth 权限节点，无需手动输入
    * 完善的后端权限验证以及前端页面按钮显示、隐藏控制
* 完善的菜单管理
    * 分模块管理、无限极菜单
    * 菜单编辑会提示权限节点
* 完善的上传组件
    * 本地存储
    * 阿里云 OSS（建议使用）
    * 腾讯云 COS
    * 七牛云 OSS
* 完善的前端组件
    * 对 layui 的 form 表单重新封装，无需手动拼接数据请求
    * 简单好用的图片、文件上传组件
    * 简单好用的富文本编辑器 ckeditor
    * 弹出层、table 表格再次封装，使用更简洁
    * 根据 table 的 `cols` 参数扩展 `image`、`switch`、`list` 等列渲染，且可自行继续扩展
    * 根据 table 参数一键生成搜索表单，无需自己编写
* 完善的后台操作日志
    * 记录用户的详细操作信息
    * 按月份进行分表记录
* 一键部署静态资源到 OSS
    * `public/static` 目录下文件均可一键部署
    * 一个配置项切换静态资源（OSS / 本地）
* 上传文件记录管理
* 后台路径自定义，防止别人找到后台地址

## 定时任务说明

定时任务基于 `cshaptx4869/http-crontab` 常驻进程实现：

```bash
# 启动定时任务服务（后台运行请自行配合 supervisor / 守护进程）
php think crontab
```

- 服务地址与安全秘钥通过 `.env` 中 `CRONTAB_BASE_URI`、`CRONTAB_SAFE_KEY` 配置
- 内置任务（数据库备份 / 附件备份 / 日志清理）在 `config/crontab.php` 的 `builtin_tasks` 中注册
- 相关命令行：`php think backup:run`（数据库/附件备份）、`php think log:clean`（日志清理）

## 开源协议

[MIT](LICENSE)