(PHP 5 >= 5.5.0, PHP 7, PHP 8)
hash_pbkdf2 — 生成所提供密码的 PBKDF2 密钥导出
$algo
,$password
,$salt
,$iterations
,$length
= 0,$binary
= false
algo
散列算法名称,例如
md5
、sha256
、haval160,4
等。
受支持的算法清单请参见 hash_algos()。
password
要进行导出的密码。
salt
进行导出时所使用的“盐”,这个值应该是随机生成的。
iterations
进行导出时的迭代次数。
length
密钥导出数据的长度。如果 binary
为 true
,
此参数为密钥导出数据的字节长度。如果 binary
为 false
,
此参数为密钥导出数据的字节长度的 2 倍,因为 1 个字节数据对应的 2 个 16 进制的字符。
如果传入 0
,则使用所选算法的完整输出大小。
binary
设置为 true
输出原始二进制数据,
设置为 false
输出小写 16 进制字符串。
如果 binary
设置为 true
,
则返回原始二进制数据表示的信息摘要,
否则返回 16 进制小写字符串格式表示的信息摘要。
在以下情况下会抛出 ValueError 异常:算法未知,iterations
小于等于 0
,length
小于等于 0
或者
salt
过长(大于 INT_MAX
- 4
)。
版本 | 说明 |
---|---|
8.0.0 |
现在错误时将抛出 ValueError 异常。之前返回 false
并发出 E_WARNING 消息。
|
7.2.0 | 不再支持非加密的散列函数(adler32、crc32、crc32b、fnv132、fnv1a32、fnv164、fnv1a64、joaat)。 |
示例 #1 hash_pbkdf2() 例程,基础用法
<?php
$password = "password";
$iterations = 1000;
// 使用 random_bytes() 生成一个加密安全的随机 IV。
$salt = random_bytes(16);
$hash = hash_pbkdf2("sha256", $password, $salt, $iterations, 20);
var_dump($hash);
// 对于原始二进制,$length 需要减半以获得相同的结果
$hash = hash_pbkdf2("sha256", $password, $salt, $iterations, 10, true);
var_dump(bin2hex($hash));?>
?>
以上例程的输出类似于:
string(20) "120fb6cffcf8b32c43e7" string(20) "120fb6cffcf8b32c43e7"
为了安全起见,可以使用 PBKDF2 方法对密码明文进行散列运算后再存储。但是更好的方案是使用
password_hash() 函数或者使用 CRYPT_BLOWFISH
算法调用
crypt() 函数。