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 一个用来在散列密码时指示算法的密码算法常量。
参数三
一个包含有选项的关联数组。目前支持两个选项:salt,在散列密码时加的盐(干扰字符串),以及cost,用来指明算法递归的层数。这两个值的例子可在 crypt() 页面找到。:$options
省略后,将使用随机盐值与默认 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 )
相关框架:phpass密码散列框架(注意: 对于PHP 5.5+ 请使用 PHP 的原生 password_hash() )