德尚网络

Appearance

ThinkPHP 后端安装 ​

概述 ​

DSMall Pro后端基于ThinkPHP 8.0框架开发，本文档介绍如何在宝塔面板环境下安装和配置后端环境。

环境要求 ​

基础环境 ​

推荐工具 ​

安装步骤 ​

1. 环境准备 ​

请参考 安装指南首页 完成宝塔面板安装和基础环境配置。

2. 创建网站 ​

  1. 宝塔面板 → 网站 → 添加站点
  2. 填写域名（如：api.yourdomain.com）
  3. 选择PHP版本：8.0
  4. 创建数据库（可选，后续安装程序会创建）

3. 上传项目文件 ​

  1. 文件管理 → 进入网站根目录
  2. 上传DSMall Pro项目文件到网站根目录
  3. 解压文件（如果是压缩包）

4. 设置运行目录 ​

重要：ThinkPHP框架需要设置public为运行目录

在宝塔面板中设置：

  1. 网站 → 设置 → 网站目录
  2. 将运行目录设置为：/public
  3. 保存设置

5. 配置伪静态 ​

重要：ThinkPHP框架必须配置伪静态才能正常访问

在宝塔面板中配置伪静态：

  1. 网站 → 设置 → 伪静态
  2. 选择"ThinkPHP"规则，或手动添加以下规则：
nginx
location / {
    if (!-e $request_filename) {
        rewrite  ^(.*)$  /index.php?s=/$1  last;
        break;
    }
}

6. 配置SSL证书 ​

重要：生产环境建议配置SSL证书

在宝塔面板中配置SSL：

  1. 网站 → 设置 → SSL
  2. 申请Let's Encrypt免费证书，或上传您自己的SSL证书
  3. 开启强制HTTPS
  4. 配置SSL参数（可选）

7. 运行在线安装程序 ​

DSMall Pro提供了便捷的在线安装程序，位于 public/install/ 目录下。

访问安装程序 ​

在浏览器中访问：https://your-domain.com/install/

安装步骤 ​

步骤1：阅读许可协议

  • 仔细阅读并同意许可协议

步骤2：环境检测

  • 系统会自动检测服务器环境
  • 确保所有检测项目都通过

步骤3：数据库配置

  • 数据库主机：127.0.0.1
  • 数据库端口：3306
  • 数据库用户名：root（或您创建的数据库用户）
  • 数据库密码：您的数据库密码
  • 数据库名：ds_admin
  • 数据表前缀：ds_（默认）

步骤4：管理员配置

  • 管理员用户名：admin（建议修改）
  • 管理员密码：设置强密码
  • 管理员邮箱：您的邮箱地址

步骤5：安装完成

  • 系统会自动导入数据库结构
  • 创建管理员账号
  • 生成配置文件
  • 创建安装锁定文件

常见问题 ​

Q: 数据库连接失败 ​

  • 检查数据库服务是否启动
  • 验证数据库名、账户、密码
  • 阿里云数据库需要配置外网访问

最后更新：2024-01-20
维护者：DSPlatform技术团队