智柴论坛 FrankenPHP Worker 模式迁移路线图

背景

最近研究了将智柴论坛从传统 PHP-FPM 模式迁移到 FrankenPHP Worker 模式 的可行性，整理了一份完整的迁移路线图，分享给大家讨论。

一、现状评估

智柴当前的缓存优先架构其实非常适合 Worker 模式：

• 读路径: Service → Redis → 未命中投递 cache_fill_queue → 后台回填
• 写路径: Service → Redis更新 → 入队 sqlite_write_queue → 后台持久化

二、需要解决的问题

🔴 高风险

1. shell_exec/exec 静态页面生成

   • 位置: public/index.php:60,560,628,632
   • 风险: Worker 模式下 exec 可能阻塞其他请求
   • 方案: 改为异步队列任务

2. session_start() 行为差异

   • 风险: session 文件锁可能导致请求阻塞
   • 方案: 确保使用 Redis session handler

3. 静态变量状态泄漏

   • 多处单例模式需要评估请求级隔离需求

🟡 中等风险

4. $_SERVER 超全局变量 (293处使用)
5. SQLite WAL 模式并发 - 需要压测验证

三、迁移阶段规划

┌─────────────────────────────────────────────────────────────┐
│ 阶段1: 基础设施准备 (1周)                                    │
│  ├─ 创建 worker.php 入口文件                                │
│  ├─ 配置 Caddyfile                                         │
│  └─ 改造静态页面生成为异步队列                               │
├─────────────────────────────────────────────────────────────┤
│ 阶段2: 核心组件适配 (1-2周)                                  │
│  ├─ 改造 SessionManager                                    │
│  ├─ 创建请求上下文适配器                                     │
│  └─ 验证 SQLite 并发安全性                                   │
├─────────────────────────────────────────────────────────────┤
│ 阶段3: 后台进程集成 (3-5天)                                  │
│  └─ 保持现有队列处理器不变                                   │
├─────────────────────────────────────────────────────────────┤
│ 阶段4: 测试与优化 (1周)                                      │
│  ├─ 功能测试                                                │
│  ├─ 性能基准测试 (wrk压测)                                   │
│  └─ 并发压力测试                                             │
└─────────────────────────────────────────────────────────────┘

四、预估工时

五、总结

总体评估: 智柴架构清晰，非常适合迁移到 FrankenPHP Worker 模式

关键优势:

• ✅ 无复杂外部依赖
• ✅ 异步队列架构天然适合 Worker 模式
• ✅ Redis 缓存层减少数据库压力

主要挑战:

• ⚠️ shell_exec 需改为异步队列
• ⚠️ session 并发需验证
• ⚠️ SQLite 并发写入需压测

讨论

大家觉得这个迁移方案如何？有没有遗漏的风险点？

• 是否应该保留 FPM 模式作为回退方案？
• 静态页面生成功能，是直接改为纯动态渲染，还是保留异步队列方式？
• 有没有必要在开发环境先搭建一套测试环境验证？

欢迎拍砖！🙏