快速安装

项目是基于前后端分离项目，所以我们分别进行安装

视频教程

Webman实战教程：中后台框架saiadmin快速入门 (opens new window)

在此感谢TinyWan的教程，感谢！开源技术小栈 (opens new window)上有很多高质量文章，有兴趣可以翻阅。

安装后端

基于 webman (opens new window)的插件模式安装，安装本系统前请先安装和配置好 webman (opens new window)框架环境

composer环境的安装命令如下

composer require saithink/saiadmin

如果php版本是7.X,安装失败，请使用以下命令进行安装

composer require -W saithink/saiadmin

安装成功后，系统将自动在webman的plugin目录下创建saiadmin目录

基本配置

1. 在webman的support/Request.php文件中添加一个方法more方法，用于增强参数获取。

注意 3.0.5版本开始，通过composer安装会自动在Request.php中添加more方法

/**
 * 获取参数增强方法
 * @param array $params
 * @return array
 */
public function more(array $params): array
{
    $p = [];
    foreach ($params as $param) {
        if (!is_array($param)) {
            $p[$param] = $this->input($param);
        } else {
            if (!isset($param[1])) $param[1] = '';
            if (is_array($param[0])) {
                $name = $param[0][0] . '/' . $param[0][1];
                $keyName = $param[0][0];
            } else {
                $name =  $param[0];
                $keyName = $param[0];
            }
            $p[$keyName] = $this->input($name, $param[1]);
        }
    }
    return $p;
}

方法使用如下,可以将获取的数据整合成一个数组，目的是为了方便数据查询

$where = $request->more([
    ['category_name', ''],
    ['create_time', ''],
]);

2. 本系统使用 ThinkPHP (opens new window)的ORM，数据库文件位于plugin/saiadmin/db的目录下

如果是全新安装的：只需要将saiadmin.sql文件导入数据库。

如果是通过版本升级的：需要执行执行以下附带版本号的数据库文件

导入完成后需要在config/thinkorm.php文件中配置数据库信息

本系统也支持数据库迁移migrate，具体操作参考 数据库迁移

return [
    'default' => 'mysql',
    'connections' => [
        'mysql' => [
            // 数据库类型
            'type' => 'mysql',
            // 服务器地址
            'hostname' => '127.0.0.1',
            // 数据库名
            'database' => 'saiadmin',
            // 数据库用户名
            'username' => 'root',
            // 数据库密码
            'password' => '123456',
            // 数据库连接端口
            'hostport' => '3306',
            // 数据库连接参数
            'params' => [
                // 连接超时3秒
                \PDO::ATTR_TIMEOUT => 3,
            ],
            // 数据库编码默认采用utf8
            'charset' => 'utf8',
            // 数据库表前缀
            'prefix' => 'eb_',
            // 断线重连
            'break_reconnect' => true,
            // 是否开启SQL监听
            'trigger_sql' => false,
        ],
    ],
];

3. 本系统默认使用file进行缓存，可以去配置文件修改为redis缓存，其他配置可以参考配置文件

4. 文件上传支持本地上传，阿里云，腾讯云，七牛云，具体配置参考 文件上传配置

启动后端

windows用户

直接运行windows.php或者执行php windows.php

linux用户

调试方式运行

php start.php start

正式环境运行

php start.php start -d

安装前端

请前往github或者gitee上进行下载安装

git clone https://github.com/saithink/saiadmin-vue.git
# 或
git clone https://gitee.com/appsai/saiadmin-vue.git

打开终端，进入到前端根目录，按照以下命令安装前端依赖

# 进入项目目录
cd saiadmin-vue
# 安装依赖
yarn install

在.env.development文件中配置后端地址

启动前端

# 开发模式启动
yarn dev
# 前端打包
yarn build