系统安装
部署环境要求
Simplest Admin V2 (后台管理系统) 推荐服务器环境要求:
PHP = 7.4.x (限v6分支), >= 8.1
MySQL >= 5.6 / 8.0 支持innodb引擎
Apache 或者 Nginx
开发环境建议安装
Simplest Admin V2 后台管理系统推荐开发环境要求:
PHP = 7.4.x (限v6分支), >= 8.1
MySQL >= 5.6 / 8.0 支持innodb引擎
Apache 或者 Nginx
Git 代码版本管理器
Node.js JavaScript运行环境,安装Vue相关支持(>= v14.21)
Composer PHP的包管理器(v2.0)
yarn 替代npm的依赖安装工具( > v1.14)
apidoc 用于生成API文档的工具( = v0.50.5)
nodejs版本兼容解决方案
最新增加编译命令:
"scripts": {
"serve": "vue-cli-service serve",
"build": "vue-cli-service build",
"serve17": "set NODE_OPTIONS=--openssl-legacy-provider & vue-cli-service serve",
"build17": "set NODE_OPTIONS=--openssl-legacy-provider & vue-cli-service build"
},
- v16版本及以下:正常通过命令yarn安装依赖,编译用 yarn build
- v17版本:通过命令 yarn 直接安装依赖,编译用 yarn build17
- v18版本:通过命令 yarn 直接安装依赖,编译用 yarn build17
# 若出现提示:error Found incompatible module.
# 请开启如下选项后,再安装依赖
yarn config set ignore-engines true
# 安装前端依赖
yarn install
# 编译前端
yarn build17
集成开发环境软件推荐
因涉及安装PHP依赖和Vue依赖,配置比较复杂,初学者往往很难一次搞定,我们建议安装 集成开发环境laragon软件,因为通过安装此软件可以自动安装几乎所有您需要的软件。
- 请为保持兼容性请下载6.0版本 (此版本所有软件均兼容最新版源码)
- 官网下载(下载时注意版本为6.0版本)
- 如需安装其他版本请点击下面的链接下载
- 全部版本PHP
- 安装yarn和apidoc
npm i yarn -g // 安装yarn
yarn global add apidoc@0.50.5 // 安装apidoc版本必须一致
开发环境软件版本检查
为了确保安装和开发能够正常进行,我们建议分别检查各个软件的版本。

下载指定版本
# 下载 thinkphp 6 版本
git clone -b v6 git@github.com:SimplestAdminGroup/simplest-admin-v2.git
# 下载 thinkphp 8 版本
git clone git@github.com:SimplestAdminGroup/simplest-admin-v2.git
安装后端依赖
请查看是否存在 vender 目录,如果已经存在,可以不安装后端依赖。
composer install
执行安装过程
- 检查是否配置伪静态 请参考这里
- 为项目创建虚拟主机(或者部署到本地开发环境的Web服务器根目录)
- 将后台管理系统源码复制到虚拟主机的根目录
- 在浏览器中打开虚拟主机地址
- 在浏览器的表单中根据提示填写相关信息

- 确保系统的登录界面中,能够正常显示验证码,如果不能正常显示验证码,则检查是否开启了伪静态

- 如出现上述登录界面,则关闭浏览器即可,系统安装完成!
本地开发步骤
::: warning 安装过程就是配置数据库连接和配置前端接口地址的过程,只有正常完成安装过程后,才可以开启本地开发模式; :::
如果已经完成安装过程,请打开命令行工具,切换到ui目录
- 安装前端依赖
- 在源码目录下的ui目录中执行命令:
# 若出现提示:error Found incompatible module.
# 请开启如下选项后,再安装依赖
yarn config set ignore-engines true
# 安装前端依赖
yarn install
- 启动前端项目
- 在源码目录下的ui目录中执行命令:
# 启动前端开发服务器
yarn serve
* 前端项目会自动打开浏览器
* 系统会自动监听3333端口,浏览器打开的地址为:http://localhost:3333
-
登录系统,开始系统开发
-
系统部署到服务器前执行前端编译
# 编译前端
yarn build17