萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 解決 mhash 擴展缺失:自定義 HMAC-MD5 兼容實現

問題

舊代碼調用 mhash(MHASH_MD5, $data, $key),但服務器未安裝 php_mhash.dll / php_mhash.so 且無法安裝(共享主機、無權限),報 Call to undefined function mhash()。

方案一:安裝擴展(有權限時首選)

  1. 下載對應 PHP 版本、線程安全性的 php_mhash.dll(Windows)或編譯 --with-mhash(Linux)。
  2. 需額外放置 libmhash.dll 到系統路徑或 Apache LoadFile 指令載入。
  3. php.ini 啟用 extension=php_mhash.dll,重啟服務。

方案二:純 PHP 實現 HMAC-MD5(零依賴、跨平台)

/**
 * 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)。

copyright © 萬盛學電腦網 all rights reserved