PHP 教程
password_hash() 函數(shù)用于創(chuàng)建密碼的散列(hash)
PHP 版本要求: PHP 5 >= 5.5.0, PHP 7
string password_hash ( string $password , int $algo [, array $options ] )
password_hash() 使用足夠強(qiáng)度的單向散列算法創(chuàng)建密碼的散列(hash)。 password_hash() 兼容 crypt()。 所以, crypt() 創(chuàng)建的密碼散列也可用于 password_hash()。
當(dāng)前支持的算法:
PASSWORD_DEFAULT
- 使用 bcrypt 算法 (PHP 5.5.0 默認(rèn))。
注意,該常量會(huì)隨著 PHP 加入更新更高強(qiáng)度的算法而改變。
所以,使用此常量生成結(jié)果的長(zhǎng)度將在未來(lái)有變化。
因此,數(shù)據(jù)庫(kù)里儲(chǔ)存結(jié)果的列可超過(guò)60個(gè)字符(最好是255個(gè)字符)。
PASSWORD_BCRYPT
- 使用 CRYPT_BLOWFISH
算法創(chuàng)建散列。
這會(huì)產(chǎn)生兼容使用 "$2y$" 的 crypt()。
結(jié)果將會(huì)是 60 個(gè)字符的字符串, 或者在失敗時(shí)返回 FALSE
。
PASSWORD_ARGON2I
- 使用 Argon2 散列算法創(chuàng)建散列。
PASSWORD_BCRYPT 支持的選項(xiàng):
salt(string) - 手動(dòng)提供散列密碼的鹽值(salt)。這將避免自動(dòng)生成鹽值(salt)。
省略此值后,password_hash() 會(huì)為每個(gè)密碼散列自動(dòng)生成隨機(jī)的鹽值。這種操作是有意的模式。
注意:鹽值(salt)選項(xiàng)從 PHP 7.0.0 開(kāi)始被廢棄(deprecated)了。 現(xiàn)在最好選擇簡(jiǎn)單的使用默認(rèn)產(chǎn)生的鹽值。
cost (integer) - 代表算法使用的 cost。crypt() 頁(yè)面上有 cost 值的例子。
省略時(shí),默認(rèn)值是 10。 這個(gè) cost 是個(gè)不錯(cuò)的底線,但也許可以根據(jù)自己硬件的情況,加大這個(gè)值。
PASSWORD_ARGON2I 支持的選項(xiàng):
memory_cost (integer) - 計(jì)算 Argon2 散列時(shí)的最大內(nèi)存(單位:字節(jié) byte)。默認(rèn)值: PASSWORD_ARGON2_DEFAULT_MEMORY_COST
。
time_cost (integer) - 計(jì)算 Argon2 散列時(shí)最多的時(shí)間。默認(rèn)值: PASSWORD_ARGON2_DEFAULT_TIME_COST
。
threads (integer) - 計(jì)算 Argon2 散列時(shí)最多的線程數(shù)。默認(rèn)值: PASSWORD_ARGON2_DEFAULT_THREADS
。
參數(shù)說(shuō)明:
password: 一個(gè)由 password_hash() 創(chuàng)建的散列值。
algo: 一個(gè)用來(lái)在散列密碼時(shí)指示算法的密碼算法常量。
options: 一個(gè)包含有選項(xiàng)的關(guān)聯(lián)數(shù)組。目前支持兩個(gè)選項(xiàng):salt,在散列密碼時(shí)加的鹽(干擾字符串),以及cost,用來(lái)指明算法遞歸的層數(shù)。這兩個(gè)值的例子可在 crypt() 頁(yè)面找到。
省略后,將使用隨機(jī)鹽值與默認(rèn) cost。
返回散列后的密碼, 或者在失敗時(shí)返回 FALSE。
輸出結(jié)果為:
$2y$10$.vGA1O9wmRjrwAVXD98HNOgsNpDczlqm3Jq7KnEd1rVAGv3Fykk1a
輸出結(jié)果為:
$2y$12$QjSH496pcT5CEbzjD/vtVeH03tfHKFy36d4J0Ltp3lRtee9HDxY3K
手動(dòng)設(shè)置鹽值的例子
輸出結(jié)果為:
$2y$11$q5MkhSBtlsJcNEVsYh64a.aCluzHnGog7TQAKVmQwO9C8xb.t89F.
尋找最佳 cost 的 password_hash() 例子
輸出結(jié)果為:
Appropriate Cost Found: 10
使用 Argon2 例子:
輸出結(jié)果為:
Argon2 hash: $argon2i$v=19$m=1024,t=2,p=2$YzJBSzV4TUhkMzc3d3laeg$zqU/1IN0/AogfP4cmSJI1vc8lpXRW9/S0sYY2i2jHT0其他擴(kuò)展