README.md · meystack/SwiftAdmin

<div align="center">
<img src="https://www.swiftadmin.net/static/images/sademo/110400_6a5e130d_904542.png" width="98" height="98" />
</div>
<h4 align="center">基于PHP MySQL开发的轻量级高性能快速开发框架</h4>
<p align="center">
<a href="https://gitee.com/meystack/swiftadmin/"><img src="https://badgen.net/badge/PHPCLI/MySQL/green" alt="thinkphp"></a>
<a href="https://gitee.com/meystack/swiftadmin/stargazers"><img src="https://gitee.com/meystack/swiftadmin/badge/star.svg?theme=gvp" alt="star"></a>
<a href="https://gitee.com/meystack/swiftadmin/">
<img src="https://badgen.net/badge/License/Apache/" alt="swiftadmin"></a>
</p>
<p align="center">本框架已于2025年7月16日停止更新，请自行 fork 项目开发。</p>
<p align="center">此去经年，望各位大佬 fork 如星火，各自璀璨。</p>

### 软件介绍

`SWIFTADMIN` 是一款基于 webman + Layui 开发的 http 服务框架，提供了一个简单易用的（权限）后台管理系统,

拥有极简的封装扩展，特别适合中小企业和个人站长用于开发 web 站点或者 http 接口。支持路由、中间件、 多应用、 自定义进程、无需更改直接兼容现有 composer 项目组件等诸多特性。具有学习成本低、简单易用、超高性能、超高稳定性等特点。

<font color="#dd0000">为什么选择 SWIFTADMIN？</font>

如果你熟悉ThinkPHP/Laravel/Yii2等框架，那么你可以很快上手 SWIFTADMIN，因为 SWIFTADMIN 是完全复用的这些框架的composer包。一样的代码写法，性能却可以提升10 倍以上。

运行在PHPCLI模式之下：

提供Workerman\Coroutine类，底层自动适配Swoole、Swow、Fiber协程、

提供协程相关的组件，例如 Context Channel Barrier Parallel WaitGroup Locker Pool等，底层自动适配Swoole、Swow、Fiber协程

<font color="#dd0000">注意事项：升级后不会自动使用协程，需要设置eventLoop才会开启协程，直接升级对业务没有影响。更多请详见下面常见问题：一定要看、一定要看、一定要看。重要的事情说三遍！！！</font>

### 软件架构

|  依赖   | 版本       | 说明                              |
|-----|----------|:--------------------------------|
| PHP               | \>= 8.1  | 最低支持PHP8.1版                     |
| WebMan            | \>= 2.1  | 基于workerman>5.1强悍核心             |
| MySQL             | \>= 5.7  | 最低 5.7,注意5.6版本无JSON字段，会报错       |
| Layui             | \>= 2.10 | 二次开发版，无法直接用官网替换，但提供map文件方便DEBUG |
| layui-form-design | \>= 1.0  | 表单设计器，基于Sortable专为SAPHP框架开发     |
| Admin Theme       | \>= 1.x  | 专为本框架开发、封装超多功能、支持多种菜单布局         |

### 软件功能

- [x] `用户管理` 用户是系统操作者，该功能主要完成系统用户配置。
- [x] `公司管理` 设置公司常用信息，前端标签调用
- [x] `部门管理` 配置系统组织机构（部门、小组），树结构展现支持数据权限。
- [x] `岗位管理` 配置系统用户所属担任职务。
- [x] `菜单管理` 配置系统菜单，操作权限，按钮、栏目等权限标识等。
- [x] `角色管理` 角色菜单权限分配、设置角色按机构进行数据范围权限划分。
- [x] `插件管理` 可开发定制属于自己的插件，可安装升级社区插件！！！
- [x] `数据字典` 对系统中经常使用的一些较为固定的数据进行维护。
- [x] `操作日志` 用户后台操作日志，全局异常、SQL注入等记录

### 软件优势

- **开箱即用**  分钟快速安装，安装后即可进入开发无需复杂配置。
- **精美样式**  针对Layui2.x管理端开发独立ant Design精美样式。
- **方便快捷**  没用VUE框架，免编译，基于原生jQuery并封装统一入口。
- **菜单接入**  接口化菜单接入，可将应用轻松接入任意菜单模块中，无需后台配置。
- **表单构建**  基于Layui2.x开发的可视化表单设计器，可自定义表单控件，极大提高开发效率。
- **代码生成**  轻松一键CURD，自动生成代码，自动生成表单，自动生成接口，自动生成菜单，自动生成权限。
- **插件开发**  支持自定义插件开发，可定制自己的插件，并支持一键打包/升级/测试。
- **性能强悍**  底层WebMan-PHPCli常驻内存模式，性能是TP/Laravel的10倍以上。

### 安装使用

