PHP密码password_hash散列加密

在PHP 5.5.0之后（包括PHP 7, PHP 8）新增加了一个password_hash 函数，用于创建密码的散列（hash）。

函数说明：

password_hash(string $password, string|int|null $algo, array $options = []): string

password_hash() 使用足够强度的单向散列算法创建密码的散列（hash）。 password_hash() 兼容 crypt()。所以， crypt() 创建的密码散列也可用于 password_hash()。

返回值

返回散列后的密码。

使用的算法、cost 和盐值作为散列的一部分返回。所以验证散列值的所有信息都已经包含在内。这使 password_verify() 函数验证的时候，不需要额外储存盐值或者算法的信息。

参数说明：

参数一：$password 密码明文。

参数二：$algo 一个用来在散列密码时指示算法的密码算法常量。

参数三：$options 一个包含有选项的关联数组。目前支持两个选项：salt，在散列密码时加的盐（干扰字符串），以及cost，用来指明算法递归的层数。这两个值的例子可在 crypt() 页面找到。

省略后，将使用随机盐值与默认 cost。

当前支持的算法（$algo）：

PASSWORD_DEFAULT - 使用 bcrypt 算法 (PHP 5.5.0 默认)。注意，该常量会随着 PHP 加入更新更高强度的算法而改变。所以，使用此常量生成结果的长度将在未来有变化。因此，数据库里储存结果的列可超过60个字符（最好是255个字符）。
PASSWORD_BCRYPT - 使用 CRYPT_BLOWFISH 算法创建散列。这会产生兼容使用 "$2y$" 的 crypt()。结果将会是 60 个字符的字符串，或者在失败时返回 false。
PASSWORD_ARGON2I - 使用 Argon2i 散列算法创建散列。只有在 PHP 编译时加入 Argon2 支持时才能使用该算法。
PASSWORD_ARGON2ID - 使用 Argon2id 散列算法创建散列。只有在 PHP 编译时加入 Argon2 支持时才能使用该算法。

使用时可直接用PASSWORD_BCRYPT或者$algo = array('algo'=>PASSWORD_BCRYPT);

$options选项：

PASSWORD_BCRYPT 支持的选项：

salt(string) - 手动提供散列密码的盐值（salt）。这将避免自动生成盐值（salt）。省略此值后，password_hash() 会为每个密码散列自动生成随机的盐值。这种操作是有意的模式。警告：盐值（salt）选项已废弃（deprecated）。现在最好仅选择使用默认产生的盐值。从 PHP 8.0.0 起，明确指定的 salt 值会被忽略。
cost (int) - 代表算法使用的 cost。crypt() 页面上有 cost 值的例子。省略时，默认值是 10。这个 cost 是个不错的底线，但也许可以根据自己硬件的情况，加大这个值。

PASSWORD_ARGON2I 和 PASSWORD_ARGON2ID 支持的选项：

memory_cost (int) - 计算 Argon2 散列时的最大内存（单位：KB）。默认值： PASSWORD_ARGON2_DEFAULT_MEMORY_COST。
time_cost (int) - 计算 Argon2 散列时最多的时间。默认值： PASSWORD_ARGON2_DEFAULT_TIME_COST。
threads (int) - 计算 Argon2 散列时最多的线程数。默认值： PASSWORD_ARGON2_DEFAULT_THREADS。警告：只有在 PHP 使用 libargon2 时可用；如果是 libsodium 的实现，则无法使用。

使用时可以用$options = array('cost' => 10);

使用例程：

示例 #1 password_hash() 例子

<?php
/**
 * 我们想要使用默认算法散列密码
 * 当前是 BCRYPT，并会产生 60 个字符的结果。
 *
 * 请注意，随时间推移，默认算法可能会有变化，
 * 所以需要储存的空间能够超过 60 字（255字不错）
 */
echo password_hash("rasmuslerdorf", PASSWORD_DEFAULT);
?>

以上例程的输出类似于：$2y$10$.vGA1O9wmRjrwAVXD98HNOgsNpDczlqm3Jq7KnEd1rVAGv3Fykk1a

示例 #2 password_hash() 手动设置 cost 的例子

