# 部署指南

## 宝塔面板部署

### 1. 环境准备

在宝塔面板"软件商店"中安装：
- Nginx 1.22+
- PHP 8.0（在 PHP 设置中确保以下扩展已启用：pdo_mysql、curl、mbstring、json、openssl）
- MySQL 5.7 或 8.0

### 2. 创建网站

1. 网站 → 添加站点
2. 填写域名
3. PHP 版本选择 **PHP 8.0**
4. 数据库选择"不创建"（安装向导会连接你手动创建的数据库）

### 3. 部署代码

```bash
cd /www/wwwroot/your-domain.com
git clone <repository-url> .
composer install
```

### 4. 设置权限

```bash
chmod -R 755 .
chown -R www:www .
```

### 5. 配置伪静态

1. 站点设置 → 网站目录 → 运行目录改为 `/public`
2. 站点设置 → **伪静态** → 将 `docs/baota-nginx-snippet.conf` 的内容粘贴进去，保存

> 注意：是粘贴到"伪静态"输入框，不是"配置文件"。
> 如 PHP 版本不是 8.0，需将 `php-cgi-80` 改为对应版本号（如 `php-cgi-81`）。

### 6. 创建数据库

安装向导不会自动创建数据库，需要你提前手动创建：

1. 宝塔面板 → 数据库 → 添加数据库
2. 记录数据库名、用户名和密码，安装向导中需要填写

### 7. 运行安装向导

访问 `http://your-domain.com/install.php`，按步骤完成安装。

### 8. SSL 配置（可选）

站点设置 → SSL → Let's Encrypt → 申请证书

---

## 手动部署（Nginx + PHP-FPM）

### 1. 安装依赖

```bash
composer install
```

### 2. Nginx 站点配置

使用 `docs/nginx.conf` 作为完整的站点配置文件：

```bash
# 复制到 Nginx 配置目录
cp docs/nginx.conf /etc/nginx/sites-available/ai-chat
ln -s /etc/nginx/sites-available/ai-chat /etc/nginx/sites-enabled/

# 编辑配置，修改 server_name 和 root 路径
vim /etc/nginx/sites-available/ai-chat

# 测试并重载
nginx -t && nginx -s reload
```

### 3. 创建数据库

```sql
CREATE DATABASE ai_chat DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'ai_chat'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON ai_chat.* TO 'ai_chat'@'localhost';
FLUSH PRIVILEGES;
```

### 4. 目录权限

```bash
chown -R www-data:www-data /path/to/ai-chat
chmod 755 /path/to/ai-chat/public/uploads
chmod 755 /path/to/ai-chat/config
```

### 5. 运行安装向导

访问 `http://your-domain.com/install.php`

---

## 本地开发（PHP 内置服务器）

```bash
php -S localhost:8080 -t public/ public/router.php
```

> 必须使用 `public/router.php` 作为路由文件，否则 `/api/*` 请求无法正确路由到 `api.php`。

---

## 安全建议

1. 配置 SSL 证书（HTTPS）
2. 修改数据库默认端口
3. 定期更新 PHP 和 Nginx 版本
4. 限制 uploads 目录的执行权限
5. 禁止访问 app/、config/、vendor/ 等非公开目录（已在 Nginx 配置中设置）