FengCMS · PHP+MySQL 升级实录 ·三重 MD5 迁移 password_hash:老站密码怎么无痛升级

关于 FengCMS :一个 2013 年开源的 PHP + MySQL 内容管理系统,曾被上万家网站使用,至今仍有网站在线运行;2026 年 10 月完成安全现代化升级,本文回顾的版本为 v1.37。开源仓库:github.com/fengcms/fengcms

各位看官,如果一个系统里躺着上万个用户的口令哈希,存储算法是三重 MD5,你会怎么升级?

写脚本批量洗库?洗完所有用户原地锁死------因为密码是用户自己设的,你推不回 bcrypt。写个强制重置?运营成本和用户投诉会把你埋了。

这就是老站密码迁移最尴尬的地方:它不是一个算法问题,是一个只能"原地升级"的流程问题 。我给 FengCMS 做的方案就一句话:用户无感,登录即迁移。这篇把整个设计、配套的三个改动和两个回退的坑讲清楚。

顺带交代下这事的优先级:在整改任务书里,口令和会话、CSRF 一起被划进 P0 范围 ------原文的判断标准是"可直接造成管理端接管、绕过保护机制或污染写入路径"。管理端口令一旦被破,丢的不是一个账号,是整站。所以这篇虽是"老技术",却是整个安全升级里最先动手的一批。

本文要点

  • 三重 MD5 为什么必须换,为什么又不能一键换
  • "登录即迁移"方案的实现细节与兼容层
  • 列扩容、改密踢会话这些不起眼但必须动的配套
  • 回退为什么必须"代码 + 数据一致快照",只回滚 PHP 文件会怎样

一、旧方案长什么样

先看原罪。审计时在 system/common/security.php 定位到旧校验逻辑,形态是教科书级的反面案例:

php 复制代码
// 2013 年的旧口令校验(示意,已修复)
// 三重裸 MD5,盐值固定甚至没有,32 位固定长度
$hash = md5(md5(md5($password)));
// 数据库里存的就是这样一串 32 位十六进制

问题不用我多解释,Go 和 Node 的看官都熟:MD5 早就被碰库打穿,三重套娃不改变它是 MD5 的事实,固定盐被全站复用,无法像每条口令独立随机盐那样隔离预计算攻击;更核心的问题是 MD5 计算太快,不适合抵抗离线口令猜测。更糟的是字段设计:32 位定长,存不下任何现代算法的输出。

但有一说一,2013 年的语境里,这不算丧心病狂------那会儿 PHP 社区标配就这水平。我们今天批判老代码时得记住:它是那个年代的正常代码,只是年代变了。

二、最大的难题:为什么不能批量洗库

拿到手第一反应肯定是:写个脚本,把所有 md5(md5(md5())) 批量转成 password_hash()。

对着代码想三秒就知道不行------哈希是单向的。bcrypt 要拿明文算,而明文只在用户脑子里。你只有两条路:

  1. 用某种方式推算明文 → 推不出,三重 MD5 虽破但也是单向;
  2. 全员强制重置密码 → 用户被锁、客服被淹,等于用一次事故去修一个隐患。

所以结论只剩一条:迁移必须发生在"明文恰好出现的那一刻"------用户登录的瞬间。

三、登录即迁移:用户无感的原地升级

方案的核心是一段登录流程改造(示意,非仓库原码):

php 复制代码
// 登录成功后的原地迁移(示意)
$stored = load_password_hash($userId);

if (is_legacy_triple_md5($stored)) {
    // 旧格式:先用旧算法验证
    if (legacy_verify($password, $stored)) {
        // 验证通过,立刻用明文重算现代哈希,写回同一行
        $newHash = password_hash($password, PASSWORD_DEFAULT);
        update_password($userId, $newHash);
        // 下次登录就走新算法了,用户全程无感
    }
} elseif (password_verify($password, $stored)) {
    // 新格式:标准验证;顺手检查是否需要 rehash(算法参数升级)
    if (password_needs_rehash($stored, PASSWORD_DEFAULT)) {
        update_password($userId, password_hash($password, PASSWORD_DEFAULT));
    }
}

三个细节决定了这方案靠不靠谱:

