反馈修复 [已修复] 改动说明 — PHP 8.4 / 8.5 兼容性修复-1.0.3

一、变更文件清单

合计：7 个文件（1 新增 + 6 修改）、11 个代码位置。全部为「删除一个调用」或「补一个字符」级别，无逻辑重构。

二、逐项改动说明

1. H-2 app/init.php + app/Core/SessionHandler.php — 最严重项（每请求 1 条）

PHP 8.4 起弃用：session_set_save_handler() 若传入「独立回调」，必须改为传入一个 实现 SessionHandlerInterface 的对象。

线上实际报错（手机服务器）：

Deprecated: session_set_save_handler(): Providing individual callbacks instead of
an object implementing SessionHandlerInterface is deprecated
in .../flinthub/app/init.php on line 41

改动：原 app/init.php:41 的 6 个闭包（open/close/read/write/destroy/gc） 整体迁入新增的 app/Core/SessionHandler.php，入口改为：

session_set_save_handler(new \app\Core\SessionHandler());

★ 关键设计决策（防行为漂移，请勿"优化"）：

1. 刻意【不】实现 SessionUpdateTimestampHandlerInterface（validateId / updateTimestamp）。 原写法只传了 6 个回调、未提供第 7/8 个；PHP 在 session.use_strict_mode=1（本项目默认开启） 下走的是「read() 返回空串即判定为新 ID」的默认路径。补上 validateId 会改变会话固定 攻击防护的判定路径，属隐性行为变更，故明确不补。
2. 失败返回值与原实现逐一对齐：read → ''、write → false、destroy → false、gc → 0。
3. TTL 保持 1800 秒（expires = time() + 1800），与原闭包完全一致。
4. 沿用 Database::getSessionConnection()（独立 PDO 连接，与业务连接物理隔离）， 避免 SplitDB 的 2014 游标冲突。

兼容性：sessions 表结构与数据格式未变，新旧实现可互相读取已存会话， 故本次改动不会导致任何在线用户掉线，回滚也不会。

2. M-4 app/SplitDB/ViewCounter.php — 每请求 2 条（8.4 与 8.5 都触发）

PHP 8.4 起弃用：参数类型前缺 ? 的「隐式可空」写法。

// 改前
public static function inc(int $topicId, PDO $mainDb = null): void
public static function flush(PDO $mainDb = null): int

// 改后
public static function inc(int $topicId, ?PDO $mainDb = null): void
public static function flush(?PDO $mainDb = null): int

为什么它很严重：index.php:280 注册的 register_shutdown_function 会无条件调用 ViewCounter::flush()（index.php:285），因此类文件 ViewCounter.php 每次请求都会被编译， 两个隐式可空参数就在编译期各发一条告警 → 每请求固定 2 条， 与是否启用 APCu、是否浏览主题都无关。

佐证：两处 docblock 早已写明 @param PDO|null $mainDb，即意图本就是可空， 只是语法漏了 ?。属纯补全，零行为变更。

3. H-1 app/Helpers/CoverTemplate.php:155 — 中文标题必刷屏（仅 8.5）

PHP 8.5 起弃用：ord() 传入非单字节字符串。

// 改前
private static function charUnits(string $ch): float
{
    $o = \ord($ch);          // ← 中文"中"是 3 字节，此处收到多字节字符串
    if ($o < 0x80) { ... }
    return 1.0;
}

// 改后（新增前置判断）
private static function charUnits(string $ch): float
{
    if (\strlen($ch) > 1) {
        return 1.0;          // 多字节字符原本就走下面 return 1.0 分支
    }
    $o = \ord($ch);
    if ($o < 0x80) { ... }
    return 1.0;
}

触发条件：入参来自 preg_split('//u', $title, ...)（CoverTemplate.php:118）， 即按 UTF-8 字符切分；中文/全角是 2–4 字节。任何含中文的标题在生成封面时都会触发。

零行为变更证明：\strlen($ch) === 1 时 ord() 必为单字节；多字节分支原本也返回 1.0。 实测 30 个 SVG（5 类标题 × 6 模板）改动前后逐字节一致（内容哈希 5b377287a9121a0687be01a0546b61e6d7d9ff99db4d1393955dcb87d92b2772）。

4. M-1 / M-2 / M-3 — 清理 8.5 弃用函数调用（共 7 处）

PHP 8.5 起弃用，且三者自 PHP 8.0 起均已无实际作用（对象自动释放），故直接删除：

删除安全性：这些都是「释放资源」的显式调用，PHP 8.0 起底层改为对象引用计数自动释放， 调用本身已成为 no-op。删除后功能实测全部正常（见 §4）。

三、部署步骤

1. 备份（建议）：备份 app/init.php、app/SplitDB/ViewCounter.php、 app/Helpers/CoverTemplate.php、app/Helpers/Plugin.php、app/Helpers/Upload.php、 app/Controllers/ApiController.php（6 个将被覆盖的文件）。
2. 上传覆盖：把本包内 app/ 目录按原结构覆盖到站点根目录的 app/。
3. ★ 确认新增文件已上传：app/Core/SessionHandler.php —— 这是本包唯一的新增文件，遗漏会导致站点致命错误（类不存在）。
4. 更新版本号：用本包 version.php 覆盖站点根目录的 version.php（→ V1.0.3）。
5. 清缓存：
   • 浏览器强刷（Ctrl+F5 / 手机端清站点数据）以刷新 sw.js 缓存；
   • 若站点启用了 OPcache，重启 PHP 或等待 OPcache 过期（opcache.revalidate_freq）。

     本包不含 CSS/JS 改动，sw.js 的 CACHE_VERSION 无需递增。

6. 无需：无需重启任何进程（本环境无常驻 worker）、无需改配置、无需执行迁移脚本、 无需访问任何升级 URL。

四、验证结果（真机实测，非静态分析）

验证环境：PHP 官方便携版 8.4.25 与 8.5.10（Windows NTS x64， 已启用 pdo_sqlite / sqlite3 / mbstring / fileinfo / openssl / curl / gd）。

4.1 全库编译期扫描（568 个 PHP 文件）

方法：对全库每个文件跑 php -l。隐式可空参数等弃用在编译期触发，php -l 会直接报出， 比正则扫描权威。

4.2 站点路由冒烟（19 条路由）

• 首页字节数：两版本均为 63,863 字节，与修复前完全一致。
• protected/error.log 在冒烟后为空 —— 修复前同样 19 条路由会产生 42 行告警。

4.3 逐项告警实测

4.4 功能回归（确认删除调用未破坏功能）

4.5 语法检查

7 个文件在 PHP 8.0.2 / 8.4.25 / 8.5.10 三个版本下 php -l 均无语法错误、无弃用告警。

五、回滚方案

回滚安全性：本包全部改动都是「消除告警」性质，不涉及业务逻辑、SQL、模板与静态资源， 回滚后行为与升级前完全一致。

六、附：为什么这些改动是安全的

1. 零行为变更：H-1 与 M-4 属「语法补全」，输出已用哈希证明逐字节一致； M-1/M-2/M-3 删的是自 PHP 8.0 起就无效的 no-op 调用。
2. H-2 是唯一的结构性改动，但已刻意保持 6 个方法与返回值语义 1:1 对齐， 且不补 validateId/updateTimestamp 以维持原 use_strict_mode 行为。
3. 不涉及数据库结构、索引、配置项、CSS/JS、插件文件。
4. 已在 PHP 8.0.2 / 8.4.25 / 8.5.10 三个版本上验证，覆盖项目声明的最低版本与目标版本。