(PHP 5 >= 5.6.0, PHP 7, PHP 8)
hash_equals — 可防止時序攻擊的字符串比較
$known_string
, string $user_string
): bool比較兩個字符串,無論它們是否相等,本函數的時間消耗是恒定的。
本函數可以用在需要防止時序攻擊的字符串比較場景中, 例如,可以用在比較 crypt() 密碼哈希值的場景。
known_string
已知長度的、要參與比較的 string
user_string
用戶提供的字符串
當兩個字符串相等時返回 true
,否則返回 false
。
如果所提供的 2 個參數中任何一個不是字符串,
會導致 E_WARNING
消息。
示例 #1 hash_equals() 例程
<?php
$expected = crypt('12345', '$2a$07$usesomesillystringforsalt$');
$correct = crypt('12345', '$2a$07$usesomesillystringforsalt$');
$incorrect = crypt('apple', '$2a$07$usesomesillystringforsalt$');
var_dump(hash_equals($expected, $correct));
var_dump(hash_equals($expected, $incorrect));
?>
以上例程會輸出:
bool(true) bool(false)
注意:
要想成功進行比較,那么所提供的 2 個參數必須是相同長度的字符串。 如果所提供的字符串長度不同,那么本函數會立即返回
false
, 在時序攻擊的場景下,已知字符串的長度可能會被泄露。
注意:
非常重要的一點是,用戶提供的字符串必須是第二個參數。