1. 兼容层必须双轨并存。 登录路径同时认识新旧两种格式,靠格式识别分流(旧哈希固定 32 位,新哈希带 $2y$ 这类算法前缀,一眼可辨)。兼容层还有一处更隐蔽的坑:旧版对某些特殊字符有历史编码处理,得让新校验认得老编码的输入,否则一批老用户的密码会"突然不对"------这种 bug 出现时用户只会做一件事:认为系统坏了。

2. 迁移要配 password_needs_rehash。 今天写入的是当时的默认算法参数,明天 PHP 社区调了 bcrypt 成本参数怎么办?needs_rehash 让每次登录都是一次免费的"算法体检",参数落后就原地升级------迁移不是一次性的,是常驻的。

3. 数据库列必须先扩容。 bcrypt 输出 60 字符起,后续算法更长,旧列装不下。配套动作用迁移工具完成,实际执行就是一条命令:

bash 复制代码
# 预发布环境执行,DB_* 环境变量指向站点副本库
php tools/migrate.php

它干的是一组活:扩展管理员密码列到 255 字符、创建登录限流表、迁移固定角色字段,顺带只替换完全未修改的 旧版示例页脚许可文字------自定义站点的版权一个字不动。注意文档特意叮嘱的两条:用站点副本库跑,不要运行开发 bootstrap------迁移工具是给存量站的,跑错库就是生产事故。

顺带说下这个方案上线后的运维观测点:库里 32 位旧哈希的账号数只能降不能升。哪天它涨了,要么有旧版代码还在线上跑,要么有人绕过迁移逻辑直接写库------这个数字本身就是一根报警线。

至于代价,用户首次成功登录会多计算一次现代密码哈希并写回数据库,实际耗时取决于算法参数和服务器性能,需要在部署副本测量。用户不必主动重设密码,但不能据此承诺没有可感知延迟。

把登录路径拆成四种结果,再看迁移有没有漏口

从原来的双轨逻辑往下展开,至少有四种值得分别观察的状态:旧哈希加正确密码、旧哈希加错误密码、新哈希加正确密码,以及新哈希需要更新参数。它们不应共用一个模糊的"登录接口能打开"结论。

输入与存储状态 应观察的关键结果
旧格式,密码正确 完成验证后只更新当前账号,下次走新格式校验
旧格式,密码错误 拒绝认证,哈希和其他账号不应被改写
新格式,密码正确 正常认证;不需要 rehash 时避免无意义写回
新格式,需要 rehash 使用本次已验证的口令重新计算,并检查写入结果

尤其别漏掉写回失败。哈希已经在内存里算出来,不代表数据库已保存;如果没有检查持久化结果,下一次登录可能仍走旧分支。具体失败后是否允许建立会话,应按项目认证策略实现并测试,不能从这段教学示意代码推断已经具备完整处理。

四、顺手必须改的三件配套

密码方案不是孤立的,这三件事不做,方案就是漏的:

  • 改密只改当前账号 。旧实现改密码存在"全表更新"的历史行为------改一个人的密码会波及其他账号。这次明确收敛为只动当前行。看到这种历史行为时我后背一凉:上一个使用者当年是怎么活下来的?
  • 改密码踢掉其他会话。否则改密这个补救动作本身是无效的------偷了会话的人还挂着。新逻辑:账号改密,其他会话立即失效,配合 60 分钟闲置 / 12 小时绝对时限一起生效;
  • 验证跟上 。69 项 HTTP/数据库回归里,"登录、密码迁移与账号隔离 、CSRF"是同一批跑的------迁移逻辑不能只靠手测点一遍登录。其中"账号隔离"这条就是针对全表更新 bug 的直接回归:把 A 的密码改掉,B 的登录必须纹丝不动------一条断言,钉死一类历史事故。

五、两个回退的坑,都是要命的

这是全篇我最想敲黑板的部分,原文档写得非常硬:

旧程序不能识别新密码哈希,回退必须考虑代码与数据库的一致快照以及切换后的新增数据,不能仅回滚 PHP 文件。

翻译成人话:一旦有用户登录过、哈希被原地升级成 bcrypt,你把 PHP 代码回滚到旧版------旧代码见到一串带 $2y$ 的新哈希,直接判登录失败 。回滚代码 = 把这批用户全部锁死。所以回退预案必须是"代码 + 数据的成对快照",而且要算上切换窗口内的新增数据。数据格式变了,回滚就不再是"覆盖几个文件"的事------这道理后端都懂,但在"顺手回滚一下"的压力面前,先立字据比什么都重要。

