PHP8.0如何调用PasswordHashArgon_PHP8.0密码哈希调用式【认证】

云丽小哥_8887

云丽小哥_8887

2026-05-10

180人浏览

原创

php 8.0 默认仍用 password_bcrypt,非显式指定且环境支持时不会自动启用 password_argon2id;须运行时验证 defined('password_argon2id')、extension_loaded('sodium') 及 password_hash() 实际返回值,参数键名必须小写,哈希字符串需完整存储于 varchar(255) 字段。

php8.0如何调用passwordhashargon_php8.0密码哈希调用式【认证】

PHP 8.0 默认仍用 PASSWORD_BCRYPT(不是 PASSWORD_ARGON2ID),除非你显式指定且环境支持 Argon2。别看到“PHP 8.0 支持 Argon2”就以为它自动启用——绝大多数线上环境(包括官方 Docker 镜像、主流云主机)默认不启用 libsodium 或未编译 Argon2 支持,password_hash() 调用 PASSWORD_ARGON2ID 会直接返回 false。

怎么确认 PHP 8.0 真的能用 PASSWORD_ARGON2ID

不能只查 PHP 版本。必须运行时验证:

  • defined('PASSWORD_ARGON2ID') 必须为 true(PHP ≥ 7.3 是前提,但不保证启用)
  • function_exists('password_hash') 和 extension_loaded('sodium') 建议一并检查——libsodium 是 Argon2ID 的底层依赖,缺一不可
  • 实测调用:var_dump(password_hash('test', PASSWORD_ARGON2ID)); 若返回 false,说明环境不支持,别硬上

password_hash() 调用 PASSWORD_ARGON2ID 的正确参数写法

Argon2 参数不能省略或错位,PHP 8.0 对 $options 键名大小写敏感(比如写成 'Memory_cost' 会警告并忽略):

  • 必须用小写键名:['memory_cost' => 65536, 'time_cost' => 4, 'threads' => 3]
  • memory_cost 单位是 KiB,默认 65536 = 64MB;低内存容器(如 512MB RAM 的轻量服务器)可能 OOM,上线前压测
  • time_cost 是迭代次数,threads 是并行线程数;三者共同决定耗时,别只调高一个
  • 不传 $options 会用 PHP 内置默认值,但默认 memory_cost=65536 在资源受限环境风险高

为什么 password_verify() 能直接验证 Argon2 哈希

因为 Argon2 哈希字符串本身已编码全部参数,例如:

Cn Password Generator V2
Cn Password Generator V2

生成加密安全的随机密码,支持自定义字符集、长度及字符类型控制,纯 Python 实现,无需 API 密钥。

下载
$argon2id$v=19$m=65536,t=4,p=1$U1loZThCYWtXcnpYWWV3NA$52eO0Ig9a1/pwqK3NPeNxwQpRuml36pjN2UN5BaGVGo

其中 m=65536、t=4、p=1 全部明文可见。password_verify() 解析这些字段后,用完全相同的配置重算一次哈希——盐值也包含在 $U1loZThCYWtXcnpYWWV3NA$ 段里,无需额外存储或提取。

所以你存进数据库的必须是完整字符串(长度可达 255 字符),字段类型得是 VARCHAR(255);如果用 CHAR(60) 或中间 trim()、substr() 截断,验证必然失败。

常见失败场景和绕过陷阱

真实线上问题往往出在“以为对了,其实没生效”:

  • 开发机支持 Argon2,但测试/生产环境没装 sodium 扩展 → password_hash() 静默 fallback 到 PASSWORD_BCRYPT,而你代码没做返回值判断,导致存的是 bcrypt 哈希却误以为是 Argon2
  • 数据库字段是 VARCHAR(60),存 PASSWORD_BCRYPT 没事,但 Argon2 哈希超长被截断 → 登录时 password_verify() 收到损坏字符串,永远返回 false
  • 注册时用了 PASSWORD_ARGON2ID,登录验证却漏写第三个参数,直接用 password_verify($pass, $hash) —— 这个本身没错,但若后续想升级 cost 参数,password_needs_rehash($hash, PASSWORD_ARGON2ID, [...]) 就要求 $hash 真是 Argon2 格式,否则永远返回 false

最易被忽略的一点:Argon2 哈希字符串里含 $ 符号,若你用某些 ORM 或 SQL 构建器做参数绑定时手动拼接 SQL(比如 "WHERE password = '$hash'"),可能触发意外截断或语法错误——必须走预处理或至少 mysqli_real_escape_string() 处理。

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关文章

WPS零基础入门到精通全套教程!
WPS零基础入门到精通全套教程!

全网最新最细最实用WPS零基础入门到精通全套教程!带你真正掌握WPS办公! 内含Excel基础操作、函数设计、数据透视表等

下载

相关标签:

php word php8

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2023.09.01

9984

6

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

5941

5

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

2075

5

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

2023.10.23

3728

4

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

2023.10.23

4414

6

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.03

3471

9

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.09

4937

8

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.13

3862

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

11842

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习