## 安全前提 **首先请使用php -v 命令查看您默认的PHP版本，php-m 查看当前已经安装的扩展，因为当前项目是运行在默认的PHP版本上的，** **比如您最开始安装过PHP7.3并且又安装了扩展，但是您为了运行这个PHP工程，又安装了PHP8，但还是跑不起来！** **首先请使用php -v 命令查看您默认的PHP版本，php-m 查看当前已经安装的扩展，因为当前项目是运行在默认的PHP版本上的，** **比如您最开始安装过PHP7.3并且又安装了扩展，但是您为了运行这个PHP工程，又安装了PHP8，但还是跑不起来！** **首先请使用php -v 命令查看您默认的PHP版本，php-m 查看当前已经安装的扩展，因为当前项目是运行在默认的PHP版本上的，** **比如您最开始安装过PHP7.3并且又安装了扩展，但是您为了运行这个PHP工程，又安装了PHP8，但还是跑不起来！** 重要的事情一定要强调！ ## 环境要求 ``` * 安装Apache或者NGINX服务器 * 安装PHP，版本 >= 8.0 * 安装PHP扩展fileinfo opcache redis imagemagick exif * 开发环境下关闭禁用PHP函数exec、putenv、proc_open、proc_get_status、pcntl_signal[如果存在] ``` 如果遇到configure: error: Package requirements (libzip ＞= 0.11 libzip != 1.3.1 libzip != 1.7.0) 错误，请参考： 官网下载地址 wget https://libzip.org/download/libzip-1.3.2.tar.gz ### 卸载自身的libzip ``` yum remove libzip ``` ### 下载 ``` wget https://libzip.org/download/libzip-1.3.2.tar.gz tar xvf libzip-1.3.2.tar.gz cd libzip-1.3.2 ./configure && make && make install ``` ### 查看libzip位置 ``` [root@VM-8-9-centos php-7.4.28]# whereis libzip libzip: /usr/local/lib/libzip.la /usr/local/lib/libzip.a /usr/local/lib/libzip.so ``` ### 配置libzip库，使configure可以找到它 ``` export PKG_CONFIG_PATH="/usr/local/lib/pkgconfig/" ``` >请确保您的服务器里面存在php zip扩展 ## 安装包下载 ``` 安装包可以在`GItee`或者GITHUB进行下载ZIP压缩包，也可以使用git clone命令克隆到本地即可 https://gitee.com/meystack/swiftadmin/ 请务必点击Star支持，点Star会保佑你正常安装成功，否则会出现BUG ``` ## 开始安装 ### 推荐环境 ``` 现在市面上很多PHP的环境，经过测试大多数环境，在易用性、运维程度上，推荐大家使用宝塔面板，最好在Linux下开发是最方便的 ``` ### 安装详情 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[如果存在] ``` 2、Windows环境下启动开发服务 ``` 找到根目录下的Windows.bat文件，双击执行该文件即可启动服务。 ``` 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/ # 访问项目执行安装 ``` 5、安装完毕后，访问后台URL登录系统 ``` http://localhost:8787/manage # 登录后台/生产环境下可自行修改后台地址 ``` ## 小皮面板 如果你使用小皮本地PHP环境运行的话，首先是需要你将php文件夹设置到环境变量，比如你的PHP安装路径为C:\phpstudy_pro/php8.0 那么这时候需要你将C:\phpstudy_pro/php8.0加入到Windows系统环境变量里面，否则你在终端CMD下 使用php -v 是获取不到的 提示找不到命令 另外需要注意的是，本框架依赖于Redis扩展服务器，所以你需要确保小皮面板安装redis服务器，更更更需要注意的是，默认小皮面板安装Redis服务器后，他默认是不启动的 **所以需要你启动小皮面板下的Redis服务器，所以需要你启动小皮面板下的Redis服务器，所以需要你启动小皮面板下的Redis服务器，** ## 服务器部署 部署项目我们需要使用NGINX进行反向代理操作，如果您使用Apache的话可以搜索下Apache的反向代理规则，建议您使用运维面板操作，更方便一些！ >Nginx部署 使用Nginx部署可以很方便的实现均衡负载，以及SSL的配置，能够让多个webman共用80、443端口，通过域名区分不同站点，实现单台服务器部署多个站点 ``` upstream swiftadmin { server 127.0.0.1:8787; keepalive 10240; } server { server_name 站点域名; listen 80; access_log off; root /www/swiftadmin/public; location ^~ / { proxy_set_header X-Real-IP $remote_addr; proxy_set_header Host $host; proxy_set_header X-Forwarded-Proto $scheme; proxy_http_version 1.1; proxy_set_header Connection ""; if (!-f $request_filename){ proxy_pass http://swiftadmin; } } } ``` ## 宝塔部署 >启动项目 在Linux下请在根目录使用php start.php start来启动项目，如果需要后台运行请增加 -d参数 `php start.php start -d` 我们建议您使用运维面板安装supervisord（进程守护管理器）来运行项目。  1、首先建立一个web站点，如下图：  2、然后绑定静态资源到public文件夹  3、开启反向代理  其他如Apache部署swiftadmin项目，如果使用运维面板来处理，步骤是一样的。更多细节需要您熟悉网站的搭建才可以！ ## 常见问题 1、启动安装出现500错误，因只在宝塔面板下做的开发，没有测试过其他的PHP集成环境； 500错误一般都是配置的问题或者缺少扩展你可以直接在apache或者nginx下查看error的日志信息，或者直接在根目录下添加.env文件（如果未安装的情况下），开启debug调试模式即可！ 2、提示控制器错误？ 默认后台的控制，多级控制器采用 / 符号链接，比如后台用户控制器为 /system/Admin/index 3、安装完成后打开直接404错误？ 我们默认没有启用自动路由，官方也不建议安装自动路由插件，所以请使用[http://127.0.0.1:8787/index来访问前端页面，](http://127.0.0.1:8787/index%E6%9D%A5%E8%AE%BF%E9%97%AE%E5%89%8D%E7%AB%AF%E9%A1%B5%E9%9D%A2%EF%BC%8C) 比如您的控制器在app/index/controller/Ben.php 里面有一个叫做fire的函数，那么您的访问路径为http://127.0.0.1:8787/index/ben/fire 更新于 2026-08-09 14:36 阅读 18 ← 前言 架构 → 相关问题 前言 架构 多语言 数据库 控制器 静态前端 权限管理 全局组件
数卡购
本系统文档