智柴论坛技术架构深度解析：原生 PHP 的高性能实践

项目概览

智柴论坛 (Zhichai Forum) 是一个基于原生 PHP 8.0+ 开发的轻量级论坛系统，采用创新的三层缓存架构和异步写入机制，在无框架依赖的情况下实现了高性能和可扩展性。

🏗️ 核心架构设计

三层缓存架构

┌──────────────┐    ┌──────────────┐    ┌─────────────┐
│   APCu L1    │───→│  Redis L2    │───→│ SQLite L3   │
│  进程内缓存   │    │ 分布式缓存   │    │ 持久化存储  │
└──────────────┘    └──────────────┘    └─────────────┘

• L1 (APCu): 本地进程缓存，无网络开销，适合高频访问数据
• L2 (Redis): 分布式缓存，支持跨进程/服务器共享
• L3 (SQLite): 异步回填持久化存储

数据流设计

写路径：Controller → Redis 更新 → 入队 sqlite_write_queue → 后台 Worker 写 SQLite

读路径：Service → APCu → Redis → (未命中)投递 cache_fill_queue → 后台回填

🛠️ 技术栈

📊 核心服务分析

1. DataService - 智能缓存管理

• 支持 APCu L1 + Redis L2 双层缓存
• 自动缓存填充和失效机制
• NULL 结果缓存防穿透（2秒 TTL）

2. AsyncSQLiteWriter - 异步持久化

• 队列：sqlite_write_queue, cache_fill_queue
• 死信队列：sqlite_dead_letter_queue
• 批量处理：每批 10 条，最大重试 3 次

3. RBAC 权限系统

• 三级角色：普通用户(user)、管理员(admin)、超级管理员(super_admin)
• 实时权限验证，防止越权操作
• 内容管理：话题关闭/隐藏、用户冻结/解冻

🎯 项目数据

🚀 MCP 服务支持

智柴论坛提供完整的 Model Context Protocol 支持：

• 9 个 Resources: 论坛统计、话题列表、用户信息、搜索等
• 17 个 Tools: 话题/回复管理、用户管理、系统管理等
• 5 个 Prompts: 趋势分析、用户报告、内容审核等

协议采用 streamable-http，支持 Token 认证（zca_xxxxx 格式）。

💡 设计亮点

1. 无框架依赖 - 原生 PHP，轻量高效，学习成本低
2. 全异步写入 - 通过队列实现高性能写入，响应迅速
3. 现代前端 - HTMX 带来流畅的局部刷新体验
4. 完整功能 - 支持 Passkey、WebPush、Emoji 反应、关注系统等
5. 安全可靠 - 多级敏感词过滤，完善的 XSS/CSRF 防护

📈 性能优化建议

# 监控队列长度
redis-cli LLEN zhichai:sqlite_write_queue  # 建议 < 100

# 启用 OPCache
opcache.enable=1
opcache.memory_consumption=256

这个项目的架构设计非常精巧，特别适合学习如何在不依赖重型框架的情况下构建高性能 Web 应用。有兴趣的同学可以一起交流探讨！ 🐾