滚动新闻 →
14日面试13日出结果 西安高校被质疑招聘萝卜岗 美国废奴运动如何影响法律制度 川普拒绝对伊朗让步 美伊僵局持续升级 美国查获价值数千万美元中国假货 三名嫌疑人被捕 美国向厄瓜多尔移交拦截艇 旨在遏制毒品走私 韩国高考AI作弊事件引改革讨论 美国国会圣诞树完成3200公里旅程抵达华府 香港航班引擎故障紧急迫降 146人安全撤离 威廉·佩恩如何建立宾夕法尼亚 比亚迪Ti7遭欧盟禁售 涉及1000万欧元罚款 美大使馆:一次查获300吨中国造冰毒前体 台北市长选战白热化 沈伯洋力推改革蒋万安坚守政策 纽约华男涉近1.5亿美元诈骗案获刑20年 印尼海域发生6.8级地震 澳大利亚多地居民感知到震动 反腐行动延伸至民营企业 顺丰八马茶业遭军方暂停采购资格 霍尔木兹海峡油轮遇袭 美以呼吁对伊采取军事行动 屋顶漏水如何判断漏水位置 波罗的海局势升级 俄货船遭无人机袭击 混合并行为什么适合大型模型训练,数据并行与模型并行应该怎样组合 一周经济回顾:战略误判 Google Cloud 多云架构如何设计,避免企业过度依赖单一云平台 SaaS 数据库 Migration 应该怎样管理,避免开发环境和生产环境不一致 乌被逼停战?俄突然发动暗杀 川普翻脸 习吃重拳 青海德令哈市发生5.6级地震 机场启动疏散程序 内蒙女学生武术零基础比赛获亚军 知情者揭内幕 卞相壹绝境逆转李钦诚 首夺三星杯冠军 雪佛龙在希腊爱奥尼亚海展开油气勘探 电脑打开多个程序就卡死,内存容量不足和内存硬件故障怎么区分 欧洲病假年损失超8000亿欧元 各国差异显著 中国女博士美机场遭拘押 护照逾期引争议 Windows 11 DNS 缓存怎么清理?解决部分网络访问问题的方法 PHP 搜索功能怎么做?从关键词输入到 MySQL 安全查询完整实现 台股剧烈震荡 金管会11月23日起实施5项禁空令措施 中国流浪汉增多 失业者沦落街头 诉说背后心酸 台国安基金介入护盘 呼吁投资人理性看待市场波动 从唐诗宋词看古人的日常生活 李子柒获任四川省文联副主席 舆论热议其身份转变 欧盟五国将非法移民遣返至卢旺达 台南幼儿园教师涉嫌重击3岁女童 教育局启动调查 针灸为什么成为中国传统医学的重要组成部分

PHP 密码应该怎么保存?password_hash 和 password_verify 的正确用法

发布时间: 2026-10-11 16:24:02    最后更新: 2026-11-21 10:05:48    阅读: 419    约14 分钟阅读    
PHP 密码应该怎么保存?password_hash 和 password_verify 的正确用法
图片说明:示意图   图片来源:Public Domain(公有领域)
在 PHP 网站开发中,用户注册和登录看起来只是最普通的功能,但密码保存方式却直接决定了数据库泄露以后用户账户究竟有多危险。过去很多程序员习惯使用 MD5、SHA-1,甚至直接把密码存进数据库。这些做法今天已经不应该继续使用。

现代 PHP 已经提供了专门用于密码存储的 API,最核心的两个函数就是 password_hash() 和 password_verify()。正确使用它们,并不需要自己设计加密算法、自己生成盐值,更不应该先 MD5 一次、再 SHA-256 一次,然后再套几层“增强安全性”的自制方案。

密码首先要区分“加密”和“哈希”。

加密通常意味着存在一个密钥,可以把密文恢复成原文。例如数据库中的某些业务数据可能需要加密,因为系统以后还必须读取原始内容。密码则完全不同。服务器登录时真正需要知道的是“用户输入的密码是否正确”,而不是把数据库里的内容解密成用户当年设置的密码。

因此,密码通常应该使用专门设计的密码哈希算法保存。

PHP 的基本写法非常简单:

$hash = password_hash($password, PASSWORD_DEFAULT);

然后把 $hash 保存到数据库。

用户登录时,从数据库读取这个完整的哈希字符串,再执行:

if (password_verify($inputPassword, $hash)) {
// 密码正确
} else {
// 密码错误
}

这里有一个非常重要的设计思想:开发者不需要自己保存一个独立的 salt。

password_hash() 会自动生成随机盐值,并把验证所需的信息编码进最终产生的哈希字符串中。因此数据库中的密码字段通常看起来类似:

$2y$12$......

或者使用其他算法时出现不同格式。

这整串内容都非常重要。不要只截取其中一部分,也不要自己把算法名称、salt、cost 和哈希值拆开保存后再重新组合,除非你非常清楚自己正在实现什么。