<?php
/**
 * 在这个案例里，我们为 BCRYPT 增加 cost 到 12。
 * 注意，我们已经切换到了，将始终产生 60 个字符。
 */
$options = [
    'cost' => 12,
];
echo password_hash("rasmuslerdorf", PASSWORD_BCRYPT, $options);
?>

以上例程的输出类似于：$2y$12$QjSH496pcT5CEbzjD/vtVeH03tfHKFy36d4J0Ltp3lRtee9HDxY3K

示例 #3 寻找最佳 cost 的 password_hash() 例子

<?php
/**
 * 这个例子对服务器做了基准测试（benchmark），检测服务器能承受多高的 cost
 * 在不明显拖慢服务器的情况下可以设置最高的值
 * 8-10 是个不错的底线，在服务器够快的情况下，越高越好。
 * 以下代码目标为  ≤ 50 毫秒（milliseconds），
 * 适合系统处理交互登录。
 */
$timeTarget = 0.05; // 50 毫秒（milliseconds） 

$cost = 8;
do {
    $cost++;
    $start = microtime(true);
    password_hash("test", PASSWORD_BCRYPT, ["cost" => $cost]);
    $end = microtime(true);
} while (($end - $start) < $timeTarget);

echo "Appropriate Cost Found: " . $cost;
?>

以上例程的输出类似于：Appropriate Cost Found: 10

示例 #4 使用 Argon2i 的password_hash()例子

<?php
    echo 'Argon2i hash: ' . password_hash('rasmuslerdorf', PASSWORD_ARGON2I);
?>

以上例程的输出类似于：Argon2i hash: $argon2i$v=19$m=1024,t=2,p=2$YzJBSzV4TUhkMzc3d3laeg$zqU/1IN0/AogfP4cmSJI1vc8lpXRW9/S0sYY2i2jHT0

自定义salt盐值

<?php
function custom_function_for_salt() {
    return md5(mt_rand(1111,9999));
}

$options = [
    'salt' => custom_function_for_salt(), //自定义函数来获得盐值
    'cost' => 12 // the default cost is 10
];
$passwordHash = password_hash('123456', PASSWORD_BCRYPT,$options);
echo $passwordHash.PHP_EOL;

$flag = password_verify('123456',$passwordHash);
echo $flag.PHP_EOL;

密码验证：password_verify()

<?php
// 想知道以下字符从哪里来，可参见 password_hash() 的例子
$hash = '$2y$07$BCryptRequires22Chrcte/VlQH0piJtjXl.0t1XkA8pw9dMXTpOq';

if (password_verify('rasmuslerdorf', $hash)) {
    echo 'Password is valid!';
} else {
    echo 'Invalid password.';
}
?>

检测散列值是否匹配指定的选项：password_needs_rehash()

<?php

$password = 'rasmuslerdorf';
$hash = '$2y$10$YCFsG6elYca568hBi2pZ0.3LDL5wjgxct1N8w/oLR/jfHsiQwCqTS';

// 当硬件性能得到改善时，cost 参数可以再修改
$options = array('cost' => 11);

// 根据明文密码验证储存的散列
if (password_verify($password, $hash)) {
    // 检测是否有更新的可用散列算法
    // 或者 cost 发生变化
    if (password_needs_rehash($hash, PASSWORD_DEFAULT, $options)) {
        // 如果是这样，则创建新散列，替换旧散列
        $newHash = password_hash($password, PASSWORD_DEFAULT, $options);
    }

    // 使用户登录
}
?>

进行序列化和反序列化

使用serialize() 和unserialize()函数

<?php

$hash = '$2y$10$sfMFyHAyb4IItiHRG/houOcUoS1y8RtkbU6hoUxxacMv3/m7hu1J2';
$serialize = serialize($hash);
//序列化
print_r($serialize);
//反序列化
print_r(unserialize($serialize));

//输出结果为：
//序列化
// a:1:{s:4:"hash";s:60:"$2y$10$sfMFyHAyb4IItiHRG/houOcUoS1y8RtkbU6hoUxxacMv3/m7hu1J2";}.
//反序列化
// Array ( [hash] => $2y$10$sfMFyHAyb4IItiHRG/houOcUoS1y8RtkbU6hoUxxacMv3/m7hu1J2