PHPackages                             zoujingli/thinkadmin - 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. zoujingli/thinkadmin

ActiveProject

zoujingli/thinkadmin
====================

Application Development Framework

v6.1.71(6mo ago)2.3k12.0k↑26.3%841[10 issues](https://github.com/zoujingli/ThinkAdmin/issues)[1 PRs](https://github.com/zoujingli/ThinkAdmin/pulls)MITPHPPHP >=7.1CI failing

Since Jun 24Pushed 3mo ago137 watchersCompare

[ Source](https://github.com/zoujingli/ThinkAdmin)[ Packagist](https://packagist.org/packages/zoujingli/thinkadmin)[ Docs](https://thinkadmin.top)[ RSS](/packages/zoujingli-thinkadmin/feed)WikiDiscussions v6 Synced 1mo ago

READMEChangelog (2)Dependencies (2)Versions (19)Used By (0)Security (6)

ThinkAdmin
==========

[](#thinkadmin)

[![Latest Stable Version](https://camo.githubusercontent.com/9adeb3c0d34650d6df2bcd9be64c59a88f039af3be3c277009b0a5ef8574770c/68747470733a2f2f706f7365722e707567782e6f72672f7a6f756a696e676c692f7468696e6b61646d696e2f762f737461626c65)](https://packagist.org/packages/zoujingli/thinkadmin)[![Total Downloads](https://camo.githubusercontent.com/b955260816d460b39f991df4a06d16d1d055898c31c17571796c7612c3eebeb1/68747470733a2f2f706f7365722e707567782e6f72672f7a6f756a696e676c692f7468696e6b61646d696e2f646f776e6c6f616473)](https://packagist.org/packages/zoujingli/thinkadmin)[![Monthly Downloads](https://camo.githubusercontent.com/af42c84ddaecd74301806e72d157a2ccecb5691a8a91b3d883dc40c63a5ab51e/68747470733a2f2f706f7365722e707567782e6f72672f7a6f756a696e676c692f7468696e6b61646d696e2f642f6d6f6e74686c79)](https://poser.pugx.org/zoujingli/thinkadmin)[![Daily Downloads](https://camo.githubusercontent.com/3fcab9c4992126912f7a082aee72374614818b9faffab747f3b56445a6381fd9/68747470733a2f2f706f7365722e707567782e6f72672f7a6f756a696e676c692f7468696e6b61646d696e2f642f6461696c79)](https://poser.pugx.org/zoujingli/thinkadmin)[![License](https://camo.githubusercontent.com/dcd773c9f3881ef75b82643123d359febd5766a4c42798a19a64d84d35864f0a/68747470733a2f2f706f7365722e707567782e6f72672f7a6f756a696e676c692f7468696e6b61646d696e2f6c6963656e7365)](https://packagist.org/packages/zoujingli/thinkadmin)[![PHP Version](https://camo.githubusercontent.com/ea1981b82245d665d0a74d4f6afa46433325109dc8099e3b024a99f9cbc210ef/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344372e312d626c75652e737667)](https://www.php.net/)[![ThinkPHP](https://camo.githubusercontent.com/e06b715d0d42e90938129a8a376c86291ed0df8b9a327a25fda0d3b24ab425da/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5468696e6b5048502d36253230253743253230382d627269676874677265656e2e737667)](https://www.thinkphp.cn/)

基于 **ThinkPHP 6 & 8** 的现代化后台管理系统，采用 **Composer 插件定制**，提供完整的后台管理解决方案。系统遵循 **MIT** 开源协议，专为快速开发而设计，深度定制 Composer 插件，实现专属插件生态管理架构，可将应用模块封装成独立插件包。

项目简介
----

[](#项目简介)

**ThinkAdmin** 是一个功能强大的后台管理系统，基于最新的 **ThinkPHP 6 & 8** 框架开发，专为简化后台管理流程而设计。系统采用现代化的技术栈，提供丰富的功能模块和插件生态，帮助开发者快速构建企业级后台管理系统。

### 核心优势

[](#核心优势)

- **🚀 快速开发** - 基于 ThinkPHP 6 & 8 框架，提供完整的后台管理功能，开箱即用
- **🔌 插件生态** - 支持 Composer 插件管理，可扩展性强，支持热插拔
- **⚡ 稳定可靠** - 经过多个项目实践验证，系统稳定，性能优异
- **🛡️ 安全完善** - 内置 RBAC 权限管理、操作日志、数据加密等安全机制
- **📚 文档齐全** - 提供完整的开发文档和使用指南，学习成本低
- **🚀 现代化架构** - 支持多应用模式、异步任务、文件存储等现代特性

### 适用场景

[](#适用场景)

- **快速原型开发** - MVP 产品、概念验证、演示系统
- **企业管理系统** - CRM、ERP、OA、财务系统
- **SaaS 平台** - 多租户应用、订阅服务、API 管理
- **学习研究** - 技术学习、框架研究、最佳实践

在线演示
----

[](#在线演示)

- **演示地址**:
- **默认账号**: admin
- **默认密码**: admin

特性
--

[](#特性)

- 🚀 **快速开发** - 基于 ThinkPHP 6 & 8，开箱即用
- 🔌 **插件生态** - 支持 Composer 插件管理，热插拔
- 💾 **文件存储** - 支持多种存储方案，文件秒传
- 🔐 **权限管理** - 基于注解的 RBAC 权限控制
- ⚡ **异步任务** - 多进程异步任务处理
- 🛠️ **开发工具** - 丰富的开发工具和内置函数
- 📱 **响应式** - 基于 LayUI 2.x，支持多设备
- 🌐 **多语言** - 支持多语言包管理
- 🔧 **易扩展** - 支持自定义插件开发

环境要求
----

[](#环境要求)

### 基础要求

[](#基础要求)

组件最低要求推荐版本说明**PHP**7.1+8.0+支持最新 PHP 特性**Composer**2.0+2.5+包管理工具**数据库**SQLite 3MySQL 8.0+支持多种数据库**Web 服务器**PHP 内置Nginx/Apache生产环境推荐**内存**128MB512MB+推荐更大内存**磁盘空间**100MB1GB+包含依赖和文件### 必需的 PHP 扩展

[](#必需的-php-扩展)

- `gd` - 图像处理
- `mbstring` - 多字节字符串处理
- `openssl` - 加密功能
- `pdo` - 数据库抽象层
- `curl` - HTTP 客户端
- `fileinfo` - 文件类型检测
- `json` - JSON 处理
- `zip` - 压缩文件处理

### 环境检测

[](#环境检测)

在安装前，请确保您的环境满足以下要求：

```
# 检查 PHP 版本
php -v

# 检查 Composer
composer -v

# 检查 PHP 扩展
php -m | grep -E "(gd|mbstring|openssl|pdo|curl|fileinfo|json|zip)"
```

快速开始
----

[](#快速开始)

### 快速安装体验

[](#快速安装体验)

```
# 创建项目（需要在英文目录下执行，默认只安装 admin 和 static 模块）
composer create-project zoujingli/thinkadmin

# 进入项目根目录
cd thinkadmin

# 数据库初始化并安装
# 默认使用 Sqlite 数据库，若使用其他数据库请修改配置后再执行
php think migrate:run

# 安装微信管理模块（可选模块）
composer require zoujingli/think-plugs-wechat

# 🚀 开启 PHP 内置 WEB 服务
# 默认后台登录账号及密码都是 admin
php think run --host 127.0.0.1
```

### 访问系统

[](#访问系统)

安装完成后，打开浏览器访问系统：

访问地址说明默认账号`http://127.0.0.1:8000`系统首页-`http://127.0.0.1:8000/admin`后台管理admin/admin`http://127.0.0.1:8000/api`API 接口-### 首次使用指南

[](#首次使用指南)

1. **登录后台管理**

    - 访问 `http://127.0.0.1:8000/admin`
    - 使用默认账号 `admin` / `admin` 登录
2. **修改默认密码**

    - 进入"系统管理" → "用户管理"
    - 修改管理员密码
3. **配置系统参数**

    - 进入"系统管理" → "系统参数配置"
    - 设置网站名称、Logo 等基本信息
4. **创建业务模块**

    - 使用代码生成器创建 CRUD 功能
    - 开发自定义插件实现业务逻辑

### 安装 ThinkLibrary

[](#安装-thinklibrary)

ThinkAdmin 基于 ThinkLibrary 核心工具库，如需单独安装：

```
# 安装 ThinkLibrary
composer require zoujingli/think-library

# 确保控制器继承自 think\admin\Controller
class MyController extends \think\admin\Controller {
    protected $dbQuery = '数据表名';
    // 使用 ThinkLibrary 提供的功能
}
```

核心功能
----

[](#核心功能)

### 🚀 自由扩展的组件生态

[](#-自由扩展的组件生态)

基于最新 ThinkPHP 框架开发，遵循 Composer 标准管理依赖组件，可自由安装各种开源组件及插件生态程序。系统将功能模块封装为独立的插件包，支持通过 Composer 进行安装和更新，让开发者可以根据项目需求选择性地安装所需的功能模块。

### 💾 标准化文件存储引擎

[](#-标准化文件存储引擎)

支持本地存储、自建 Alist 存储、多种云存储，基于文件 HASH 实现文件秒传，节省服务器空间。提供统一的文件存储引擎，支持多种存储方案，满足不同场景下的数据存储需求。

**支持的存储方案**:

- 本地服务器存储
- 自建 Alist 存储
- 七牛云空间存储
- 阿里云 OSS 存储
- 腾讯云 COS 存储
- 又拍云 USS 存储

### 🔐 注解 RBAC 权限管理

[](#-注解-rbac-权限管理)

通过控制器方法注释实现功能节点自动生成，配合后台权限管理实现最简注解权限控制。系统实现了基于注解的简化 RBAC 权限模型，支持精确到按钮级别的权限控制。

**权限系统特点**:

- **注解驱动** - 通过控制器注释自动生成权限节点，简化权限配置
- **精确控制** - 权限控制精确到按钮级别，提供最大灵活性
- **自动维护** - 功能节点由系统自动维护，根据控制器代码注释进行刷新
- **动态菜单** - 根据用户权限动态显示功能菜单，支持三级菜单结构
- **操作日志** - 完整记录用户操作行为，支持安全审计

### 🔧 可升级 Composer 插件微架构

[](#-可升级-composer-插件微架构)

深度定制 Composer 插件，实现专属插件生态管理架构，可将应用模块封装成独立插件包。系统强制要求使用插件架构，所有业务功能都必须通过自定义插件实现。

### ⚡ 独立进程异步执行任务

[](#-独立进程异步执行任务)

兼容多平台动态创建 PHP 进程，并列启动多个独立任务进程处理大数据或长时性任务，实时显示执行进度。支持多进程异步任务处理，显著提高任务处理效率。

**任务系统特性**:

- **多进程架构** - 支持多进程并发执行任务，提高处理效率
- **跨平台支持** - 兼容 Windows 和 Linux 系统
- **自动监控** - 每 0.5 秒扫描任务数据表，自动执行待处理任务
- **进程管理** - 支持 START、STOP、QUERY、LISTEN 等进程管理指令
- **进度跟踪** - 支持任务完成状态跟进和进度显示
- **异常恢复** - 支持自动重启和异常处理
- **守护进程** - 支持后台守护进程模式运行

### 🛠️ 常用操作及工具库封装

[](#️-常用操作及工具库封装)

核心组件封装各种常用 CRUD 操作及工具库，快速实现数据增删改查，后台 UI 基于最新 Layui 构建。基于 ThinkLibrary 核心工具库，提供完整的 CRUD 操作和一系列常用工具。

**核心功能模块**:

1. **数据列表展示组件** - 展示数据列表，支持分页、排序和高级搜索
2. **表单处理模块** - 用于创建、展示和提交表单数据，完善的表单验证和错误处理机制
3. **数据状态快速处理模块** - 根据业务需求快速更新数据状态，支持多字段同时更新
4. **数据安全删除模块** - 安全删除数据，支持软删除和硬删除
5. **文件存储通用组件** - 支持多种文件存储方式，统一接口和配置
6. **通用数据保存更新模块** - 基于 key 和条件判断数据存在性，进行更新或新增
7. **通用网络请求模块** - 支持 GET、POST 和 PUT 请求，统一接口
8. **系统参数配置模块** - 快速配置并保存系统参数
9. **UTF-8 加密算法支持** - 提供 UTF-8 字符串加密和解密功能
10. **接口 CORS 跨域支持** - 默认支持跨域请求，输出标准化 JSON 数据
11. **表单 CSRF 安全验证** - 自动为表单添加 CSRF 安全验证字段

核心功能详解
------

[](#核心功能详解)

### 插件生态架构

[](#插件生态架构)

基于 Composer 标准管理依赖组件，支持插件热插拔和在线升级。

```