使用 PASSWORD_DEFAULT 的另一个好处,是 PHP 可以随着未来版本的发展选择推荐的默认密码哈希算法。也就是说,应用程序不必把某一种具体算法永久写死。

如果明确需要 bcrypt,也可以写:

$hash = password_hash($password, PASSWORD_BCRYPT);

但对于普通新项目,PASSWORD_DEFAULT 通常是更合适的默认选择,因为它让 PHP 负责选择当前推荐的默认密码算法。

很多教程喜欢写:

password_hash($password, PASSWORD_BCRYPT, ['cost' => 12]);

这种写法本身没有问题,但必须理解 cost 到底是什么意思。

bcrypt 的 cost 是一个工作因子。它不是“执行 2^12 次普通运算”这么简单,而是控制 bcrypt 计算工作的指数级参数。cost 每增加1,计算成本大致增加一倍。因此 cost=12 比 cost=11 需要明显更多计算时间。

cost 并不存在一个对所有服务器都完美的数字。服务器CPU性能、PHP版本、并发量以及登录请求规模都会影响实际选择。对于普通网站,应该在目标服务器上进行基准测试,而不是看到网上有人使用12,就认为12一定安全,或者认为14一定比12“安全一倍”。

这里还要注意一个容易忽略的问题:密码哈希故意应该比较慢。

普通 SHA-256 的设计目标是高速计算,这对于完整性校验和很多密码学用途非常有价值,但对于密码存储反而可能成为问题。攻击者一旦获得数据库,就可以使用强大的GPU或专用硬件高速尝试大量密码组合。

密码哈希算法则故意增加计算成本,让攻击者每猜一次密码都付出更高代价。

所以不要写成:

$hash = hash('sha256', $password);

然后把结果存进数据库。

更不要使用:

md5($password)

或者:

sha1($password)

作为网站密码存储方案。

即使加一个固定字符串:

sha256($password . 'mySecretSalt')

也不能把一个普通高速哈希函数变成合格的密码存储方案。

password_hash() 自动生成的 salt 还有另一个非常重要的作用:即使两个用户设置了完全相同的密码,它们生成的哈希值也通常不同。

例如两个用户都设置:

MyPassword123

系统不会因为密码相同就得到完全相同的数据库字符串。

这是因为每次 password_hash() 都会生成新的随机盐。

因此不要在数据库里寻找“相同密码对应相同哈希”的关系,也不要认为数据库中两个用户的密码哈希不同,就意味着他们使用了不同密码。

验证密码的时候,也不要自己重新生成哈希再比较:

