五、安装步骤详解（共 5 步）

以下步骤请严格按顺序操作，不要跳过任何一步。

安装流程总览

flowchart TD
    A[开始安装] --> B[第一步：宝塔创建网站站点]
    B --> C[第二步：安装 PHP 必需扩展]
    C --> D[第三步：上传项目文件]
    D --> E[第四步：浏览器完成安装向导]
    E --> F[第五步：安装后安全检查]
    F --> G[安装完成 ✅]

    subgraph 准备阶段
        B
        C
        D
    end

    subgraph 安装阶段
        direction LR
        E1[Step 0: 环境检测] --> E2[Step 1: 授权连接]
        E2 --> E3[Step 2: 数据库配置]
        E3 --> E4[Step 3: 管理员账户]
        E4 --> E5[Step 4: 执行安装]
        E5 --> E6[Step 5: 完成]
    end

    E -.-> 准备阶段

    subgraph 收尾阶段
        F1[删除 install.php] --> F2[设置目录权限]
    end

    F -.-> 收尾阶段

第一步：在宝塔中创建网站站点

1. 登录宝塔面板（浏览器访问 http://你的服务器IP:8888）

2. 左侧菜单点击 网站 → 左上角 添加站点

3. 填写站点信息：

   字段	填写内容
   域名	你的域名（如 yourdomain.com）
   PHP 版本	PHP-81
   数据库	选择 MySQL，勾选"自动创建数据库"

4. 点击 提交

创建后请记下以下信息（后续步骤需要）：

数据库名：        ____________
数据库用户名：    ____________
数据库密码：      ____________
站点根目录：      /www/wwwroot/你的域名/

忘记可在宝塔 → 数据库 中查看。

第二步：安装 PHP 必需扩展

1. 宝塔 → 软件商店 → 找到 PHP-8.1 → 点击 设置

2. 选择 安装扩展 标签

3. 确认以下扩展均已安装（绿色即已安装，未安装的点安装）：

   • pdo_mysql — 数据库连接
   • gd — 验证码/图片处理
   • fileinfo — 文件类型检测
   • mbstring — 多字节字符串
   • openssl — 加密通信
   • curl — 远程请求
   • zip — 压缩包处理

4. 安装完成后，在 配置修改 标签中确认上传限制：

   upload_max_filesize = 50M
   post_max_size = 50M

   修改后点击保存，并重启 PHP。

第三步：上传项目文件

1. 宝塔 → 文件 → 进入站点根目录（/www/wwwroot/你的域名/）
2. 上传项目压缩包并解压（确保文件直接在根目录下）

重要检查： 解压后，index.php、install.php 等文件应在 /www/wwwroot/你的域名/ 下，而不是子文件夹中。项目已内置 PHPMailer，无需额外安装 Composer 依赖。

第四步：浏览器完成安装向导

1. 浏览器访问：http://你的域名/install.php

2. 按向导完成安装：

   Step 0 — 环境检测

   • 自动检查 PHP 版本、扩展、目录权限
   • 全部绿色 ✔ 通过后点击下一步

   Step 1 — 授权连接

   • 系统自动申请 API Key，全程自动完成

   Step 2 — 数据库配置

   • 填写第一步记下的数据库名、用户名、密码
   • 主机填 127.0.0.1

   Step 3 — 管理员账户

   • 设置管理员邮箱和登录密码

   Step 4 — 执行安装

   • 自动创建数据库表、写入默认配置
   • 生成 .env 和 installed.lock 文件

   Step 5 — 完成

   • 显示安装报告，提供后台入口

第五步：安装后安全检查

1. 删除安装文件： 宝塔 → 文件 → 找到 install.php → 右键删除
2. 设置目录权限：

# SSH 终端执行
chmod -R 755 /www/wwwroot/你的域名
chown -R www:www /www/wwwroot/你的域名
chmod 777 /www/wwwroot/你的域名/uploads
chmod 777 /www/wwwroot/你的域名/logs
chmod 777 /www/wwwroot/你的域名/runtime