password_hash() 函数用于创建密码的散列(hash)
PHP 版本要求: PHP 5 >= 5.5.0, PHP 7
语法
string password_hash ( string $password , int $algo [, array $options ] )
password_hash() 使用足够强度的单向散列算法创建密码的散列(hash)。 password_hash() 兼容 crypt()。 所以, crypt() 创建的密码散列也可用于 password_hash()。
当前支持的算法:
-
PASSWORD_DEFAULT
- 使用 bcrypt 算法 (PHP 5.5.0 默认)。 注意,该常量会随着 PHP 加入更新更高强度的算法而改变。 所以,使用此常量生成结果的长度将在未来有变化。 因此,数据库里储存结果的列可超过60个字符(最好是255个字符)。 -
PASSWORD_BCRYPT
- 使用CRYPT_BLOWFISH
算法创建散列。 这会产生兼容使用 "$2y$" 的 crypt()。 结果将会是 60 个字符的字符串, 或者在失败时返回FALSE
。 -
PASSWORD_ARGON2I
- 使用 Argon2 散列算法创建散列。
PASSWORD_BCRYPT 支持的选项:
-
salt(string) - 手动提供散列密码的盐值(salt)。这将避免自动生成盐值(salt)。
省略此值后,password_hash() 会为每个密码散列自动生成随机的盐值。这种操作是有意的模式。
注意:盐值(salt)选项从 PHP 7.0.0 开始被废弃(deprecated)了。 现在最好选择简单的使用默认产生的盐值。
-
cost (integer) - 代表算法使用的 cost。crypt() 页面上有 cost 值的例子。
省略时,默认值是 10。 这个 cost 是个不错的底线,但也许可以根据自己硬件的情况,加大这个值。
PASSWORD_ARGON2I 支持的选项:
-
memory_cost (integer) - 计算 Argon2 散列时的最大内存(单位:字节 byte)。默认值:
PASSWORD_ARGON2_DEFAULT_MEMORY_COST
。 -
time_cost (integer) - 计算 Argon2 散列时最多的时间。默认值:
PASSWORD_ARGON2_DEFAULT_TIME_COST
。 -
threads (integer) - 计算 Argon2 散列时最多的线程数。默认值:
PASSWORD_ARGON2_DEFAULT_THREADS
。
参数说明:
password: 一个由 password_hash() 创建的散列值。
algo: 一个用来在散列密码时指示算法的密码算法常量。
options: 一个包含有选项的关联数组。目前支持两个选项:salt,在散列密码时加的盐(干扰字符串),以及cost,用来指明算法递归的层数。这两个值的例子可在 crypt() 页面找到。
省略后,将使用随机盐值与默认 cost。
返回值
返回散列后的密码, 或者在失败时返回 FALSE。
实例
实例 1
输出结果为:
$2y$10$.vGA1O9wmRjrwAVXD98HNOgsNpDczlqm3Jq7KnEd1rVAGv3Fykk1a
实例 2
输出结果为:
$2y$12$QjSH496pcT5CEbzjD/vtVeH03tfHKFy36d4J0Ltp3lRtee9HDxY3K
实例 3
手动设置盐值的例子
输出结果为:
$2y$11$q5MkhSBtlsJcNEVsYh64a.aCluzHnGog7TQAKVmQwO9C8xb.t89F.
实例 4
寻找最佳 cost 的 password_hash() 例子
输出结果为:
Appropriate Cost Found: 10
实例 5
使用 Argon2 例子:
输出结果为:
Argon2 hash: $argon2i$v=19$m=1024,t=2,p=2$YzJBSzV4TUhkMzc3d3laeg$zqU/1IN0/AogfP4cmSJI1vc8lpXRW9/S0sYY2i2jHT0其他扩展