跳至主要內容

5.1 快速安装

提示

自saiadmin 5.1 开始，我们增加了 saiadmin-boot 引导项目的方式安装

视频安装教程

A BiliBili video

安装方式 【推荐】

saiadmin-boot 是一个整合了 saiadmin后端 和 saiadmin-vue前端 的引导项目，能够方便我们快速的运行和创建 saiadmin 项目，完全保留了 webman2.x 的原汁原味，仅仅引入了 saiadmin 插件 和 saipackage 插件管理工具

前置准备

环境要求

在启动项目前，你需要确保你的环境满足以下要求：

  • Node.js 16 及以上版本，推荐使用 fnm 、 nvm进行版本管理。
  • Git 任意版本。
  • 推荐 yarn + Node20 进行前端项目管理。
  • php 8.1 及以上版本，推荐 php8.2 作为后端运行环境版本。
  • 推荐官方源或者腾讯源作为 composer 源

验证你的环境是否满足以上要求，你可以通过以下命令查看版本：

# 出现相应 node LTS版本即可
node -v
# 出现相应 php 版本即可
php -v
# 设置composer官方源
composer config --unset repos.packagist
# 设置composer腾讯源
composer config -g repos.packagist composer https://mirrors.cloud.tencent.com/composer/
# 切换源后，注意清理一下缓存
composer clear-cache

1、项目下载

只需要一个命令即可下载整个项目：

Gitee
git clone --recurse-submodules https://gitee.com/saigroup/saiadmin-boot

2、后端安装

进入 saiadmin-boot 目录后，执行以下命令进行后端依赖安装

cd webman && composer install

windows用户运行

双击 windows.bat 或者运行 php windows.php 启动

linux用户运行

调试方式运行（用于开发调试，打印数据会显示在终端，终端关闭后webman服务也随之关闭）

php start.php

守护进程方式运行（用于正式环境，打印数据不会显示在终端，终端关闭后webman服务会持续运行）

php start.php -d

初始化方式一

我们在安装好以上步骤后，可以直接通过初始化界面完成安装，初始化界面访问地址：

http://localhost:8787/core/install

输入对应的信息，然后点击下一步就执行安装

初始化方式二

我们项目中有一个.env.example 的示例环境变量，可以直接改为 .env 文件，然后修改其中的数据库配置信息即可运行

3、前端安装

进入 saiadmin-boot 目录后，执行以下命令进行前端依赖安装

cd saiadmin-vue && yarn install

运行前端项目

yarn dev

打包前端项目

yarn build

访问项目

确认后端初始化成功后，我们可以通过前端访问项目了，访问地址：

http://localhost:8888

更新项目

git pull && git submodule update --remote --recursive