免费AI编程助手
PHP8 password_hash
2024-03-13 11:25 更新
(PHP 5 >= 5.5.0, PHP 7, PHP 8)
password_hash — 创建密码的散列（hash）
说明
password_hash(string $password, string|int|null $algo, array $options = []): stringpassword_hash() 使用足够强度的单向散列算法创建密码的散列（hash）。
当前支持的算法：
- 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 支持的选项：
- 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 的实现，则无法使用。
参数
password用户的密码。
警告使用
PASSWORD_BCRYPT做算法，将使password参数最长为72个字节，超过会被截断。algo一个用来在散列密码时指示算法的密码算法常量。
options一个包含有选项的关联数组。详细的参数说明，请参考文档 密码算法常数。
省略后，将使用随机盐值与默认 cost。
返回值
返回散列后的密码。
使用的算法、cost 和盐值作为散列的一部分返回。所以验证散列值的所有信息都已经包含在内。 这使 password_verify() 函数验证的时候，不需要额外储存盐值或者算法的信息。
更新日志
| 版本 | 说明 |
|---|---|
| 8.0.0 | 失败时 password_hash() 不再返回 false，如果密码散列算法无效，则会抛出 ValueError，如果密码散列因未知错误失败，则会抛出 Error。 |
| 8.0.0 | 参数 algo 可以为 null。 |
| 7.4.0 | 现在 algo 参数可支持 string 类型，但为了向后兼容也支持 int 类型。 |
| 7.4.0 | 扩展 sodium 提供了 Argon2 密码的替代实现。 |
| 7.3.0 | 增加 PASSWORD_ARGON2ID，支持 Argon2id 密码算法。 |
| 7.2.0 | 增加 PASSWORD_ARGON2I，支持 Argon2i 密码算法。 |
示例
示例 #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
* 在不明显拖慢服务器的情况下可以设置最高的值
* 10 是个不错的底线，在服务器够快的情况下，越高越好。
* 以下代码目标为 ≤ 350 毫秒（milliseconds），
* 对于处理交互式登录的系统来说，这是一个合适的延迟时间。
*/
$timeTarget = 0.350; // 350 毫秒（milliseconds）
$cost = 10;
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: 12
示例 #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 7.0 提供 salt选项会导致废弃（deprecation）警告。 未来的 PHP 发行版里，手动提供盐值的功能已经在 PHP 8.0 移除。
注意:在交互的系统上，推荐在自己的服务器上测试此函数，调整 cost 参数直至函数时间开销小于 350 毫秒（milliseconds）。 上面脚本的示例会帮助选择合适硬件的最佳 cost。
注意: 这个函数更新支持的算法时（或修改默认算法），必定会遵守以下规则：任何内核中的新算法必须在经历一次 PHP 完整发行才能成为默认算法。 比如，在 PHP 7.5.5 中添加的新算法，在 PHP 7.7 之前不能成为默认算法 （由于 7.6 是第一个完整发行版）。 但如果是在 7.6.0 里添加的不同算法，在 7.7.0 里也可以成为默认算法。仅仅允许在完整发行版中修改默认算法（比如 7.3.0, 8.0.0，等等），不能是在修订版。 唯一的例外是：在当前默认算法里发现了紧急的安全威胁。
参见
- password_verify() - 验证密码是否和散列值匹配
- password_needs_rehash() - 检测散列值是否匹配指定的选项
- crypt() - 单向字符串散列
- sodium_crypto_pwhash_str() - Get an ASCII-encoded hash
以上内容是否对您有帮助：
更多建议：