password_get_info

适用PHP版本

PHP 5.5.0 及以上版本

函数说明

返回与由 password_hash() 创建的哈希值相关的信息。该函数主要用于获取哈希所用的算法、选项等详细信息，方便对密码哈希进行检查和处理。

函数语法

array password_get_info(string $hash)

参数

• $hash：需要获取信息的密码哈希字符串。

返回值

返回一个关联数组，包含以下元素：

• 'algo'：整数，密码哈希使用的算法常量（例如 PASSWORD_BCRYPT）。如果哈希格式不符合预期，则值为 0。
• 'algoName'：字符串，算法名称，如 "bcrypt"、"argon2i" 等。
• 'options'：数组，包含该算法使用的相关选项，如 cost（计算复杂度）等。

示例

下面的示例展示如何使用 password_get_info 获取一个 bcrypt 哈希的相关信息：

$hash = password_hash("mypassword", PASSWORD_BCRYPT);
$info = password_get_info($hash);
print_r($info);
  

示例代码的说明

首先通过 password_hash 使用 bcrypt 算法对字符串 "mypassword" 生成哈希，然后调用 password_get_info 获取该哈希的详细信息。输出结果是一个数组，包含算法标识、名称和相关选项（如 cost）。这可以用来验证哈希使用的算法以及调整密码验证的逻辑。