1、首先将本框架直接clone到你本地,或者直接下载
```
 * git clone https://gitee.com/meystack/swiftadmin.git
 * 请使用宝塔面板或其他PHP集成环境
 * 安装Apache或者NGINX服务器
 * 安装PHP，版本 >= 8.1
 * 安装PHP扩展fileinfo opcache redis imagemagick exif
 * 注意：Windows环境下PHP8.1你需要自行去https://pecl.php.net/package/redis/5.3.7/windows下载redisDLL扩展
 * 开发环境下关闭禁用PHP函数exec、putenv、proc_open、proc_get_status、pcntl_signal[如果存在]
 * Linux环境下，请关闭禁用shell_exec pcntl_signal pcntl_fork pcntl_wait pcntl_alarm exec函数！
```
<font color="#dd0000">2、Windows环境下启动开发服务</font>
```
执行Windows.bat 进行完整开发，默认会监听app、config、plugin目录的PHP html的更改热加载
```
3、Linux环境下启动开发服务
```
执行命令：php start.php start        # 启动开发服务
执行命令：php start.php stop         # 停止开发服务
执行命令：php start.php restart      # 重启开发服务
守护进程：php start.php start -d     # 启动守护进程 一般为生产环境/修改文件后无法自动重载

注：当前默认只有app、config文件夹下文件内容被修改后才会自动重启，全局监听方案，请参考开发文档
```
4、打开浏览器输入网址，访问项目
```
http://localhost:8787/index              # 访问项目执行安装
```
5、安装完毕后，访问后台URL登录系统
```
http://localhost:8787/manage        # 登录后台/生产环境下可自行修改后台地址
```

### 常见问题

1、启动开发服务后，访问项目报错 Server internal error
```
请检查是否安装了PHP扩展fileinfo opcache redis imagemagick exif，一般这个错误是PHP扩展没有安装、或者Redis服务器安装后没启动
```
2、启动开发服务后，访问项目报错 404 Not Found
```
请检查是否安装了Apache或者NGINX服务器，一般这个错误是服务器没有安装、或者没有启动
```
3、启动服务器的时候报错：PHP Fatal error:  ....
```
首先在CMD终端或Linux终端执行命令：php -v  查看 * 默认PHP版本 *，如果版本低于8.0，请升级PHP版本<br/>
然后使用命令：php -m  查看 * 已安装的PHP扩展 *，如果没有安装fileinfo opcache redis imagemagick exif，请安装<br/>
一定要注意的是：swiftadmin框架运行在webman核心上，并且运行的时候默认调用的是当前操作系统，默认的PHP环境变量的那个版本，<br/>
如果是windows环境，之前安装过PHP7.3，那么安装PHP8之后需要修改系统环境变量才可以执行；
```
4、为什么最低需要PHP8.1及以上版本？
```
swiftadmin框架基于workerman>5.1+webmanv2.1上，所以最低需要PHP8.1及以上版本。并需要注意的是，当前框架的v2版本不与v1版本兼容
在Windows系统下，PHP8.1如果宝塔面板没有redis组件，请到http://pecl.php.net/package/redis/5.3.7/windows进行下载开启php.ini即可
```
5、升级后vendor里面的扩展包为什么变少了？
```angular2html
1、由于框架升级，vendor里面的扩展包变少了，但是不会影响系统运行<br/>
2、如果你的项目需要一些常规工具扩展包，请自行使用composer安装即可。
3、框架默认安装了一些常用的扩展包，比如支付/dumper/二维码/拼音库，是为了方便你们直接使用。
```

### 反馈BUG

> 前往论坛反馈BUG

论坛反馈 : https://ask.swiftadmin.net/

> 加入反馈QQ群更快获得解答

### 项目演示
GOTO: <a href="http://demo.swiftadmin.net/manage" target="_blank">
http://demo.swiftadmin.net/manage </a> </b><br/>
<b>管理账号  admin admin888 </b><br/>
<b>测试账号  ceshi admin888 </b>如正式运营环境请删除测试账号;<br/>

### ✔️ 特别鸣谢

感谢以下的项目,排名不分先后

jQuery：http://jquery.com

Layui: https://www.layuion.com

ThinkPHP：http://www.thinkphp.cn

WebMan：http://www.workerman.net

Jetbrains：https://www.jetbrains.com/

### 版权信息

[`SwiftAdmin`] 遵循Apache2开源协议发布，并提供免费使用。

使用本框架不得用于开发违反国家有关政策的相关软件和应用，否则要付法律责任！

本软件依法享有国家著作权保护，故使用本软件者不得恶意篡改本源码，包括但不限于（植入木马病毒，违法应用）进行恶意传播。

不得对本软件进行恶意篡改或倒卖，不得对本软件进行二次包装后声称为自己的产品等，请遵守国家著作权法！

本项目著作权号 `2021SR0761953`, 其中包含的第三方源码和二进制文件之版权信息另行标注。

meystack/SwiftAdmin

简介

发行版 (6)

贡献者

语言

近期动态

meystack/SwiftAdmin .gitee-modal { width: 500px !important; }

简介

发行版 (6)

开源评估指数源自 OSS-Compass 评估体系，评估体系围绕以下三个维度对项目展开评估：

贡献者

语言

近期动态

搜索帮助

meystack/SwiftAdmin