## Laravel 12 安装流程

### 一、创建项目
```bash
composer create-project laravel/laravel engine-api "^12.0"
```

### 二、配置数据库
```bash
# 1. 创建数据库（手动执行SQL）
CREATE DATABASE engine_api CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

# 2. 修改 .env 文件
DB_CONNECTION=mysql
DB_DATABASE=engine_api
```

### 三、生成应用密钥
```bash
php artisan key:generate
```

### 四、运行迁移
```bash
php artisan migrate
```

### 五、（可选）安装 Octane
```bash
composer require laravel/octane
php artisan octane:install --server=swoole
```

---

### 遇到的问题及解决方案

| 问题 | 原因 | 解决方案 |
|------|------|---------|
| Composer 下载超时 | 网络问题 | `set COMPOSER_PROCESS_TIMEOUT=3600 && composer install` |
| `laravel/pint` 下载失败 | GitHub 匿名请求限制 | `composer install --no-dev` 跳过 |
| `MissingAppKeyException` | 未生成密钥 | `php artisan key:generate` |
| `Unknown database` | 数据库不存在 | 手动创建数据库 |
| `Table 'xxx.sessions' doesn't exist` | 未运行迁移 | `php artisan migrate` |

---