if (password_hash($inputPassword, PASSWORD_DEFAULT) === $hash) {

这是错误思路。

因为 password_hash() 每次都会生成新的随机 salt,所以即使输入的是正确密码,新生成的哈希也通常不会与数据库里的旧哈希字符串相同。

正确方式就是:

if (password_verify($inputPassword, $hash)) {
// 登录成功
}

password_verify() 会从数据库中的哈希字符串读取算法和相关参数,然后对用户输入的密码执行相应验证。

这也是为什么开发者必须保存完整哈希字符串。

密码字段不要设置得过短。例如:

password VARCHAR(255) NOT NULL

通常比给它设置一个非常紧张的长度更加稳妥,因为 PHP 的密码 API 未来可能使用不同的算法和不同格式。不要根据今天看到的 $2y$... 字符串长度,就把数据库字段硬编码成某个特别短的尺寸。

还有一个非常实用的函数经常被忽略:

password_needs_rehash()

例如:

if (password_needs_rehash($hash, PASSWORD_DEFAULT)) {
$newHash = password_hash($inputPassword, PASSWORD_DEFAULT);

// 更新数据库中的密码哈希
}

它解决的是一个现实问题:密码哈希算法和参数可能随着时间发生变化。

假设你的网站十年前使用一种旧参数生成密码哈希,而今天 PHP 推荐使用新的默认算法或参数。你不需要强迫所有用户在同一天重新设置密码。

用户正常登录并验证成功以后,可以检查旧哈希是否需要升级。如果需要,就利用用户这次已经验证成功的明文密码重新生成新的哈希,然后更新数据库。

这样就可以逐渐完成密码数据库的升级。

数据库泄露以后,很多人还会犯另一个错误:认为“密码已经哈希了,所以数据库泄露也没什么关系”。

并不是这样。

密码哈希的目标,是让攻击者无法轻易从数据库字符串直接得到原始密码,但如果攻击者拿到了数据库,他仍然可以进行离线密码猜测。

如果用户使用:

123456

password

qwerty

或者生日、姓名等容易猜测的密码,那么攻击者即使面对安全的密码哈希,也可能通过大量尝试最终猜出来。

因此密码哈希只是账户安全的一层防线,而不是全部安全措施。

网站还应该限制登录尝试速度。例如同一个账户、IP、设备或者登录接口出现异常大量尝试时,应实施 rate limiting。必要时还可以加入验证码、账户临时锁定、异常登录检测以及多因素认证。

另外,不要把密码写进日志。

下面这种代码就是典型错误:

error_log("Login password: " . $password);

调试环境也不要随意记录完整密码哈希。虽然哈希不是明文密码,但它属于敏感认证数据。数据库查询日志、异常日志、调试日志、备份文件以及开发环境数据库,都应该考虑访问控制。

还有一点非常重要:不要在客户端“处理密码以后再发送”。

浏览器端使用 JavaScript 对密码进行 MD5、SHA-256 等计算,再把这个结果当作密码发送给服务器,并不能自动提高安全性。因为如果服务器把这个结果直接当成登录凭证,那么这个“哈希值”本身就变成了攻击者可以重放的密码。

正确的基本架构仍然是使用 HTTPS 保护传输,然后在服务器端进行密码验证和密码哈希。

一个最简单的注册流程可以写成:

$password = $_POST['password'];

$hash = password_hash(
$password,
PASSWORD_DEFAULT
);

// 将 $hash 写入数据库

登录流程则是:

$password = $_POST['password'];

// 从数据库读取用户对应的 password_hash
if (password_verify($password, $storedHash)) {

if (password_needs_rehash($storedHash, PASSWORD_DEFAULT)) {
$newHash = password_hash(
$password,
PASSWORD_DEFAULT
);

// 更新数据库
}

// 登录成功
}

当然,真实网站不能只靠这几行代码。实际系统还需要使用参数化 SQL 防止 SQL 注入,正确处理 session,设置安全的 Cookie 属性,例如 Secure、HttpOnly 和合适的 SameSite,防范 CSRF,并对登录接口进行速率限制。

如果使用 PDO,数据库操作应该采用预处理语句,例如:

$stmt = $pdo->prepare(
"SELECT id, password_hash
FROM users
WHERE email = :email
LIMIT 1"
);

$stmt->execute([
':email' => $email
]);

$user = $stmt->fetch(PDO::FETCH_ASSOC);

然后:

if ($user && password_verify(
$password,
$user['password_hash']
)) {
// 登录成功
}

这样密码验证过程与 SQL 查询过程彼此分开,不应该把密码直接拼接进 SQL 字符串。

最后还有一个经常被忽略的细节:不要自行限制密码只能使用某些字符,也不要为了“数据库字段长度”而随意截断密码。现代密码系统应该允许用户使用足够长的密码或密码短语。尤其不能在进入 password_hash() 之前偷偷执行 substr() 截断。

如果业务确实需要设置密码长度限制,也应该采用合理的上限,而不是人为制造一个很小的限制。

对于已经使用 MD5、SHA-1 或自定义哈希方案的旧 PHP 网站,也不要简单地把旧哈希再套一次:

password_hash(md5($password), PASSWORD_DEFAULT)

这并不能恢复旧系统失去的密码安全性,因为新的密码哈希实际上是在保护一个已经被旧算法处理过的值。

更合理的迁移方式通常是在用户下一次成功登录时,根据旧系统验证方式确认原密码,然后立即使用 password_hash() 重新生成现代密码哈希并更新数据库。对于长期不登录的账户,则根据具体业务制定强制重置密码等迁移方案。

密码安全真正需要避免的,并不是某一个 PHP 函数写错了,而是开发者试图自己发明一套密码系统。密码存储属于非常典型的“不要重新发明轮子”的领域。

今天的 PHP 已经把随机 salt、算法参数以及验证逻辑封装在 password_hash()、password_verify() 和 password_needs_rehash() 这些 API 中。开发者真正应该做的,是正确调用这些函数,再把数据库、HTTPS、Session、Cookie、速率限制和日志保护这些外围安全措施做好。

记住最核心的三件事就够了:注册时使用 password_hash(),登录时使用 password_verify(),登录成功后使用 password_needs_rehash() 检查是否需要升级哈希。

密码不应该被“保存下来供服务器解密”,而应该被转换成一个专门设计用于验证的密码哈希。服务器真正需要知道的,从来不是“用户当初设置的密码是什么”,而只是一个问题:这次输入的密码,究竟是不是正确的那个密码。
作者头像
本文作者
程越(Kevin Cheng)
IT与人工智能技术资深编辑

喜欢这篇报道?

使用下面的功能,方便以后继续阅读和分享 MNewsTV

设为 Google 新闻首选来源 让 Google 新闻优先显示 MNewsTV 的最新报道 ›
★ 我的收藏 查看已经收藏的文章
关于文章收藏 收藏不需要注册帐号,收藏信息仅保存在当前浏览器中。 删除收藏请进入「我的收藏」进行管理。
分享这篇报道

捐助(Paypal): https://www.paypal.me/observeccp
订阅中国观察电报 Telegram: https://t.me/s/ObserveCCP