array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'zh', ), 'this' => array ( 0 => 'function.openssl-pbkdf2.php', 1 => 'openssl_pbkdf2', 2 => '生成 PKCS5 v2 PBKDF2 字符串', ), 'up' => array ( 0 => 'ref.openssl.php', 1 => 'OpenSSL 函数', ), 'prev' => array ( 0 => 'function.openssl-password-verify.php', 1 => 'openssl_password_verify', ), 'next' => array ( 0 => 'function.openssl-pkcs12-export.php', 1 => 'openssl_pkcs12_export', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'zh', 'path' => 'reference/openssl/functions/openssl-pbkdf2.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

openssl_pbkdf2

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

openssl_pbkdf2 — 生成 PKCS5 v2 PBKDF2 字符串

说明

openssl_pbkdf2(
    #[\SensitiveParameter] string $password,
    string $salt,
    int $key_length,
    int $iterations,
    string $digest_algo = "sha1"
): string|false

openssl_pbkdf2() 计算 PBKDF2 (Password-Based Key Derivation Function 2)，在 PKCS5 v2 中定义的密钥的推导函数。

参数

password

派生密钥所生成的密码。

salt

PBKDF2 推荐不少于 128 位（16 字节）的密码盐值。

key_length

希望输出密钥的长度。

iterations

需要的迭代次数。» NIST 建议至少 10,000 次。自 2023 年起，OWASP 针对 PBKDF2-HMAC-SHA256 推荐 600,000 次迭代，针对 PBKDF2-HMAC-SHA512 推荐 210,000 次。

digest_algo

在 openssl_get_md_methods() 中可选的散列或摘要算法。默认是 SHA-1。推荐设置为 SHA-256 或 SHA-512。

返回值

成功，返回原始二进制字符串 或者在失败时返回 false。

示例

示例 #1 openssl_pbkdf2() 示例

<?php
$password = 'password';
$salt = openssl_random_pseudo_bytes(16);
$keyLength = 20;
$iterations = 600000;
$generated_key = openssl_pbkdf2($password, $salt, $keyLength, $iterations, 'sha256');
echo bin2hex($generated_key)."\n";
echo base64_encode($generated_key)."\n";
?>

参见