feat: 新增 Docker 部署支持、Swoole/Octane 集成及相关优化

- 添加 Dockerfile 与多套 docker-compose 配置(开发/生产环境)
- 集成 Laravel Octane (Swoole) 提升性能
- 新增健康检查、监控脚本及部署文档
- 新增 Docker 镜像离线导入包(MySQL/Redis/Meilisearch)
- 优化文档转换、预览服务及队列任务
- 添加 CreateAdminUser 命令与路由健康检查接口
- 新增 Swoole 队列兼容性测试套件

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-02-28 15:51:19 +08:00
parent acf549c43c
commit 3c206e9e06
90 changed files with 12731 additions and 1255 deletions

108
docs/OCTANE_INSTALLATION.md Normal file
View File

@@ -0,0 +1,108 @@
# Laravel Octane 安装文档
## 概述
本文档记录了在知识库系统中安装和配置 Laravel Octane 的过程。Laravel Octane 通过 Swoole 提供高性能的 PHP 应用服务器。
## 安装步骤
### 1. 安装 Laravel Octane 包
```bash
composer require laravel/octane
```
### 2. 发布配置文件
```bash
php artisan octane:install --server=swoole
```
### 3. 环境变量配置
`.env` 文件中添加以下 Swoole 相关配置:
```bash
# Octane/Swoole 配置
OCTANE_SERVER=swoole
OCTANE_HOST=0.0.0.0
OCTANE_PORT=8000
OCTANE_WORKERS=4
OCTANE_TASK_WORKERS=2
OCTANE_MAX_REQUESTS=500
OCTANE_WATCH=false
```
### 4. 配置文件更新
- `config/octane.php`: 默认服务器设置为 `swoole`
- `composer.json`: 添加了 `dev-octane` 脚本支持
## 验证安装
### 检查配置
```bash
php artisan config:show octane.server
```
应该显示: `swoole`
### 检查命令可用性
```bash
php artisan octane:status
```
应该显示: `Octane server is not running.`
### 运行测试
```bash
php artisan test tests/Feature/OctaneInstallationTest.php
```
## 使用方法
### 启动 Octane 服务器
```bash
php artisan octane:start
```
### 带监听文件变化启动
```bash
php artisan octane:start --watch
```
### 使用 Composer 脚本启动开发环境
```bash
composer run dev-octane
```
### 停止服务器
```bash
php artisan octane:stop
```
### 重启服务器
```bash
php artisan octane:restart
```
## 注意事项
1. **Swoole 扩展**: 在生产环境中需要安装 Swoole PHP 扩展
2. **内存驻留**: 应用会保持在内存中,需要注意内存泄漏
3. **全局变量**: 避免使用全局变量和静态变量
4. **配置缓存**: 建议在生产环境中使用配置缓存
## 下一步
- 更新 Docker 配置以支持 Swoole
- 配置生产环境部署脚本
- 进行性能测试和优化