本文由 FlintHub 开发文档归档发布。原始文档日期见标题前缀，来源：暂存20260913/开发各阶段.md。

SoSite → FlintHub 开发各阶段

生成日期：2026-09-01（2026-09-01 修订：老版sosite 归位到 sosite网站程序 之后；移除与项目无关的 xiunox 相关描述）

依据：对 D:\phpstudy_pro 目录下全部历史文件夹的只读分析（版本号、目录结构、说明文档、修改时间）

性质：纯分析文档。仅整理信息，未对任何文件做增删改。

〇、总览：一条主线，三个阶段

D:\phpstudy_pro 下 46 个文件夹记录了你从 单用户博客 → SoForum/SoSite 自研论坛 → FlintHub 重构 的完整开发历程。核心演进链：

2026-03  独立博客/SoForum 雏形（WWW2 / WWW23 / WWW4）
   ↓
2026-06  SoSite V2.x 自研论坛（SQLite/MySQL 双引擎）
   ↓
2026-07  SoSite V3.8 → V4.0.0（Session 入库/插件系统）
   ↓
2026-08  FlintHub 全新架构（SplitDB 分片存储）V1.0.31 → V1.0.68（当前）

一、阶段 ①：早期探索（2026-03）——独立博客与论坛雏形

1.1 WWW2（2026-03-14）——PHP+SQLite3 单用户博客系统 v1.0.0

• readme.md 完整描述了"单用户博客系统"：文章发布/分类/标签/置顶/附件、评论点赞、双模板主题（默认浅蓝/橙色）、自研可视化编辑器、后台全管理、PDO 防注入、CSRF、database/blog.db。
• 意义：最早期独立项目，确立 PHP+SQLite3+PDO 技术栈与后台管理雏形，是 SoSite 的前身实验。

1.2 WWW23 / WWW4（2026-03-17）——SoForum 精品论坛雏形

• config.php 显示 DEFAULT_SITE_NAME = 'SoForum 精品论坛'、DB_PATH = forum.db，并支持 DB_TYPE = sqlite/mysql 双引擎切换（WWW23 含完整 MySQL 配置段）。
• 意义：从博客转向论坛的第一个形态，"SoForum" 即 SoSite 早期命名；SQLite/MySQL 双引擎设计延续到后续所有版本。

1.3 WWW1（2026-03-17）——Flarum 研究 + 上传网站

• 内含 flarum 目录与"上传网站"：对 Flarum 论坛的调研参考（未自研，仅借鉴思路）。

1.4 备份（2026-03-14）——早期杂物备份

• 子目录 cms / tj / tools / wangpan：早期工具与项目零散备份。

小结：3 月完成"博客 → 论坛雏形"的跨越，确立 SoForum（SoSite 前身）品牌与 SQLite/MySQL 双引擎路线。

二、阶段 ②：SoSite 自研论坛（2026-06 ~ 07）——V2.0.0 → V4.0.0

2.1 sosite网站程序（2026-06-03）——SoSite 早期源码

• config.php 含 DB_PATH = forum.db + 上传常量；带 install2.php 及备份。
• 与 WWW23/WWW4 一脉相承，是 SoForum → SoSite 正式更名后的早期主开发目录。

2.2 老版sosite（2026-07-05）——老版本存档

• config.php：DB_PATH = protected/forum.db（已迁移到 protected/）；带特征性安装文件 install121123213123123123.php（防猜测安装脚本名）。
• 意义：与 sosite网站程序 同源的老版本存档，紧接早期源码之后。

2.3 修复后的代码（2026-06-06）——修复版快照

• 含 config.php，属于 SoSite 修复迭代中的一个中间快照（具体修复点见后续 20260613 备份）。

2.4 code_backup_20260613（2026-06-13）——修复前代码备份

• 大量 .bak 文件：admin_.php.bak、blog_.php.bak、thread.php.bak、post.php.bak、profile.php.bak 等 + 修复报告.md。
• 意义：SoSite V2.x 一次大规模修复（后台/博客/搜索/认证等模块）前的备份，配合 最新版的sosite（V2.0.0 修复文档）使用。

2.5 最新版的sosite（2026-06-15）——SoSite V2.0.0 修复版

• CHANGELOG.md 标题 "SoSite V2.0.0 修复技术文档"（2026-04-28）：修复事务方法名（begin() 而非 beginTransaction）、MySQL 备份密码泄露（mysqldump → PHP 实现）、LIKE 通配符转义、安全响应头、protected/ 目录替代可下载的 backups/、静态缓存刷新、Session 浏览记录上限等。
• 意义：SoSite V2.0.0 的正式修复里程碑，修复点与后来 FlintHub 规范中的红线高度呼应（事务/安全头/目录防护）。

2.6 重构后最新版（2026-06-16）——SoSite V2.2.0 重构版

• config.php 版本号 SOSITE_VERSION = 'V2.2.0'，含 README.md、install.php。
• 意义：V2.0.0 修复之后的重构快照，版本号正式引入。

2.7 安装转换文件（2026-06-16）——数据转换工具

• dbconvert.php（数据库转换）+ install.php：SoSite 安装/迁移辅助脚本。

2.8 WWW626（2026-06-26）——SoSite V3.5 打包

