【低代码开发】本地安装开发环境

126 阅读3分钟

系统安装

配套视频

部署环境要求

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软件,因为通过安装此软件可以自动安装几乎所有您需要的软件。

  • 安装yarn和apidoc
npm i yarn -g     // 安装yarn
yarn global add apidoc@0.50.5  // 安装apidoc版本必须一致

开发环境软件版本检查

为了确保安装和开发能够正常进行,我们建议分别检查各个软件的版本。

img_4.png转存失败,建议直接上传图片文件

下载指定版本

# 下载 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服务器根目录)
  • 将后台管理系统源码复制到虚拟主机的根目录
  • 在浏览器中打开虚拟主机地址
  • 在浏览器的表单中根据提示填写相关信息

img_1.png转存失败,建议直接上传图片文件

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

img_3.png转存失败,建议直接上传图片文件

  • 如出现上述登录界面,则关闭浏览器即可,系统安装完成!

本地开发步骤

::: warning 安装过程就是配置数据库连接和配置前端接口地址的过程,只有正常完成安装过程后,才可以开启本地开发模式; :::

如果已经完成安装过程,请打开命令行工具,切换到ui目录

  • 安装前端依赖
    • 在源码目录下的ui目录中执行命令:
# 若出现提示:error Found incompatible module.
# 请开启如下选项后,再安装依赖
yarn config set ignore-engines true
# 安装前端依赖
yarn install
  • 启动前端项目
    • 在源码目录下的ui目录中执行命令:
# 启动前端开发服务器
yarn serve
* 前端项目会自动打开浏览器
* 系统会自动监听3333端口,浏览器打开的地址为:http://localhost:3333
  • 登录系统,开始系统开发

  • 系统部署到服务器前执行前端编译

# 编译前端
yarn build17