This commit is contained in:
2026-02-09 09:29:21 +08:00
parent 616314eef2
commit 9939680942
6 changed files with 199 additions and 82 deletions

1
.gitignore vendored
View File

@@ -23,3 +23,4 @@ Homestead.json
Homestead.yaml
Thumbs.db
*lock*
/storage/*laravels*

191
README.md
View File

@@ -1,6 +1,6 @@
<div align="center">
# Laravel Swoole 管理系统
# LarAdmin
基于 Laravel + Swoole + Vue3 的高性能后台管理系统
@@ -14,7 +14,7 @@
## 📖 项目简介
本项目是一个基于 Laravel 12 + Swoole + Vue3 的高性能后台管理系统,采用模块化架构设计,提供完整的认证授权、系统管理、业务扩展等功能。项目集成了 `hhxsv5/laravel-s` 实现 Swoole 长生命周期服务,大幅提升系统并发性能和响应速度。
LarAdmin 是一个基于 Laravel 12 + Swoole + Vue3 的高性能后台管理系统,采用模块化架构设计,提供完整的认证授权、系统管理、业务扩展等功能。项目集成了 `hhxsv5/laravel-s` 实现 Swoole 长生命周期服务,大幅提升系统并发性能和响应速度。
### ✨ 核心特性
@@ -49,11 +49,13 @@
- **Pinia**: 3.0+ (状态管理)
- **Axios**: HTTP 客户端
- **Vue I18n**: 国际化支持
- **CKEditor 5**: 富文本编辑器
- **ECharts**: 数据可视化
## 📁 项目结构
```
laravel_swoole/
laradmin/
├── app/ # 基础模块目录
│ ├── Http/Controllers/ # 控制器
│ │ ├── Auth/ # 认证模块控制器
@@ -71,7 +73,8 @@ laravel_swoole/
│ │ │ ├── Task.php
│ │ │ ├── City.php
│ │ │ └── Upload.php
│ │ ── Api/
│ │ ── Api/
│ │ └── WebSocket.php
│ ├── Models/ # 模型
│ │ ├── Auth/
│ │ │ ├── User.php
@@ -81,9 +84,11 @@ laravel_swoole/
│ │ └── System/
│ ├── Services/ # 服务层
│ │ ├── Auth/
│ │ ── System/
│ └── Exports/ # 导出类
── Imports/ # 导
│ │ ── System/
│ └── WebSocket/
── Exports/ # 导
│ ├── Imports/ # 导入类
│ └── Middleware/ # 中间件
├── Modules/ # 业务模块目录
│ └── ModuleName/ # 业务模块示例
│ ├── App/
@@ -105,11 +110,18 @@ laravel_swoole/
│ │ ├── src/
│ │ │ ├── api/ # API 接口
│ │ │ ├── components/ # 公共组件
│ │ │ │ ├── scForm/ # 表单组件
│ │ │ │ ├── scTable/ # 表格组件
│ │ │ │ ├── scUpload/ # 上传组件
│ │ │ │ ├── scEditor/ # 富文本编辑器
│ │ │ │ ├── scImport/ # 导入组件
│ │ │ │ └── scExport/ # 导出组件
│ │ │ ├── layouts/ # 布局组件
│ │ │ ├── pages/ # 页面组件
│ │ │ ├── router/ # 路由配置
│ │ │ ├── stores/ # 状态管理
│ │ │ ├── utils/ # 工具函数
│ │ │ ├── hooks/ # 组合式 API
│ │ │ └── i18n/ # 国际化
│ │ └── package.json
│ └── views/
@@ -148,25 +160,31 @@ laravel_swoole/
#### 1. 克隆项目
```bash
git clone http://git.tensent.cn/molong/laravel_swoole.git
cd laravel_swoole
git clone http://git.tensent.cn/molong/laravel_swoole.git laradmin
cd laradmin
```
#### 2. 安装依赖
#### 2. 自动安装(推荐)
```bash
# 一键安装所有依赖并初始化
composer run setup
```
此命令会自动执行:
- 安装后端依赖
- 配置环境文件
- 生成应用密钥
- 执行数据库迁移
- 安装前端依赖
- 构建前端资源
#### 3. 手动安装
```bash
# 安装后端依赖
composer install
# 安装前端依赖
cd resources/admin
npm install
cd ../..
```
#### 3. 环境配置
```bash
# 复制环境配置文件
cp .env.example .env
@@ -175,31 +193,22 @@ php artisan key:generate
# 配置数据库、Redis等参数
# 编辑 .env 文件
```
#### 4. 执行数据库迁移
```bash
# 执行迁移
# 执行数据库迁移
php artisan migrate
# 填充初始数据
php artisan db:seed
```
#### 5. 配置 JWT
```bash
# 生成 JWT 密钥
php artisan jwt:secret
```
#### 6. 构建前端
```bash
# 安装前端依赖
cd resources/admin
npm install
# 构建前端
npm run build
cd ../..
```
### 运行项目
@@ -207,15 +216,31 @@ cd ../..
#### 开发模式
```bash
# 启动 Laravel 开发服务
php artisan serve
# 启动前端开发服务器(另开终端)
cd resources/admin
npm run dev
# 一键启动所有服务
composer run dev
```
#### Swoole 模式(推荐)
此命令会启动:
- Laravel 开发服务器 (http://localhost:8000)
- 队列监听器
- 日志监控
- Vite 前端开发服务器
#### 分步启动
```bash
# 终端1: 启动 Laravel 开发服务器
php artisan serve
# 终端2: 启动前端开发服务器
cd resources/admin
npm run dev
# 终端3: 启动队列监听器(可选)
php artisan queue:listen
```
#### Swoole 模式(推荐生产环境)
```bash
# 启动 Laravel-S 服务
@@ -229,6 +254,9 @@ php bin/laravels restart
# 重载服务(平滑重启)
php bin/laravels reload
# 查看状态
php bin/laravels status
```
访问地址http://localhost:5200 (默认)
@@ -530,6 +558,74 @@ npm run format
bin/inotify # Linux
```
## 🌟 特色功能
### 1. 动态菜单路由
前端支持动态路由加载,登录后自动根据权限生成菜单树:
```javascript
// 登录后获取菜单
const menus = await authApi.permissions.menu.get()
userStore.setMenu(menus)
```
### 2. 权限指令
前端提供权限指令,方便控制元素显示:
```vue
<!-- 只有拥有 user.create 权限时显示 -->
<a-button v-permission="'user.create'">新增</a-button>
<!-- 拥有多个权限之一时显示 -->
<a-button v-permission="['user.create', 'user.update']">编辑</a-button>
```
### 3. 数据导入导出
支持 Excel 数据导入导出:
```javascript
// 导出用户数据
await userApi.export.post(params)
// 导入用户数据
await userApi.import.post(formData)
```
### 4. 富文本编辑器
集成 CKEditor 5 富文本编辑器:
```vue
<sc-editor
v-model="content"
:height="400"
/>
```
### 5. 文件上传
支持多种上传方式:
```vue
<!-- 图片上传 -->
<sc-upload
v-model="imageUrl"
:limit="1"
accept="image/*"
list-type="picture-card"
/>
<!-- 文件上传 -->
<sc-upload
v-model="fileList"
:limit="5"
:max-size="10"
/>
```
## 🤝 贡献指南
欢迎提交 Issue 和 Pull Request
@@ -585,11 +681,26 @@ Closes #123
- [Vue.js](https://vuejs.org)
- [Ant Design Vue](https://antdv.com)
- [Laravel Modules](https://nwidart.com/laravel-modules)
- [CKEditor 5](https://ckeditor.com)
- [ECharts](https://echarts.apache.org)
## 📝 更新日志
### v1.0.0 (2024-01-01)
- 🎉 初始版本发布
- ✅ 完成 Auth 模块(用户、角色、权限、部门)
- ✅ 完成 System 模块(配置、日志、字典、任务、城市、上传)
- ✅ 集成 Swoole 高性能服务
- ✅ 完成前端 Vue3 管理界面
- ✅ 实现 WebSocket 实时通信
---
<div align="center">
**LarAdmin** - 高性能后台管理系统
Made with ❤️ by [Tensent](http://git.tensent.cn)
</div>

View File

@@ -39,9 +39,9 @@
"composer install",
"@php -r \"file_exists('.env') || copy('.env.example', '.env');\"",
"@php artisan key:generate",
"@php artisan jwt:secret",
"@php artisan migrate --force",
"npm install",
"npm run build"
"@php artisan db:seed"
],
"dev": [
"Composer\\Config::disableProcessTimeout",

View File

@@ -3,8 +3,8 @@
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="基于 Laravel + Laravel-S + Swoole 的高性能后端 API 系统">
<title>Laravel-S - 高性能后 API 系统</title>
<meta name="description" content="LarAdmin - 基于 Laravel + Laravel-S + Swoole + Vue3 的高性能后台管理系统">
<title>LarAdmin - 高性能后台管理系统</title>
<style>
* {
margin: 0;
@@ -278,7 +278,7 @@
<header>
<div class="container">
<nav>
<a href="#" class="logo">🚀 Laravel-S</a>
<a href="#" class="logo">🚀 LarAdmin</a>
<ul class="nav-links">
<li><a href="#features">特性</a></li>
<li><a href="#tech">技术栈</a></li>
@@ -291,8 +291,8 @@
<section class="hero">
<div class="container animate-fadeInUp">
<h1>高性能后 API 系统</h1>
<p>基于 Laravel + Laravel-S + Swoole 构建的现代化后 API 系统,提供卓越的性能和开发效率</p>
<h1>高性能后台管理系统</h1>
<p>基于 Laravel 12 + Swoole + Vue3 构建的现代化后台管理系统,提供卓越的性能和开发效率</p>
<div>
<a href="/admin" class="btn btn-primary">进入后台管理</a>
<a href="https://github.com/hhxsv5/laravel-s" target="_blank" class="btn btn-secondary">查看文档</a>
@@ -315,24 +315,24 @@
<p>采用 Laravel Modules 实现模块化架构,业务模块独立管理,易于扩展和维护</p>
</div>
<div class="feature-card">
<div class="feature-icon">🔒</div>
<h3>安全可靠</h3>
<p>JWT 认证、RBAC 权限控制、数据验证等多重安全防护机制</p>
<div class="feature-icon">🔐</div>
<h3>完整权限</h3>
<p>基于 RBAC 权限控制系统,支持用户、角色、权限、部门管理</p>
</div>
<div class="feature-card">
<div class="feature-icon">🎨</div>
<h3>现代前端</h3>
<p>基于 Vue 3 + Ant Design Vue + Vite 构建的现代化管理界面</p>
</div>
<div class="feature-card">
<div class="feature-icon">📊</div>
<h3>完整后台</h3>
<p>基于 Vue3 + Ant Design Vue 构建的现代化后台管理系统</p>
<h3>数据管理</h3>
<p>支持数据导入导出、在线编辑、批量操作等功能</p>
</div>
<div class="feature-card">
<div class="feature-icon">🔄</div>
<h3>热重载</h3>
<p>开发环境支持文件监控热重载,提升开发体验</p>
</div>
<div class="feature-card">
<div class="feature-icon">📝</div>
<h3>RESTful API</h3>
<p>遵循 RESTful 规范的 API 设计,统一的响应格式</p>
<div class="feature-icon">🌐</div>
<h3>实时通信</h3>
<p>内置 WebSocket 支持,实现实时消息推送和在线状态同步</p>
</div>
</div>
</div>
@@ -344,11 +344,11 @@
<div class="tech-grid">
<div class="tech-item">
<div style="font-size: 36px;">🐘</div>
<h4>PHP</h4>
<h4>PHP 8.2+</h4>
</div>
<div class="tech-item">
<div style="font-size: 36px;">🔷</div>
<h4>Laravel</h4>
<h4>Laravel 12</h4>
</div>
<div class="tech-item">
<div style="font-size: 36px;">🚀</div>
@@ -358,21 +358,21 @@
<div style="font-size: 36px;"></div>
<h4>Laravel-S</h4>
</div>
<div class="tech-item">
<div style="font-size: 36px;">🔑</div>
<h4>JWT-Auth</h4>
</div>
<div class="tech-item">
<div style="font-size: 36px;">📦</div>
<h4>Laravel Modules</h4>
</div>
<div class="tech-item">
<div style="font-size: 36px;">💚</div>
<h4>MySQL</h4>
<h4>Vue 3</h4>
</div>
<div class="tech-item">
<div style="font-size: 36px;">🎨</div>
<h4>Ant Design</h4>
</div>
<div class="tech-item">
<div style="font-size: 36px;">💾</div>
<h4>MySQL 8.0+</h4>
</div>
<div class="tech-item">
<div style="font-size: 36px;">🔴</div>
<h4>Redis</h4>
<h4>Redis 6.0+</h4>
</div>
</div>
</div>
@@ -386,27 +386,34 @@
<h3>模块化设计</h3>
<p>项目采用清晰的分层架构,将业务逻辑合理划分:</p>
<ul class="architecture-list">
<li>基础模块Auth、System不使用 Laravel Modules 扩展</li>
<li>基础模块Auth、System核心功能模块</li>
<li>业务模块:使用 Laravel Modules 独立管理</li>
<li>Controller 层:处理 HTTP 请求</li>
<li>Service 层:业务逻辑处理</li>
<li>Model 层:数据模型定义</li>
<li>统一的 API 响应格式</li>
<li>完整的权限控制系统</li>
<li>WebSocket 实时通信支持</li>
</ul>
</div>
<div class="architecture-diagram">
<div style="background: #f8f9fa; padding: 30px; border-radius: 10px;">
<h4 style="text-align: center; margin-bottom: 20px; color: #667eea;">快速开始</h4>
<pre style="background: #333; color: #fff; padding: 20px; border-radius: 5px; overflow-x: auto;"><code># 安装依赖
<pre style="background: #333; color: #fff; padding: 20px; border-radius: 5px; overflow-x: auto;"><code># 一键安装
composer run setup
# 或手动安装
composer install
# 配置环境
cp .env.example .env
# 执行迁移
php artisan key:generate
php artisan migrate
php artisan db:seed
php artisan jwt:secret
# 启动 Laravel-S
# 启动开发服务
composer run dev
# 或启动 Swoole生产环境
php bin/laravels start
# 访问后台
@@ -419,7 +426,7 @@ php bin/laravels start
<footer>
<div class="container">
<p>&copy; 2024 Laravel-S. Built with ❤️ using Laravel & Swoole</p>
<p>&copy; 2024 LarAdmin. Built with ❤️ using Laravel & Swoole & Vue3</p>
</div>
</footer>
</body>

File diff suppressed because one or more lines are too long

View File

@@ -1 +0,0 @@
5302