• 内含 sositeV3.5.zip：V3.5 版本打包文件（说明 V2.2.0 之后又推进到 V3.5）。

2.9 备忘md（2026-06-28）——SoSite V3 开发规划与全记录

• 关键文档：SOSITE_V3_功能开发计划.md、SOSITE_开发全记录.md、_SOSITE_DOCUMENTATION.md、xenforo-analysis.md、code-review-todo.md、审计报告等。
• 意义：SoSite V3 功能规划 + 全程开发记录 + 代码/安全审计文档，是理解开发思路的核心资料。

2.10 存档20260629（2026-06-29）——阶段存档

• README.md + web.config/web2.config：V3 规划期的存档点。

2.11 新版sosite20260701（2026-07-01）——SoSite V2.2.0 新版

• config.php：SOSITE_VERSION = 'V2.2.0'，含 install.php。
• 注意：命名"新版"但版本仍标 V2.2.0（与重构后最新版同版本号，是并行分支或回归存档）。

2.12 网站原版（2026-07-08）——SoSite V3.8.0 原版

• config.php：SOSITE_VERSION = 'V3.8.0' + MAIL_FROM_NAME = 'SoSite 论坛'。
• 意义：V3.8 正式版，SoSite 主线的较高版本。

2.13 7月5日复制的资料（2026-07-05）——SoSite V4.0.0 文档

• README 标题 "SoSite V4.0.0 — 轻量级 PHP 论坛系统"（文档 2026-07-03 更新）：
• 定位：轻量/高性能/易扩展的 PHP 论坛+博客系统，PHP 7.4+ / MySQL 5.7+；
• V4.0 新增：migration_optimize.php（online_users 主键）、migration_sessions.php（Session 文件 → MySQL）、插件系统（plug/ 在线插件生成器）。

2.14 WWW7512（2026-07-05）——SoSite V4.0.0 主目录

• config.php：SOSITE_VERSION = 'V4.0.0'。
• 意义：SoSite 自研路线的最高版本主目录。

2.15 8月13日备份（2026-08-13）——SoSite 交接 + CSS 清理

• 一系列交接文档：SoSite-CSS清理交接说明-2026-08-12.md、SoSite-会话交接说明-2026-08-08/09/10/12.md、说明.md。
• 意义：SoSite 向 FlintHub 切换前的最后交接（CSS 清理、会话体系整理）。

小结：6~7 月 SoSite 完成 V2.0.0 修复 → V2.2.0 重构 → V3.5/V3.8 迭代 → V4.0.0 大版本（Session 入库、插件系统、迁移脚本），并留存大量交接/审计文档。

三、阶段 ③：FlintHub 重构（2026-08 ~ 今）——SplitDB 全新架构

背景：8 月中旬起基于 SoSite 经验，重构为 FlintHub：SplitDB 分片存储、插件体系、独立规范（见 插件开发规范.md）。

3.1 8月16日备份（2026-08-16）——FlintHub 1.0.0 起点

• 内含 FlintHub1.0.0：重构起点快照。

3.2 flinthub1.0.0（2026-08-23）——FlintHub V1.0.31

• version.php：FLINTHUB_VERSION = 'V1.0.31'；含 安装包目录结构与文件说明.md、说明文档.md。
• 意义：FlintHub 独立品牌确立（V1.0.31），架构已含 SplitDB。

3.3 WWW（2026-08-31，当前工作目录）——FlintHub V1.0.68

• version.php：FLINTHUB_VERSION = 'V1.0.68'；含 说明.md、plugins/、SplitDB 体系、插件规范文档。
• 意义：当前主开发目录（本次分析即基于它进行）。

3.4 36万数据（2026-08-28）——大数据迁移

• 内含 data/：36 万条数据（论坛/博客数据迁移用，对应 SplitDB 大数据量验证场景）。

3.5 20260827（2026-08-27）——近期备份

• 当前为空/整理中目录（备份占位）。

小结：8 月完成从 SoSite 到 FlintHub 的重构，V1.0.31 → V1.0.68 快速迭代至今，SplitDB 分片 + 插件生态成型。

四、旁支研究与工具项目（全程穿插）

五、非项目文件夹（环境，勿动）

六、时间线总表（文件夹修改时间排序）

七、版本演进图谱

单用户博客 v1.0 ──→ SoForum 雏形 ──→ SoSite V2.0.0(修复) ──→ V2.2.0(重构)
      (2026-03)         (2026-03)        (2026-06-15)          (2026-06-16)
                                                                      │
                        ┌─────────────────────────────────────────────┘
                        ▼
              SoSite V3.5 ──→ V3.8.0 ──→ V4.0.0（Session 入库/插件系统）
              (06-26)        (07-08)       (07-05 WWW7512)
                        │
                        └──→ FlintHub V1.0.31 ──→ V1.0.68（SplitDB 重构，08~今，当前）

核心结论：你的开发路线 = 博客 → SoForum/SoSite 自研（V2→V4）→ FlintHub 重构（SplitDB）。所有历史版本、交接文档、审计报告均完整保留在 D:\phpstudy_pro 下，可随时回溯任一阶段。xiunox/xiunox-V1.1.8/8月12日的备份 为外部程序归档，与本人开发路线无关。