hash_pbkdf2

(PHP 5 >= 5.5.0, PHP 7, PHP 8)

hash_pbkdf2 — 生成所提供密码的 PBKDF2 密钥导出

说明

hash_pbkdf2(
    string $algo,
    #[\SensitiveParameter] string $password,
    string $salt,
    int $iterations,
    int $length = 0,
    bool $binary = false,
    array $options = []
): string

参数

algo

要使用的散列算法的名称（例如：“sha256”）。 可以在 hash_hmac_algos() 中查看当前支持的算法。

注意:

不允许使用非加密哈希函数。

password

要进行导出的密码。

salt

进行导出时所使用的“盐”，这个值应该是随机生成的。

iterations

进行导出时的迭代次数。

length

密钥导出数据的长度。如果 binary 为 true， 此参数为密钥导出数据的字节长度。如果 binary 为 false， 此参数为密钥导出数据的字节长度的 2 倍，因为 1 个字节数据对应的 2 个 16 进制的字符。

如果传入 0，则使用所选算法的完整输出大小。

binary

设置为 true 输出原始二进制数据， 设置为 false 输出小写 16 进制字符串。

options

各种散列算法的一系列选项数组。 目前 MurmurHash 算法仅支持 “seed” 参数。

返回值

如果 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 = 600000;

// 使用 random_bytes() 生成一个加密安全的随机盐。
$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() 函数。

参见