舊代碼調用 mhash(MHASH_MD5, $data, $key),但服務器未安裝 php_mhash.dll / php_mhash.so 且無法安裝(共享主機、無權限),報 Call to undefined function mhash()。
php_mhash.dll(Windows)或編譯 --with-mhash(Linux)。libmhash.dll 到系統路徑或 Apache LoadFile 指令載入。php.ini 啟用 extension=php_mhash.dll,重啟服務。/**
* HMAC-MD5 兼容 mhash(MHASH_MD5, $data, $key)
* @param string $key 密鑰
* @param string $data 數據
* @return string 十六進制小寫字符串
*/
function hmac_md5(string $key, string $data): string {
// 若系統有 mhash 擴展,優先使用(效能更高)
if (extension_loaded('mhash')) {
return bin2hex(mhash(MHASH_MD5, $data, $key));
}
// RFC 2104 標準 HMAC 實現
$blockSize = 64; // MD5 分組長度 512 bit = 64 byte
if (strlen($key) > $blockSize) {
$key = pack('H*', md5($key)); // 密鑰過長先哈希
}
$key = str_pad($key, $blockSize, chr(0x00)); // 補零到 64 字節
$ipad = str_pad('', $blockSize, chr(0x36)); // 0x36 * 64
$opad = str_pad('', $blockSize, chr(0x5c)); // 0x5c * 64
$kIpad = $key ^ $ipad;
$kOpad = $key ^ $opad;
// HMAC = H(K ⊕ opad || H(K ⊕ ipad || data))
return md5($kOpad . pack('H*', md5($kIpad . $data)));
}
$key = 'secret-key';
$data = 'message to sign';
// 對比 mhash (若可用) 與自定義
if (extension_loaded('mhash')) {
$mhashResult = bin2hex(mhash(MHASH_MD5, $data, $key));
$customResult = hmac_md5($key, $data);
var_dump($mhashResult === $customResult); // bool(true)
}
// 標準測試向量 (RFC 2202)
$testCases = [
['key' => str_repeat("\x0b", 16), 'data' => "Hi There", 'expected' => '9294727a3638bb1c13f48ef8158bfc9d'],
['key' => "Jefe", 'data' => "what do ya want for nothing?", 'expected' => '750c783e6ab0b503eaa86e310a5db738'],
['key' => str_repeat("\xaa", 16), 'data' => str_repeat("\xdd", 50), 'expected' => '56be34521d144c88dbb8c733f0e8b3f6'],
];
foreach ($testCases as $tc) {
$out = hmac_md5($tc['key'], $tc['data']);
echo ($out === $tc['expected'] ? '✓' : '✗') . " $out\n";
}
hash_hmac('md5', $data, $key)**(PHP 5.1.2+ 內建,無需擴展,經過優化、經過安全審計)。mhash\( 替換為 hash_hmac('md5',,參數順序注意:mhash(algo, data, key) → hash_hmac(algo, data, key)。mhash 函數名(第三方庫),可定義 function mhash($algo, $data, $key) { return hash_hmac('md5', $data, $key, true); } 並在 auto_prepend_file 載入。mhash 擴展已停止維護,**hash_hmac() 是現代 PHP 統一標準**。自定義 HMAC-MD5 僅作為無法升級環境的臨時兼容層,建議盡快遷移至內建 hash_hmac 或 sodium 擴展(PHP 7.2+ 內建 libsodium)。