From ca9c209415463bcf80a6625b8f7b4c73c4059792 Mon Sep 17 00:00:00 2001 From: Anyon Date: Sun, 12 Oct 2025 11:35:53 +0800 Subject: [PATCH] Update readme.md --- readme.md | 1291 ++++++++++++++++++++--------------------------------- 1 file changed, 490 insertions(+), 801 deletions(-) diff --git a/readme.md b/readme.md index 48d3eaa68..725e63207 100644 --- a/readme.md +++ b/readme.md @@ -1,41 +1,227 @@ -# 🚀 ThinkAdmin v6.1 - 现代化后台管理系统 - -[![star](https://gitcode.com/ThinkAdmin/ThinkAdmin/star/badge.svg)](https://gitcode.com/ThinkAdmin/ThinkAdmin) -[![star](https://gitee.com/zoujingli/ThinkAdmin/badge/star.svg?theme=gvp)](https://gitee.com/zoujingli/ThinkAdmin) +# ThinkAdmin [![Latest Stable Version](https://poser.pugx.org/zoujingli/thinkadmin/v/stable)](https://packagist.org/packages/zoujingli/thinkadmin) [![Total Downloads](https://poser.pugx.org/zoujingli/thinkadmin/downloads)](https://packagist.org/packages/zoujingli/thinkadmin) -[![Monthly Downloads](https://poser.pugx.org/zoujingli/thinkadmin/d/monthly)](https://packagist.org/packages/zoujingli/thinkadmin) -[![Daily Downloads](https://poser.pugx.org/zoujingli/thinkadmin/d/daily)](https://packagist.org/packages/zoujingli/thinkadmin) +[![Monthly Downloads](https://poser.pugx.org/zoujingli/thinkadmin/d/monthly)](https://poser.pugx.org/zoujingli/thinkadmin) +[![Daily Downloads](https://poser.pugx.org/zoujingli/thinkadmin/d/daily)](https://poser.pugx.org/zoujingli/thinkadmin) [![License](https://poser.pugx.org/zoujingli/thinkadmin/license)](https://packagist.org/packages/zoujingli/thinkadmin) +[![PHP Version](https://img.shields.io/badge/php-%3E%3D7.1-blue.svg)](https://www.php.net/) +[![ThinkPHP](https://img.shields.io/badge/ThinkPHP-6%20%7C%208-brightgreen.svg)](https://www.thinkphp.cn/) -## 📖 项目介绍 +基于 **ThinkPHP 6 & 8** 的现代化后台管理系统，采用 **PaaS 插件架构**，提供完整的后台管理解决方案。系统遵循 **MIT** 开源协议，专为快速开发而设计，深度定制 Composer 插件，实现专属 PaaS 插件生态管理架构，可将应用模块封装成独立插件包。 -**ThinkAdmin v6.1** 是一款基于 **ThinkPHP 6 & 8** 的现代化后台管理系统，遵循 **MIT** 开源协议，专为快速开发而设计。系统采用全新的 **PaaS 插件架构**，提供类似 **PaaS** 的组件升级更新服务，支持本地化定制开发。 +## 项目简介 -### ✨ **为什么选择 ThinkAdmin？** +**ThinkAdmin** 是一个功能强大的后台管理系统，基于最新的 **ThinkPHP 6 & 8** 框架开发，专为简化后台管理流程而设计。系统采用现代化的技术栈，提供丰富的功能模块和插件生态，帮助开发者快速构建企业级后台管理系统。 -> **🎯 快速开发** - 基于 ThinkPHP 6 & 8 框架，提供完整的后台管理功能，开箱即用 -> -> **🔌 插件生态** - 支持 Composer 插件管理，可扩展性强，支持热插拔 -> -> **⚡ 稳定可靠** - 经过多个项目实践验证，系统稳定，性能优异 -> -> **🛡️ 安全完善** - 内置 RBAC 权限管理、操作日志、数据加密等安全机制 -> -> **📚 文档齐全** - 提供完整的开发文档和使用指南，学习成本低 -> -> **🚀 现代化架构** - 支持多应用模式、异步任务、文件存储等现代特性 +### 核心优势 -### 🌟 系统核心特点 +- **🚀 快速开发** - 基于 ThinkPHP 6 & 8 框架，提供完整的后台管理功能，开箱即用 +- **🔌 插件生态** - 支持 Composer 插件管理，可扩展性强，支持热插拔 +- **⚡ 稳定可靠** - 经过多个项目实践验证，系统稳定，性能优异 +- **🛡️ 安全完善** - 内置 RBAC 权限管理、操作日志、数据加密等安全机制 +- **📚 文档齐全** - 提供完整的开发文档和使用指南，学习成本低 +- **🚀 现代化架构** - 支持多应用模式、异步任务、文件存储等现代特性 -#### 🚀 **插件生态架构** +### 适用场景 -ThinkAdmin v6.1 采用插件化的架构设计，基于 Composer 标准管理依赖组件。系统将功能模块封装为独立的插件包，支持通过 Composer 进行安装和更新。这种设计让开发者可以根据项目需求选择性地安装所需的功能模块，同时保持系统的可维护性和可扩展性。 +- **快速原型开发** - MVP 产品、概念验证、演示系统 +- **企业管理系统** - CRM、ERP、OA、财务系统 +- **SaaS 平台** - 多租户应用、订阅服务、API 管理 +- **学习研究** - 技术学习、框架研究、最佳实践 -插件系统支持版本管理，开发者可以独立升级各个插件，而不会影响其他模块的正常运行。系统提供了统一的插件接口规范，第三方开发者可以基于这些规范开发自定义插件，扩展系统功能。 +## 在线演示 + +- **演示地址**: [https://v6.thinkadmin.top](https://v6.thinkadmin.top) +- **默认账号**: admin +- **默认密码**: admin + +## 特性 + +- 🚀 **快速开发** - 基于 ThinkPHP 6 & 8，开箱即用 +- 🔌 **插件生态** - 支持 Composer 插件管理，热插拔 +- 💾 **文件存储** - 支持多种存储方案，文件秒传 +- 🔐 **权限管理** - 基于注解的 RBAC 权限控制 +- ⚡ **异步任务** - 多进程异步任务处理 +- 🛠️ **开发工具** - 丰富的开发工具和内置函数 +- 📱 **响应式** - 基于 LayUI 2.x，支持多设备 +- 🌐 **多语言** - 支持多语言包管理 +- 🔧 **易扩展** - 支持自定义插件开发 + +## 环境要求 + +### 基础要求 + +| 组件 | 最低要求 | 推荐版本 | 说明 | +|------|----------|----------|------| +| **PHP** | 7.1+ | 8.0+ | 支持最新 PHP 特性 | +| **Composer** | 2.0+ | 2.5+ | 包管理工具 | +| **数据库** | SQLite 3 | MySQL 8.0+ | 支持多种数据库 | +| **Web 服务器** | PHP 内置 | Nginx/Apache | 生产环境推荐 | +| **内存** | 128MB | 512MB+ | 推荐更大内存 | +| **磁盘空间** | 100MB | 1GB+ | 包含依赖和文件 | + +### 必需的 PHP 扩展 + +- `gd` - 图像处理 +- `mbstring` - 多字节字符串处理 +- `openssl` - 加密功能 +- `pdo` - 数据库抽象层 +- `curl` - HTTP 客户端 +- `fileinfo` - 文件类型检测 +- `json` - JSON 处理 +- `zip` - 压缩文件处理 + +### 环境检测 + +在安装前，请确保您的环境满足以下要求： + +```bash +# 检查 PHP 版本 +php -v + +# 检查 Composer +composer -v + +# 检查 PHP 扩展 +php -m | grep -E "(gd|mbstring|openssl|pdo|curl|fileinfo|json|zip)" +``` + +## 快速开始 + +### 快速安装体验 + +```bash +# 创建项目（需要在英文目录下执行，默认只安装 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 + +ThinkAdmin 基于 ThinkLibrary 核心工具库，如需单独安装： + +```bash +# 安装 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 权限模型，支持精确到按钮级别的权限控制。 + +**权限系统特点**: +- **注解驱动** - 通过控制器注释自动生成权限节点，简化权限配置 +- **精确控制** - 权限控制精确到按钮级别，提供最大灵活性 +- **自动维护** - 功能节点由系统自动维护，根据控制器代码注释进行刷新 +- **动态菜单** - 根据用户权限动态显示功能菜单，支持三级菜单结构 +- **操作日志** - 完整记录用户操作行为，支持安全审计 + +### 🔧 可升级 PaaS 插件微架构 + +深度定制 Composer 插件，实现专属 PaaS 插件生态管理架构，可将应用模块封装成独立插件包。系统强制要求使用插件架构，所有业务功能都必须通过自定义插件实现。 + +### ⚡ 独立进程异步执行任务 + +兼容多平台动态创建 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 标准管理依赖组件，支持插件热插拔和在线升级。 -**插件开发示例**： ```php getPathname()); @@ -127,15 +307,10 @@ class FileService } ``` -文件存储系统支持文件去重功能，基于文件 HASH 检测重复文件，避免重复存储。系统提供了文件上传、下载、删除等基础功能，同时支持文件类型验证和大小限制，确保文件上传的安全性。对于图片文件，系统支持基本的压缩和格式转换功能。 +### 异步任务系统 -#### ⚡ **异步任务系统** +支持多进程异步任务处理，实时显示执行进度。 -ThinkAdmin 内置了异步任务处理机制，支持后台执行耗时较长的任务，如邮件发送、数据同步、报表生成等。系统采用多进程架构，可以并发执行多个任务，提高处理效率。 - -**任务队列实现示例**： - -**方式一：命令方式** ```php $to, 'subject' => $subject, 'content' => $content]; - - return QueueService::register($name, 'app\admin\service\EmailQueue', 0, $data); - } - - // 注册数据同步任务 - public function syncData($table, $condition = []) - { - $name = "同步数据表 {$table}"; - $data = ['table' => $table, 'condition' => $condition]; - - return QueueService::register($name, 'app\admin\service\SyncQueue', 0, $data); - } } // 邮件队列处理类 @@ -197,67 +334,29 @@ class EmailQueue extends QueueService { public function execute(array $data = []) { - $this->progress(2, '开始发送邮件...', '10.00'); + $this->setQueueProgress('开始发送邮件...', 10.00); try { // 发送邮件逻辑 $result = $this->sendMail($data['to'], $data['subject'], $data['content']); if ($result) { - $this->progress(3, '邮件发送成功', '100.00'); - $this->success('邮件发送成功'); + $this->setQueueProgress('邮件发送成功', 100.00); + $this->setQueueSuccess('邮件发送成功'); } else { - $this->error('邮件发送失败'); + $this->setQueueError('邮件发送失败'); } } catch (\Exception $e) { - $this->error('邮件发送异常: ' . $e->getMessage()); + $this->setQueueError('邮件发送异常: ' . $e->getMessage()); } } - - private function sendMail($to, $subject, $content) - { - // 实际的邮件发送逻辑 - return true; - } -} - -// 数据同步队列处理类 -class SyncQueue extends QueueService -{ - public function execute(array $data = []) - { - $this->progress(2, '开始同步数据...', '10.00'); - - try { - // 数据同步逻辑 - $result = $this->syncTable($data['table'], $data['condition']); - - if ($result) { - $this->progress(3, '数据同步成功', '100.00'); - $this->success('数据同步成功'); - } else { - $this->error('数据同步失败'); - } - } catch (\Exception $e) { - $this->error('数据同步异常: ' . $e->getMessage()); - } - } - - private function syncTable($table, $condition) - { - // 实际的数据同步逻辑 - return true; - } } ``` -任务系统提供了基本的任务管理功能，包括任务创建、执行、状态查询等。系统支持任务队列机制，可以按顺序执行任务，避免系统资源过载。同时，系统提供了任务监控功能，可以查看任务的执行状态和进度。 +### 开发工具 -#### 🛠️ **开发工具** +基于 ThinkLibrary 核心工具库，提供完整的 CRUD 操作。 -ThinkAdmin 提供了基础的开发工具，帮助开发者提高开发效率。系统内置了代码生成功能，可以根据数据表结构生成基本的 CRUD 代码，包括控制器、模型、视图等文件。 - -**CRUD 操作示例**： ```php title = '添加商品'; $this->_form($this->dbQuery, 'form'); } + + public function save() + { + $this->_save($this->dbQuery, $this->_vali([ + 'status.require' => '状态不能为空', + 'status.in:0,1' => '状态值无效' + ])); + } } ``` -系统提供了表单处理助手，可以简化表单验证和数据处理的代码编写。同时，系统内置了日志记录功能，支持不同级别的日志输出，便于调试和问题排查。这些工具虽然基础，但能够满足大部分后台管理系统的开发需求。 +## 技术栈 -### 🎯 **广泛适用场景** +### 后端技术 -#### 🚀 **快速原型开发** - -ThinkAdmin 是快速搭建后台管理系统的理想选择。通过内置的代码生成器和丰富的预设模板，开发者可以在几分钟内创建完整的后台管理功能，包括用户管理、权限控制、数据管理等核心模块。这种快速开发能力特别适合： - -- **MVP 产品开发** - 快速验证商业想法 -- **内部工具开发** - 企业内部的效率工具 -- **原型验证** - 客户需求验证和演示 - -#### 🏢 **企业级应用** - -ThinkAdmin 为企业级应用提供了坚实的基础，特别适合中小型企业的后台管理系统开发。系统内置的 RBAC 权限模型、操作日志、数据加密等安全机制，能够满足企业级应用的基本安全要求： - -- **CRM 系统** - 客户关系管理 -- **ERP 系统** - 企业资源规划 -- **OA 系统** - 办公自动化 -- **内容管理** - CMS 内容管理系统 - -#### 🌐 **SaaS 平台开发** - -ThinkAdmin 的模块化设计和多应用模式，使其成为构建 SaaS 平台的理想基础框架。通过插件系统，开发者可以灵活地为不同租户提供定制化的功能模块： - -- **多租户支持** - 为不同客户提供独立的功能空间 -- **插件市场** - 构建可扩展的功能生态 -- **API 集成** - 与第三方服务无缝集成 -- **定制化开发** - 根据客户需求快速定制功能 - -#### 📚 **学习与教育** - -ThinkAdmin 作为开源项目，是学习现代 PHP 开发的优秀案例。系统采用标准的 ThinkPHP 框架开发，代码结构清晰，注释详细，非常适合： - -- **PHP 学习** - 学习现代 PHP 开发最佳实践 -- **框架学习** - 深入理解 ThinkPHP 框架 -- **系统架构** - 学习后台管理系统的设计思路 -- **插件开发** - 学习插件化架构设计 - -### 🔧 **现代化技术栈** - -#### **后端技术** - -ThinkAdmin 基于 **ThinkPHP 6 & 8** 框架开发，支持 **PHP 7.1+** 版本，充分利用现代 PHP 特性。框架提供了完整的 MVC 架构、RESTful API、中间件、依赖注入等现代开发特性： +ThinkAdmin 基于 **ThinkPHP 6 & 8** 框架开发，支持 **PHP 7.1+** 版本，充分利用现代 PHP 特性： - **框架版本**: ThinkPHP 6 & 8 (支持最新 PHP 8.x) +- **核心依赖**: ThinkLibrary v6.1+ (核心工具库) +- **插件生态**: ThinkPlugsAdmin v1.0+ (后台管理)、ThinkPlugsWechat v1.0+ (微信管理) - **数据库支持**: MySQL、PostgreSQL、SQLite、SQL Server -- **ORM 支持**: 内置 ThinkORM，支持模型关联、查询构建器 +- **ORM 支持**: ThinkORM 2.0+，支持模型关联、查询构建器 - **缓存系统**: Redis、Memcached、文件缓存 - **队列系统**: 支持异步任务处理 - **数据库迁移**: 使用 Phinx 进行版本控制 +- **多语言支持**: 支持全局、应用、动态三种语言包类型 +- **路由管理**: 支持全局路由和应用路由，模块化管理 +- **运行模式**: 支持开发模式和生产模式切换 +- **内置函数**: 提供 20+ 个内置函数，简化开发流程 -#### **前端技术** +### 前端技术 前端采用现代化的技术栈，提供良好的用户体验和开发体验： @@ -349,164 +423,94 @@ ThinkAdmin 基于 **ThinkPHP 6 & 8** 框架开发，支持 **PHP 7.1+** 版本 - **富文本编辑**: CKEditor (内容编辑) - **图标字体**: Font Awesome (图标系统) - **响应式设计**: 支持移动端和桌面端 +- **表格组件**: LayUI Table 组件，支持动态高度、搜索绑定 +- **表单组件**: 支持自动提交、数据验证 +- **弹层组件**: LayUI Layer 弹层组件 +- **工具函数**: 内置 jQuery 扩展和工具函数 -#### **第三方集成** +### 第三方集成 -系统提供了丰富的第三方服务集成，支持主流云服务和支付平台： +系统提供了丰富的第三方服务集成，支持主流云服务和平台： -- **云存储**: 七牛云、阿里云 OSS、腾讯云 COS、华为云 OBS -- **支付集成**: 微信支付、支付宝、银联支付 -- **消息推送**: 邮件发送、短信发送、微信通知 -- **地图服务**: 高德地图、百度地图、腾讯地图 -- **AI 服务**: 图像识别、语音识别、自然语言处理 +- **云存储**: 七牛云、阿里云 OSS、腾讯云 COS、又拍云 USS、自建 Alist 存储 +- **微信生态**: 公众号管理、小程序管理、微信支付、用户管理、素材管理 +- **支付集成**: 微信支付、支付宝等主流支付方式 +- **消息推送**: 邮件发送、短信发送等基础消息推送功能 -### 📊 **项目统计** +## 插件生态 -| 项目信息 | 详情 | -|---------|------| -| **开源协议** | MIT 开源协议 | -| **开发语言** | PHP 7.1+ | -| **框架版本** | ThinkPHP 6 & 8 | -| **代码仓库** | [Gitee](https://gitee.com/zoujingli/ThinkAdmin) \| [GitHub](https://github.com/zoujingli/think-plugs-admin) | -| **包管理器** | [Packagist](https://packagist.org/packages/zoujingli/thinkadmin) | -| **社区支持** | QQ 群、微信群、GitHub Issues | -| **文档状态** | 完整的中文文档和 API 文档 | -| **更新维护** | 定期更新、Bug 修复、新功能开发 | -| **测试覆盖** | 单元测试、集成测试 | -| **性能优化** | 缓存优化、数据库优化、前端优化 | +ThinkAdmin 采用 PaaS 插件架构，提供丰富的插件生态： -### ⚡ **性能特性** +### 核心插件 -| 特性 | 说明 | 优势 | -|------|------|------| -| **响应时间** | 页面加载 < 200ms | 快速响应用户操作 | -| **并发处理** | 支持 1000+ 并发用户 | 适合高并发场景 | -| **内存占用** | 基础内存 < 32MB | 资源消耗低 | -| **数据库优化** | 查询优化、索引优化 | 数据库性能优异 | -| **缓存策略** | 多级缓存、智能失效 | 减少数据库压力 | -| **文件存储** | 支持云存储、CDN 加速 | 文件访问速度快 | +- **ThinkLibrary v6.1+** - 核心工具库，提供完整的 CRUD 操作和一系列常用工具，特别注重多应用支持 +- **ThinkPlugsAdmin v1.0+** - 后台基础管理模块，提供用户、权限、菜单、系统配置等核心功能 +- **ThinkPlugsWechat v1.0+** - 微信平台管理，支持公众号、小程序、微信支付等完整功能 -### 🔄 **版本对比** +### 扩展插件 -| 特性 | ThinkAdmin v5 | ThinkAdmin v6.1 | 改进说明 | -|------|---------------|-----------------|----------| -| **PHP 版本** | PHP 7.0+ | PHP 7.1+ | 支持最新 PHP 特性 | -| **框架版本** | ThinkPHP 5.1 | ThinkPHP 6 & 8 | 现代化框架架构 | -| **插件系统** | 基础支持 | 完整 PaaS 架构 | 支持热插拔和在线升级 | -| **权限管理** | 基础 RBAC | 增强 RBAC + 注解 | 更灵活的权限控制 | -| **文件存储** | 本地存储 | 多云存储 + 去重 | 更强大的存储能力 | -| **任务队列** | 基础队列 | 多进程 + 监控 | 更可靠的任务处理 | -| **API 支持** | 基础 API | RESTful + 文档 | 更完善的 API 体系 | +- **ThinkPlugsAccount** - 账号管理插件 +- **ThinkPlugsPayment** - 支付管理插件 +- **ThinkPlugsWorker** - 高性能 Worker 运行插件 +- **ThinkPlugsStatic** - 静态资源管理插件 -#### 注意事项 +### 插件特点 -- **ThinkAdmin** 是基于国内最流行的 **ThinkPHP6** 框架开发，要求在不低于 **PHP 7.2.5** 的版本上运行，如果使用低版本的 **PHP** 可能会影响 **Composer** 依赖组件的安装，或将存在一定的安全隐患； -- 运行环境必需开启 **PATHINFO** 并将对应的 **rewrite** 规则配置到站点才能访问，系统已不再支持 **ThinkPHP** 的 **URL** 兼容模式运行 ( 源于如何优雅地展示 )，可以阅读 **ThinkAdmin** 的文档[安装部署](https://thinkadmin.top/guide/install.html)章节； -- 代码仓库下载的文件不包含 **Composer** 组件的 **vendor** 目录，下载后需要执行 **composer install** 安装依赖组件，同时会触发执行 **php think migrate:run** 安装数据库 **Phinx** 脚本，如需切换数据库只需要先配置再执行指令即可完成初始化安装数据； -- 为保持系统可持续在线升级，建议不要在 **app/admin**、**app/wechat** 、**public/static** 这三个目录创建或修改文件，可以自行创建其他模块再编写自己的业务代码，自定义样式及脚本可以放置在 **public/static/extra** 目录里面。 -- 系统是基于严格类型 **PHP** 新特性开发，务必使用专业的 **IDE** ( 如：**PhpStorm**、**NetBeans**、**VsCode**、**Eclipse for PHP** 等 ) 进行项目开发以达到更好的体验与更高的效率！ +- **热插拔** - 支持插件的动态安装和卸载 +- **统一管理** - 通过 Composer 进行插件依赖管理 +- **本地化开发** - 支持插件本地化定制开发 +- **版本控制** - 支持插件版本管理和更新 -## 🚀 快速开始 +### 插件开发 -### ⚙️ 环境要求 - -- **PHP 版本**: 7.1 或更高版本（推荐 PHP 8.0+） -- **Composer**: 必须安装 Composer 包管理工具 -- **数据库**: 支持 Sqlite、MySQL 和 SQL Server -- **Web 服务器**: Apache、Nginx 或 PHP 内置服务器 - -### 📦 一键安装 - -#### 方式一：Composer 安装（推荐） - -```bash -# 创建项目（需要在英文目录下执行） -composer create-project zoujingli/thinkadmin my-project - -# 进入项目目录 -cd my-project - -# 数据库初始化（默认使用 Sqlite） -php think migrate:run - -# 安装微信管理模块（可选） -composer require zoujingli/think-plugs-wechat - -# 启动内置服务器 -php think run --host 127.0.0.1 --port 8000 -``` - -#### 方式二：源码安装 - -```bash -# 下载项目（需要在英文目录下执行） -git clone https://gitee.com/zoujingli/ThinkAdmin -cd ThinkAdmin - -# 安装项目依赖组件 -composer install --optimize-autoloader - -# 数据库初始化（默认使用 Sqlite） -php think migrate:run - -# 启动内置服务器 -php think run --host 127.0.0.1 --port 8000 -``` - -### 🌐 访问系统 - -打开浏览器访问：`http://127.0.0.1:8000` - -- **后台管理**: `http://127.0.0.1:8000/admin` -- **默认账号**: `admin` -- **默认密码**: `admin` - -### 🔧 基础配置 - -1. **系统参数配置** - - - 登录后台 → 系统管理 → 系统参数配置 - - 设置网站名称、文件上传参数等 - -2. **用户管理** - - - 修改默认管理员密码 - - 创建新的管理员账号 - -3. **菜单管理** - - 查看系统菜单结构 - - 添加自定义菜单 - -## 🗄️ 数据库配置 - -### 支持的数据库 - -- **SQLite**（默认）- 无需额外配置，开箱即用 -- **MySQL** - 推荐用于生产环境 -- **PostgreSQL** - 支持企业级应用 -- **SQL Server** - 支持 Windows 环境 - -### 数据库配置 - -#### 使用 SQLite（默认，推荐开发环境） - -无需额外配置，系统默认使用 SQLite 数据库，开箱即用。 - -#### 使用 MySQL（推荐生产环境） - -1. **创建数据库** - -```sql -CREATE DATABASE thinkadmin DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; -``` - -2. **修改配置文件** `config/database.php` +系统强制要求使用插件架构，所有业务功能都必须通过自定义插件实现。开发者必须基于统一的插件接口规范开发自定义插件来实现具体的业务功能。 +**插件开发示例**: ```php +createTables(); + $this->createMenus(); + } + + public function uninstall() + { + // 卸载插件时的操作 + $this->dropTables(); + $this->removeMenus(); + } +} +``` + +## 数据库配置 + +### SQLite (默认) +```php +// config/database.php +return [ + 'default' => 'sqlite', + 'connections' => [ + 'sqlite' => [ + 'type' => 'sqlite', + 'database' => 'database/sqlite.db', + ], + ] +]; +``` + +### MySQL +```php +// config/database.php return [ - // 数据库类型 - 修改为 mysql 'default' => 'mysql', - // 数据库连接参数 'connections' => [ 'mysql' => [ 'type' => 'mysql', @@ -517,206 +521,70 @@ return [ 'hostport' => '3306', 'charset' => 'utf8mb4', ], - 'sqlite' => [ - 'type' => 'sqlite', - 'database' => 'database/sqlite.db', - ], ] ]; ``` -3. **执行数据库迁移** +## 系统命令 ```bash -# 自动创建数据表和初始数据 +# 启动开发服务器 +php think run --host 127.0.0.1 --port 8000 + +# 数据库迁移 php think migrate:run + +# 清除缓存 +php think clear + +# 异步任务管理 +php think xadmin:queue start # 启动守护进程 +php think xadmin:queue stop # 停止进程 +php think xadmin:queue query # 查询任务 +php think xadmin:queue listen # 监听进程 ``` -#### 使用 PostgreSQL - -1. **创建数据库** - -```sql -CREATE DATABASE thinkadmin; -``` - -2. **修改配置文件** `config/database.php` - -```php -return [ - // 数据库类型 - 修改为 pgsql - 'default' => 'pgsql', - 'connections' => [ - 'pgsql' => [ - 'type' => 'pgsql', - 'hostname' => '127.0.0.1', - 'database' => 'thinkadmin', - 'username' => 'postgres', - 'password' => 'your_password', - 'hostport' => '5432', - 'charset' => 'utf8', - ], - ] -]; -``` - -### 💡 重要提示 - -- **ThinkAdmin v6.1** 使用 Phinx 数据库迁移工具 -- 无需手动导入 SQL 脚本 -- 支持数据库版本管理和回滚 -- 自动创建系统必需的数据表 - -### 🔄 数据库切换步骤 - -1. **修改默认数据库类型** - - - 将 `'default' => 'sqlite'` 改为 `'default' => 'mysql'`（或其他数据库类型） - -2. **配置数据库连接参数** - - - 填写正确的数据库连接信息（主机、用户名、密码等） - -3. **执行数据库迁移** - - - 运行 `php think migrate:run` 创建数据表 - -4. **验证配置** - - 访问系统确认数据库连接正常 - -## 🎯 **核心功能亮点** - -### 🔐 **智能权限管理系统** - -#### **零配置权限控制** -- **注解驱动** - 通过方法注释自动生成功能节点，告别手动配置权限 -- **智能识别** - 自动识别控制器方法，生成对应的权限节点 -- **批量管理** - 支持批量设置权限，大幅提升管理效率 - -#### **完整 RBAC 权限模型** -- **角色继承** - 支持角色层级继承，简化权限管理复杂度 -- **细粒度控制** - 支持按钮级、字段级权限控制 -- **动态权限** - 根据用户角色动态调整界面和功能 - -#### **安全审计机制** -- **操作日志** - 记录所有用户操作，支持安全审计 -- **登录监控** - 实时监控登录状态和异常行为 -- **数据变更** - 记录敏感数据的变更历史 - -### 📁 **企业级文件存储引擎** - -#### **多存储策略** -- **本地存储** - 适合开发环境和小型项目 -- **云存储集成** - 七牛云、阿里云、腾讯云、AWS S3 等 -- **混合存储** - 支持本地+云存储混合模式 - -#### **智能文件管理** -- **文件秒传** - 基于 HASH 的重复文件检测，节省 90% 存储空间 -- **自动压缩** - 图片自动压缩优化，减少存储成本 -- **版本控制** - 支持文件版本管理和历史回滚 - -#### **安全防护机制** -- **类型验证** - 严格的文件类型和大小限制 -- **病毒扫描** - 集成病毒扫描，确保文件安全 -- **访问控制** - 支持文件访问权限和防盗链 - -### 🔌 **革命性插件生态** - -#### **PaaS 级插件管理** -- **热插拔** - 支持插件动态安装和卸载，无需重启服务 -- **在线升级** - 插件支持在线升级，保持系统最新 -- **版本管理** - 完整的插件版本管理和回滚机制 - -#### **开发者友好** -- **标准规范** - 遵循 Composer 和 PSR 标准 -- **文档完善** - 每个插件都有完整的开发文档 -- **社区支持** - 活跃的插件开发社区 - -### ⚡ **高性能异步任务系统** - -#### **多进程架构** -- **并发处理** - 支持多进程并发执行，充分利用服务器资源 -- **负载均衡** - 智能任务分配，避免单点过载 -- **故障恢复** - 进程异常自动重启，确保任务不丢失 - -#### **实时监控** -- **进度跟踪** - 实时显示任务执行进度 -- **状态管理** - 支持任务暂停、恢复、取消操作 -- **性能统计** - 详细的性能统计和优化建议 - -### 🛠️ **开发者工具链** - -#### **代码生成器** -- **CRUD 生成** - 一键生成完整的增删改查代码 -- **API 生成** - 自动生成 RESTful API 接口 -- **文档生成** - 基于注释自动生成 API 文档 - -#### **调试工具** -- **日志系统** - 分级日志记录，支持日志查询和分析 -- **性能监控** - 实时监控系统性能和资源使用 -- **错误追踪** - 详细的错误堆栈和调试信息 - -## 📚 开发指南 - -### 快速创建模块 +## 开发指南 +### 创建控制器 ```php title = '用户管理'; - // 使用 QueryHelper 进行数据查询和分页 - $this->_query('SystemUser') - ->like('username,nickname,phone') - ->equal('status') - ->dateBetween('create_at') - ->order('id desc') - ->page(); - } - - /** - * 添加用户 - * @auth true - * @menu true - */ - public function add() - { - $this->title = '添加用户'; - $this->_form('SystemUser', 'form'); + $this->title = '我的页面'; + $this->fetch(); } } ``` -### 权限注解说明 - +### 权限控制 ```php /** - * 操作名称 + * 需要权限验证的方法 * @auth true # 需要权限验证 - * @menu true # 显示在菜单中 - * @login true # 需要强制登录 + * @menu true # 添加到菜单 + * @login true # 需要登录 */ -public function index() +public function myMethod() { - // 控制器代码 + // 方法内容 } ``` -### 数据库操作 - +### 数据操作 ```php -// 使用 QueryHelper 进行数据查询 +// 查询数据 $this->_query('user') ->like('username,email') ->equal('status') @@ -724,388 +592,209 @@ $this->_query('user') ->order('id desc') ->page(); -// 使用 FormHelper 处理表单 +// 表单处理 $this->_form('user', 'form'); -// 使用 SaveHelper 更新状态 +// 状态更新 $this->_save('user', $this->_vali([ 'status.require' => '状态不能为空', 'status.in:0,1' => '状态值无效' ])); ``` -## 🚀 性能优化 +## 常见问题 -### 缓存配置 +### 安装部署 -```php -// config/cache.php -'default' => 'redis', -'stores' => [ - 'redis' => [ - 'type' => 'redis', - 'host' => '127.0.0.1', - 'port' => 6379, - 'password' => '', - 'select' => 0, - 'timeout' => 0, - 'expire' => 0, - 'persistent' => false, - 'prefix' => '', - ], -], -``` +**Q: 安装时提示 Composer 错误怎么办？** -### 数据库优化 +A: 请检查以下几点： +1. **PHP 版本**: 确保 PHP 版本 ≥ 7.1 +2. **Composer 版本**: 执行 `composer self-update` 更新到最新版本 +3. **网络问题**: 如果网络不稳定，可以配置国内镜像 -```sql --- 为常用查询字段添加索引 -CREATE INDEX idx_user_status ON user(status); -CREATE INDEX idx_user_create_time ON user(create_time); -CREATE INDEX idx_user_status_time ON user(status, create_time); -``` +**Q: 数据库初始化失败怎么办？** -## 🛠️ 系统指令 +A: 请检查： +1. **数据库配置**: 检查 `config/database.php` 配置是否正确 +2. **数据库权限**: 确保数据库用户有创建表的权限 +3. **数据库连接**: 测试数据库连接是否正常 -### 基础指令 +**Q: 无法访问后台管理页面？** +A: 可能的原因： +1. **URL 路径**: 确保访问的是 `/admin` 或 `/admin.html` +2. **Web 服务器配置**: 检查伪静态规则是否正确配置 +3. **PHP 扩展**: 确保安装了必要的 PHP 扩展 + +### 功能使用 + +**Q: 如何修改后台登录入口？** + +A: 在后台 **系统管理** → **系统参数配置** 中修改： +1. 找到"后台入口地址"配置项 +2. 设置新的入口地址（如：`/myadmin`） +3. 保存配置，原入口将自动失效 + +**Q: 文件上传失败怎么办？** + +A: 检查以下配置： +1. **上传目录权限**: 确保 `public/upload` 目录可写 +2. **PHP 配置**: 检查 `upload_max_filesize` 和 `post_max_size` +3. **系统参数**: 在后台配置正确的文件上传参数 + +**Q: 如何添加自定义菜单？** + +A: 在后台 **系统管理** → **菜单管理** 中： +1. 点击"添加菜单" +2. 填写菜单名称和链接地址 +3. 选择父级菜单 +4. 设置菜单图标和排序 + +### 开发相关 + +**Q: 如何创建新的控制器？** + +A: 在 `app/admin/controller/` 目录下创建控制器文件，继承 `think\admin\Controller`。 + +**Q: 如何添加权限控制？** + +A: 在控制器方法上添加注释：`@auth true`、`@menu true`、`@login true`。 + +**Q: 如何自定义主题样式？** + +A: 可以通过以下方式自定义： +1. **CSS 文件**: 在 `public/static/css/` 目录下添加自定义样式 +2. **系统参数**: 在后台配置主题相关参数 +3. **模板文件**: 修改 `app/admin/view/` 下的模板文件 + +### 插件相关 + +**Q: 如何安装插件？** + +A: 使用 Composer 安装： ```bash -# 启动开发服务器 -php think run --host 127.0.0.1 --port 8000 - -# 数据库迁移 -php think migrate:run - -# 重写系统菜单 -php think xadmin:sysmenu - -# 同步微信粉丝数据 -php think xadmin:fansall -``` - -### 任务管理指令 - -```bash -# 启动异步任务监听 -php think xadmin:queue listen - -# 检查任务监听状态 -php think xadmin:queue status - -# 停止所有任务进程 -php think xadmin:queue stop -``` - -## 📞 技术支持 - -### 官方资源 - -- **官方网站**: https://thinkadmin.top -- **在线演示**: https://v6.thinkadmin.top（账号密码：admin） -- **开发文档**: https://thinkadmin.top/guide/ -- **GitHub**: https://github.com/zoujingli/ThinkAdmin -- **Gitee**: https://gitee.com/zoujingli/ThinkAdmin - -### 社区交流 - -- **QQ 群 1**: 513350915 -- **QQ 群 2**: 866345568 -- **微信群**: 扫描下方二维码 - -微信群二维码 - -### 学习资源 - -- **ThinkPHP 官方文档**: https://www.kancloud.cn/manual/thinkphp6_0 -- **LayUI 官方文档**: https://www.layui.com/doc/ -- **Composer 文档**: https://getcomposer.org/doc/ - -## 🔌 插件生态 - -### 核心插件 - -- **think-plugs-admin** - 后台管理核心插件 -- **think-plugs-wechat** - 微信管理插件 -- **think-plugs-static** - 静态资源管理插件 -- **think-plugs-account** - 账号管理插件 -- **think-plugs-payment** - 支付管理插件 - -### 安装插件 - -```bash -# 安装微信管理模块 +# 安装免费插件 composer require zoujingli/think-plugs-wechat -# 安装账号管理模块 +# 安装付费插件（需要授权） composer require zoujingli/think-plugs-account - -# 安装支付管理模块 -composer require zoujingli/think-plugs-payment ``` -### 插件开发 +**Q: 插件安装后没有显示怎么办？** -```php -// 插件服务注册 -class Service extends \think\Service -{ - public function register() - { - // 注册服务 - } +A: 检查以下几点： +1. **插件状态**: 在后台插件管理中查看插件状态 +2. **权限配置**: 确保当前用户有访问插件的权限 +3. **缓存清理**: 清除系统缓存后重新访问 - public function boot() - { - // 启动服务 - } -} -``` - -## 📦 代码仓库 - -### 主要仓库 - -- **GitHub**: https://github.com/zoujingli/ThinkAdmin（主要开发仓库） -- **Gitee**: https://gitee.com/zoujingli/ThinkAdmin（国内镜像仓库） -- **Gitcode**: https://gitcode.com/ThinkAdmin/ThinkAdmin - -### 贡献代码 - -- **提交 PR**: 请在 [ThinkAdminDeveloper](https://github.com/zoujingli/ThinkAdminDeveloper) 仓库提交 -- **问题反馈**: 使用 GitHub Issues 反馈问题 -- **代码规范**: 遵循 PSR-4 自动加载规范 - -### 在线体验 - -- **演示地址**: https://v6.thinkadmin.top -- **账号密码**: admin / admin -- **功能演示**: 完整的后台管理功能演示 - -## 🛠️ 系统指令详解 - -### 基础管理指令 +**Q: 如何卸载插件？** +A: 使用 Composer 卸载： ```bash -# 启动开发服务器 -php think run --host 127.0.0.1 --port 8000 - -# 数据库迁移 -php think migrate:run - -# 重写系统菜单 -php think xadmin:sysmenu - -# 同步微信粉丝数据 -php think xadmin:fansall - -# 数据库打包为 Phinx 脚本 -php think xadmin:package - -# 批量替换数据库字段内容 -php think xadmin:replace - -# 数据库优化和修复 -php think xadmin:database - -# 安装模块或插件 -php think xadmin:publish --migrate +composer remove zoujingli/plugin-name ``` -### 任务管理指令 - -#### 任务进程管理 - -```bash -# 启动异步任务监听服务 -php think xadmin:queue listen - -# 检查创建任务监听服务（建议定时任务执行） -php think xadmin:queue start - -# 查询当前任务相关的进程 -php think xadmin:queue query - -# 查看异步任务监听状态 -php think xadmin:queue status - -# 平滑停止所有任务进程 -php think xadmin:queue stop -``` - -#### 本地调试管理 - -```bash -# 停止本地调试服务 -php think xadmin:queue webstop - -# 开启本地调试服务（建议定时任务执行） -php think xadmin:queue webstart - -# 查看本地调试状态 -php think xadmin:queue webstatus -``` - -### 定时任务配置 - -#### Linux Crontab - -```bash -# 编辑定时任务 -crontab -e - -# 添加以下任务（每分钟检查一次） -* * * * * cd /path/to/thinkadmin && php think xadmin:queue start -* * * * * cd /path/to/thinkadmin && php think xadmin:queue webstart -``` - -#### Windows 任务计划程序 - -1. 打开任务计划程序 -2. 创建基本任务 -3. 设置触发器为每分钟 -4. 操作设置为运行程序：`php think xadmin:queue start` - -## 🔧 问题修复 - -### 安全修复 - -- **CORS 跨域配置** - 增加跨域规则配置，配置参数位于 `config/app.php` -- **XSS 防护** - 修复模板输出自动转义机制，防止 XSS 攻击 -- **文件上传安全** - 增强文件后缀验证，阻止非法文件上传 -- **CSRF 防护** - 自动为表单添加 CSRF 安全验证字段 -- **SQL 注入防护** - 使用参数化查询防止 SQL 注入 - -### 功能优化 - -- **模板引擎优化** - 修复模板取值问题，使用 `{$get.NAME|default=''}` 替代 `{:input(NAME)}` -- **编辑器安全** - 禁用 CKEditor 中所有标签的 `on` 事件，阻止脚本注入 -- **接口异常处理** - 优化 JsonRpc 接口异常处理机制 -- **主题配置** - 支持全局默认+用户个性配置 -- **地图数据更新** - 行政区域数据更新为百度地图最新数据 +**注意**: 卸载插件不会自动删除相关数据表，需要手动清理。 ### 性能优化 -- **缓存机制** - 优化缓存策略，提升系统性能 -- **数据库优化** - 优化数据库查询和索引 -- **静态资源** - 优化静态资源加载和压缩 -- **异步任务** - 优化异步任务处理机制 +**Q: 系统运行缓慢怎么办？** -## 📄 版权信息 +A: 可以尝试以下优化： +1. **开启缓存**: 在后台切换到生产模式 +2. **数据库优化**: 为常用查询字段添加索引 +3. **文件存储**: 使用云存储提升文件访问速度 +4. **服务器配置**: 优化 PHP 和 Web 服务器配置 -### 开源协议 +**Q: 如何开启生产模式？** -**ThinkAdmin** 遵循 [**MIT**](license) 开源协议发布，免费提供使用。 +A: 在后台 **系统管理** → **系统参数配置** 中： +1. 找到"运行模式"配置项 +2. 选择"生产模式" +3. 保存配置并清理缓存 -### 版权声明 +### 错误排查 -- **版权所有**: Copyright © 2014-2025 by ThinkAdmin -- **官方网站**: https://thinkadmin.top -- **开源协议**: MIT License -- **第三方代码**: 项目中包含的第三方源码和二进制文件的版权信息另行标注 +**Q: 页面显示 500 错误？** -### 免责声明 +A: 检查以下内容： +1. **错误日志**: 查看 `runtime/log/` 目录下的错误日志 +2. **PHP 错误**: 检查 PHP 错误日志 +3. **权限问题**: 确保目录权限正确 +4. **配置问题**: 检查配置文件是否正确 -在使用 **ThinkAdmin** 前请认真阅读[《免责声明》](https://thinkadmin.top/disclaimer)并同意该声明。 +**Q: 数据库连接失败？** -更多细节请参阅 [`LICENSE`](license) 文件。 +A: 检查数据库配置： +1. **连接参数**: 检查 `config/database.php` 中的连接参数 +2. **数据库服务**: 确保数据库服务正在运行 +3. **网络连接**: 检查网络连接是否正常 +4. **用户权限**: 确保数据库用户有相应权限 -## 📚 历史版本 +## 贡献 -> 以下系统的体验账号及密码都是 `admin` +我们欢迎所有形式的贡献，包括但不限于： -### 🚀 ThinkAdmin v6.1（当前版本） +### 如何贡献 -- **技术栈**: ThinkPHP 6 & 8 + PaaS 插件架构 -- **特色功能**: 插件生态、注解权限、异步任务 -- **在线体验**: https://v6.thinkadmin.top ✅ -- **GitHub**: https://github.com/zoujingli/ThinkAdmin/tree/v6.1 -- **Gitee**: https://gitee.com/zoujingli/ThinkAdmin/tree/v6.1 +1. **报告问题** + - 在 [GitHub Issues](https://github.com/zoujingli/ThinkAdmin/issues) 或 [Gitee Issues](https://gitee.com/zoujingli/ThinkAdmin/issues) 报告 Bug + - 提供详细的问题描述和复现步骤 + - 包含系统环境信息 -### 📦 ThinkAdmin v6.0 +2. **提交代码** + - Fork 项目到您的 GitHub 账户 + - 创建功能分支：`git checkout -b feature/AmazingFeature` + - 提交更改：`git commit -m 'Add some AmazingFeature'` + - 推送分支：`git push origin feature/AmazingFeature` + - 创建 Pull Request -- **技术栈**: ThinkPHP 6.0 + 注解权限 -- **特色功能**: 注解权限、多应用支持 -- **在线体验**: https://v6.thinkadmin.top ✅ -- **GitHub**: https://github.com/zoujingli/ThinkAdmin/tree/v6 -- **Gitee**: https://gitee.com/zoujingli/ThinkAdmin/tree/v6 +3. **改进文档** + - 完善 README 文档 + - 添加使用示例 + - 翻译文档到其他语言 -### 📱 ThinkAdmin v5 +4. **分享经验** + - 分享使用心得 + - 编写教程文章 + - 参与社区讨论 -- **技术栈**: ThinkPHP 5.1 + 注解权限 -- **特色功能**: 注解权限、LayUI 界面 -- **在线体验**: https://v5.thinkadmin.top ❌（已停用） -- **GitHub**: https://github.com/zoujingli/ThinkAdmin/tree/v5 -- **Gitee**: https://gitee.com/zoujingli/ThinkAdmin/tree/v5 +### 开发计划 -### 🔧 ThinkAdmin v4 +- [ ] 支持更多数据库类型 +- [ ] 优化前端界面 +- [ ] 增加更多插件 +- [ ] 完善 API 文档 +- [ ] 支持 Docker 部署 -- **技术栈**: ThinkPHP 5.1 -- **状态**: 不建议继续使用 -- **在线体验**: https://v4.thinkadmin.top ❌（已停用） -- **GitHub**: https://github.com/zoujingli/ThinkAdmin/tree/v4 -- **Gitee**: https://gitee.com/zoujingli/ThinkAdmin/tree/v4 +### 社区支持 -## 🤝 **社区与支持** +- **GitHub**: [https://github.com/zoujingli/ThinkAdmin](https://github.com/zoujingli/ThinkAdmin) +- **Gitee**: [https://gitee.com/zoujingli/ThinkAdmin](https://gitee.com/zoujingli/ThinkAdmin) +- **官方网站**: [https://thinkadmin.top](https://thinkadmin.top) +- **在线演示**: [https://v6.thinkadmin.top](https://v6.thinkadmin.top) +- **技术交流群**: 请访问官网获取群号 -### 📞 **获取帮助** +### 赞助支持 -- **📖 官方文档**: [https://thinkadmin.top](https://thinkadmin.top) -- **🐛 问题反馈**: [GitHub Issues](https://github.com/zoujingli/think-plugs-admin/issues) -- **💬 技术交流**: QQ 群、微信群（详见官网） -- **📧 商务合作**: 通过官网联系 +如果这个项目对您有帮助，欢迎通过以下方式支持我们： -### 🌟 **贡献指南** +- ⭐ Star 项目 +- 🍴 Fork 项目 +- 📢 分享给更多人 +- 💰 赞助开发（请访问官网了解详情） -我们欢迎各种形式的贡献，包括但不限于： +## 许可证 -- **🐛 Bug 报告** - 发现问题请及时反馈 -- **✨ 功能建议** - 提出新功能想法 -- **📝 文档完善** - 改进文档内容 -- **🔧 代码贡献** - 提交 Pull Request -- **📢 推广宣传** - 分享给更多开发者 +本项目基于 [MIT](https://mit-license.org) 许可证开源。 -### 📋 **开发计划** +## 版权 -- **v6.2** - 性能优化、新插件支持 -- **v6.3** - 移动端适配、PWA 支持 -- **v7.0** - 微服务架构、容器化部署 +版权所有 Copyright © 2018-2025 by ThinkAdmin (https://thinkadmin.top) All rights reserved. -### 📋 ThinkAdmin v3 - -- **技术栈**: ThinkPHP 5.1 -- **状态**: 不建议继续使用 -- **在线体验**: https://v3.thinkadmin.top ❌（已停用） -- **GitHub**: https://github.com/zoujingli/ThinkAdmin/tree/v3 -- **Gitee**: https://gitee.com/zoujingli/ThinkAdmin/tree/v3 - -### 📊 ThinkAdmin v2 - -- **技术栈**: ThinkPHP 5.0 -- **状态**: 不建议继续使用 -- **在线体验**: https://v2.thinkadmin.top ❌（已停用） -- **GitHub**: https://github.com/zoujingli/ThinkAdmin/tree/v2 -- **Gitee**: https://gitee.com/zoujingli/ThinkAdmin/tree/v2 - -### 🎯 ThinkAdmin v1 - -- **技术栈**: ThinkPHP 5.0 -- **状态**: 不建议继续使用 -- **在线体验**: https://v1.thinkadmin.top ❌（已停用） -- **GitHub**: https://github.com/zoujingli/ThinkAdmin/tree/v1 -- **Gitee**: https://gitee.com/zoujingli/ThinkAdmin/tree/v1 - -## 🎉 结语 - -**ThinkAdmin v6.1** 是一个功能强大、易于使用的现代化后台管理系统。无论您是初学者还是经验丰富的开发者，都能快速上手并构建出高质量的后台管理应用。 - -### 开始您的开发之旅 - -1. **快速体验** - 访问在线演示了解系统功能 -2. **本地安装** - 按照安装指南搭建本地环境 -3. **学习开发** - 阅读开发文档和最佳实践 -4. **参与社区** - 加入官方群组交流学习 -5. **贡献代码** - 为项目贡献您的代码和想法 +**备案信息**: [粤ICP备16006642号](https://beian.miit.gov.cn) --- -**感谢您选择 ThinkAdmin！** 🎊 +**提示**: 遇到问题时，建议先查看错误日志，大多数问题都能通过日志找到原因。 \ No newline at end of file