molong/laravel_swoole
Template
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

更新

Browse Source
This commit is contained in:
molong
2026-02-09 09:29:21 +08:00
parent 616314eef2
commit 9939680942
6 changed files with 199 additions and 82 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
.gitignore vendored
View File

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

191
README.md
View File

@@ -1,6 +1,6 @@
<div align="center"> <div align="center">
# Laravel Swoole 管理系统 # LarAdmin
基于 Laravel + Swoole + Vue3 的高性能后台管理系统 基于 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+ (状态管理) - **Pinia**: 3.0+ (状态管理)
- **Axios**: HTTP 客户端 - **Axios**: HTTP 客户端
- **Vue I18n**: 国际化支持 - **Vue I18n**: 国际化支持
- **CKEditor 5**: 富文本编辑器
- **ECharts**: 数据可视化
## 📁 项目结构 ## 📁 项目结构
``` ```
laravel_swoole/ laradmin/
├── app/ # 基础模块目录 ├── app/ # 基础模块目录
│ ├── Http/Controllers/ # 控制器 │ ├── Http/Controllers/ # 控制器
│ │ ├── Auth/ # 认证模块控制器 │ │ ├── Auth/ # 认证模块控制器
@@ -71,7 +73,8 @@ laravel_swoole/
│ │ │ ├── Task.php │ │ │ ├── Task.php
│ │ │ ├── City.php │ │ │ ├── City.php
│ │ │ └── Upload.php │ │ │ └── Upload.php
│ │ └── Api/ │ │ ├── Api/
│ │ └── WebSocket.php
│ ├── Models/ # 模型 │ ├── Models/ # 模型
│ │ ├── Auth/ │ │ ├── Auth/
│ │ │ ├── User.php │ │ │ ├── User.php
@@ -81,9 +84,11 @@ laravel_swoole/
│ │ └── System/ │ │ └── System/
│ ├── Services/ # 服务层 │ ├── Services/ # 服务层
│ │ ├── Auth/ │ │ ├── Auth/
│ │ └── System/ │ │ ├── System/
│ └── Exports/ # 导出类 │ │ └── WebSocket/
│ └── Imports/ # 导入类 │ ├── Exports/ # 导出类
│ ├── Imports/ # 导入类
│ └── Middleware/ # 中间件
├── Modules/ # 业务模块目录 ├── Modules/ # 业务模块目录
│ └── ModuleName/ # 业务模块示例 │ └── ModuleName/ # 业务模块示例
│ ├── App/ │ ├── App/
@@ -105,11 +110,18 @@ laravel_swoole/
│ │ ├── src/ │ │ ├── src/
│ │ │ ├── api/ # API 接口 │ │ │ ├── api/ # API 接口
│ │ │ ├── components/ # 公共组件 │ │ │ ├── components/ # 公共组件
│ │ │ │ ├── scForm/ # 表单组件
│ │ │ │ ├── scTable/ # 表格组件
│ │ │ │ ├── scUpload/ # 上传组件
│ │ │ │ ├── scEditor/ # 富文本编辑器
│ │ │ │ ├── scImport/ # 导入组件
│ │ │ │ └── scExport/ # 导出组件
│ │ │ ├── layouts/ # 布局组件 │ │ │ ├── layouts/ # 布局组件
│ │ │ ├── pages/ # 页面组件 │ │ │ ├── pages/ # 页面组件
│ │ │ ├── router/ # 路由配置 │ │ │ ├── router/ # 路由配置
│ │ │ ├── stores/ # 状态管理 │ │ │ ├── stores/ # 状态管理
│ │ │ ├── utils/ # 工具函数 │ │ │ ├── utils/ # 工具函数
│ │ │ ├── hooks/ # 组合式 API
│ │ │ └── i18n/ # 国际化 │ │ │ └── i18n/ # 国际化
│ │ └── package.json │ │ └── package.json
│ └── views/ │ └── views/
@@ -148,25 +160,31 @@ laravel_swoole/
#### 1. 克隆项目 #### 1. 克隆项目
```bash ```bash
git clone http://git.tensent.cn/molong/laravel_swoole.git git clone http://git.tensent.cn/molong/laravel_swoole.git laradmin
cd laravel_swoole cd laradmin
``` ```
#### 2. 安装依赖 #### 2. 自动安装（推荐）
```bash
# 一键安装所有依赖并初始化
composer run setup
```
此命令会自动执行：
- 安装后端依赖
- 配置环境文件
- 生成应用密钥
- 执行数据库迁移
- 安装前端依赖
- 构建前端资源
#### 3. 手动安装
```bash ```bash
# 安装后端依赖 # 安装后端依赖
composer install composer install
# 安装前端依赖
cd resources/admin
npm install
cd ../..
```
#### 3. 环境配置
```bash
# 复制环境配置文件 # 复制环境配置文件
cp .env.example .env cp .env.example .env
@@ -175,31 +193,22 @@ php artisan key:generate
# 配置数据库、Redis等参数 # 配置数据库、Redis等参数
# 编辑 .env 文件 # 编辑 .env 文件
```
#### 4. 执行数据库迁移 # 执行数据库迁移
```bash
# 执行迁移
php artisan migrate php artisan migrate
# 填充初始数据 # 填充初始数据
php artisan db:seed php artisan db:seed
```
#### 5. 配置 JWT
```bash
# 生成 JWT 密钥 # 生成 JWT 密钥
php artisan jwt:secret php artisan jwt:secret
```
#### 6. 构建前端 # 安装前端依赖
```bash
cd resources/admin cd resources/admin
npm install
# 构建前端
npm run build npm run build
cd ../..
``` ```
### 运行项目 ### 运行项目
@@ -207,15 +216,31 @@ cd ../..
#### 开发模式 #### 开发模式
```bash ```bash
# 启动 Laravel 开发服务器 # 一键启动所有服务
php artisan serve composer run dev
# 启动前端开发服务器（另开终端）
cd resources/admin
npm 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 ```bash
# 启动 Laravel-S 服务 # 启动 Laravel-S 服务
@@ -229,6 +254,9 @@ php bin/laravels restart
# 重载服务（平滑重启） # 重载服务（平滑重启）
php bin/laravels reload php bin/laravels reload
# 查看状态
php bin/laravels status
``` ```
访问地址：http://localhost:5200 (默认) 访问地址：http://localhost:5200 (默认)
@@ -530,6 +558,74 @@ npm run format
bin/inotify # Linux 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！ 欢迎提交 Issue 和 Pull Request！
@@ -585,11 +681,26 @@ Closes #123
- [Vue.js](https://vuejs.org) - [Vue.js](https://vuejs.org)
- [Ant Design Vue](https://antdv.com) - [Ant Design Vue](https://antdv.com)
- [Laravel Modules](https://nwidart.com/laravel-modules) - [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"> <div align="center">
**LarAdmin** - 高性能后台管理系统
Made with ❤️ by [Tensent](http://git.tensent.cn) Made with ❤️ by [Tensent](http://git.tensent.cn)
</div> </div>

4
composer.json
View File

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

83
resources/views/welcome.blade.php
View File

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

1
storage/laravels.conf
View File

File diff suppressed because one or more lines are too long

1
storage/laravels.pid
View File

@@ -1 +0,0 @@
5302