README.md · nwtjacky/SwiftAdmin

基于PHP MySQL开发的轻量级高性能快速开发框架

软件介绍

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

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

为什么选择 SWIFTADMIN？

如果你熟悉ThinkPHP/Laravel/Yii2等框架，那么你可以很快上手 SWIFTADMIN，因为 SWIFTADMIN 是完全复用的这些框架的composer包。一样的代码写法，性能却可以提升10 倍以上。运行在PHPCLI模式之下，他不是类似于SWOOLE异步协程的工作模式，所以新手朋友不需要担心变量污染的问题，也不需要担心第三方扩展包异步协程的问题，只需要专注于业务开发即可。

软件架构

依赖	版本	说明
PHP	>= 8.0	最低支持PHP8.0
WebMan	>= 1.4.3	基于workerman强悍核心
MySQL	>= 5.7	最低 5.7,注意5.6版本无JSON字段，会报错
Layui	>= 2.7	特殊封装版，无法直接用官网替换
layui-form-design	>= 1.0	表单设计器，基于Sortable专为SAPHP框架开发
Admin Theme	>= 1.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.0
 * 安装PHP扩展fileinfo opcache redis imagemagick exif
 * 开发环境下关闭禁用PHP函数exec、putenv、proc_open、proc_get_status、pcntl_signal[如果存在]
 * Linux环境下，请关闭禁用shell_exec pcntl_signal pcntl_fork pcntl_wait pcntl_alarm exec函数！

2、Windows环境下启动开发服务

执行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之后需要修改系统环境变量才可以执行；