第二个坑是部署纪律,原文的大意是:

部署时应在站点数据库副本上识别仍使用 32 位旧哈希的账号,安排超级管理员对长期未登录账号重置密码;当前开发库没有旧哈希账号,不代表其他站点也没有。

后面这句是全文我最喜欢的诚实声明。自己测干净了,不等于上万个存量站也干净------每个站在自己的数据副本上验证,才是真的验证。

还有一个升级检查项也记录在案:bcrypt 的 72 字节边界 。bcrypt 实际只取口令前 72 字节,超过部分不参与运算------对老站影响有限(2013 年设超长密码的用户极少),但既然列了检查项就得验:有没有旧口令的输入路径超了 72 字节,迁移前后的行为是否一致,别让"改完登不上"这种最伤信任的 bug 藏在边界里。越是"理论上不会有人踩"的边界,越要写进检查清单,因为踩上的人你一个也拦不住。

迁移进度不能只看"还有几个旧哈希"

长期不登录的账号不会自动完成登录时迁移。因此,即使活跃账号都已经升级,剩下的一小批也不能无限期遗忘。原文提出由超级管理员安排重置,实际执行前还应确认这些账号的用途、归属以及是否仍需要保留访问能力,避免把"没人登录"直接当成"可以删除"。

观察数量变化时,要保证比较的是同一个站点和同一批账号。恢复旧备份、导入历史账号,都会让旧格式数量重新出现;这时需要查明数据来源,而不是只盯着登录函数找原因。格式统计本身也不应把完整哈希或口令写进报告,只记录数量、处理状态和必要的脱敏标识。

最后再走一遍用户路径:登录、修改密码、退出、重新登录,以及另一台设备上的旧会话。前四步验证新口令确实能用,最后一步验证补救动作有没有真正限制旧凭据。密码迁移的终点,是认证行为和数据状态一致,而不是数据库里看起来换了一种更长的字符串。

小结

回头看,这次密码迁移没有炫技的地方:算法是标准的 password_hash,策略是教科书的登录即迁移。真正值钱的是把周边全想清楚了 ------兼容层双轨、列扩容、改密踢会话、回退要成对快照、每站在自己副本上验。老站升级的教训大都如此:难的不是换掉最烂的那块,是把和它牵连的一切都接稳。

好了,关于密码迁移的内容就先说这么多,也不知道大家听明白了没有?最后,希望本文对各位看官有所助益,请务必点赞收藏评论走一波,谢谢!

相关阅读:

本系列上一篇:PHP05《安全加固的克制与边界》;下一篇:PHP07《PHP8兼容与旧语法清理》。

FengCMS 开源地址: https://github.com/fengcms/fengcms ------ 如果这个系列的文章对你有帮助,欢迎到仓库点个 Star;有想法也可以直接提 Issue 交流。

本文由 FungLeo 主导,Deepseek 优化校阅,转发请注明首发地址,谢谢大家!

相关推荐
雾隐隐o37 分钟前
优搭校园 01|项目概览、技术选型与初始化
spring boot·mysql·vue
ServBay2 小时前
PHP 8.6 最新发布:语法更新、实用函数与升级要点
后端·php
Decay__3 小时前
SQLServer 运维自动化平台 —— PowerShell + SQL Agent 作业:部署、监控、巡检、告警、工单闭环一体化
运维·数据库·sql·mysql·架构
星恒随风3 小时前
MySQL 从零入门(十):MVCC、Undo Log 与 Read View 详解——InnoDB 如何实现事务隔离?
linux·数据库·笔记·sql·mysql
进击的荆棘5 小时前
MySQL——数据类型
数据库·mysql
kyle~6 小时前
SHA-256 哈希去重
算法·哈希算法
企业数字化笔记8 小时前
报表上线怎么对账?口径回归、权限抽检与差异定位
java·spring boot·mysql
codeejun8 小时前
每日一Go·MySQL-17、分页优化方案
数据库·mysql
CoderYanger8 小时前
Java EE 进阶:9.MyBatis 操作数据库(进阶)(第四弹):图书管理系统(用户登录+添加图书)
java·数据库·spring boot·mysql·面试·java-ee·mybatis