openssl_password_hash
(PHP 8 >= 8.4.0)
openssl_password_hash — Create a password hash using OpenSSL's Argon2 implementation
说明
$algo, #[\SensitiveParameter] string $password, array $options = []): stringCreates a password hash using OpenSSL's Argon2 implementation. This is an alternative to password_hash() that uses OpenSSL as the backend, which may offer hardware acceleration on some platforms.
This function is only available when PHP is compiled with OpenSSL
support that includes Argon2 (HAVE_OPENSSL_ARGON2).
参数
algo
The password hashing algorithm. Supported values:
"argon2id" and "argon2i".
password
The user's password.
options
An associative array of options. Supported keys:
-
memory_cost- Maximum memory (in KiB) that may be used to compute the hash -
time_cost- Maximum amount of time it may take to compute the hash -
threads- Number of threads to use for computing the hash
返回值
Returns the password hash as a string.
错误/异常
Throws a ValueError if algo
is not one of the supported values
("argon2i" or "argon2id").
Throws an Error if the hashing operation fails for an unknown reason.
更新日志
| 版本 | 说明 |
|---|---|
| 8.4.0 | Function added. |
示例
示例 #1 openssl_password_hash() example
<?php
$hash = openssl_password_hash('argon2id', 'my-secret-password');
echo $hash;
?>以上示例的输出类似于:
$argon2id$v=19$m=65536,t=4,p=1$c29tZXNhbHR2YWx1ZQ$hashvalue...
示例 #2 openssl_password_hash() with custom options
<?php
$hash = openssl_password_hash('argon2id', 'my-secret-password', [
'memory_cost' => 65536,
'time_cost' => 4,
'threads' => 1,
]);
?>参见
- openssl_password_verify() - Verify a password against a hash using OpenSSL's Argon2 implementation
- password_hash() - 创建密码的散列(hash)
来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。
