萬盛學電腦網

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

PHP OpenSSL 驗證簽名函式封裝:支援 SHA1/DSS1 演算法切換

封裝目標

提供可重複使用的 VerifyMsg() 函式,處理公鑰載入、簽名格式轉換、演算法選擇,回傳布林結果,錯誤細節可另行記錄。

完整函式碼

<?php
/**
 * 驗證數位簽名
 *
 * @param string $TobeVerified  待驗證簽名 (十六進位字串)
 * @param string $PlainText     原始明文
 * @param string $CertFile      公鑰證書檔路徑 (PEM 格式)
 * @param int    $signature_alg 簽名演算法常數 (預設 OPENSSL_ALGO_SHA1)
 * @return bool                 驗證成功 true / 失敗 false
 */
function VerifyMsg(string $TobeVerified, string $PlainText, string $CertFile, int $signature_alg = OPENSSL_ALGO_SHA1): bool
{
    // 1. 讀取公鑰
    $fp = fopen($CertFile, 'r');
    if (!$fp) {
        error_log("VerifyMsg: 無法開啟公鑰檔 $CertFile");
        return false;
    }
    $pub_key = fread($fp, 8192);
    fclose($fp);

    // 2. 匯入公鑰資源
    $res = openssl_get_publickey($pub_key);
    if (!$res) {
        error_log("VerifyMsg: 公鑰匯入失敗 - " . openssl_error_string());
        return false;
    }

    // 3. 將 hex 簽名轉二進位
    // pack("H*") 等同 pack("H" . strlen($TobeVerified), $TobeVerified)
    $sigBin = pack('H*', $TobeVerified);

    // 4. 執行驗證
    $result = openssl_verify($PlainText, $sigBin, $res, $signature_alg);
    openssl_free_key($res);

    // 5. 結果判讀
    // 1 = 成功, 0 = 簽名不符, -1 = 執行錯誤
    if ($result === 1) {
        return true;
    } elseif ($result === 0) {
        error_log("VerifyMsg: 簽名驗證失敗 (不匹配)");
        return false;
    } else {
        error_log("VerifyMsg: openssl_verify 執行錯誤 - " . openssl_error_string());
        return false;
    }
}

演算法常數對照表

常數演算法適用金鑰類型
OPENSSL_ALGO_SHA1SHA-1RSA, DSA (DSA 必須用此/DSS1)
OPENSSL_ALGO_DSS1DSS1 (同 SHA-1)DSA 專用
OPENSSL_ALGO_SHA224SHA-224RSA, ECDSA
OPENSSL_ALGO_SHA256SHA-256RSA, ECDSA (推薦)
OPENSSL_ALGO_SHA384SHA-384RSA, ECDSA
OPENSSL_ALGO_SHA512SHA-512RSA, ECDSA
OPENSSL_ALGO_RMD160RIPEMD-160RSA
OPENSSL_ALGO_MD5MD5RSA (不推薦)
OPENSSL_ALGO_MD4MD4RSA (極不安全)
OPENSSL_ALGO_MD2MD2RSA (極不安全)

使用範例

<?php
// RSA-SHA256 簽名驗證 (現代推薦)
$ok = VerifyMsg($sigHex, $data, 'rsa_public.pem', OPENSSL_ALGO_SHA256);

// DSA-SHA1 簽名驗證 (舊系統相容)
$ok = VerifyMsg($sigHex, $data, 'dsa_public.pem', OPENSSL_ALGO_DSS1);

// 簽名為 base64 時先解碼
$sigBin = base64_decode($sigB64);
$sigHex = bin2hex($sigBin);
$ok = VerifyMsg($sigHex, $data, 'pub.pem', OPENSSL_ALGO_SHA256);

進階擴充建議

  • 例外化:改拋 `VerificationException` 包含錯誤代碼,方便上層統一處理。
  • 支援憑證鏈:使用 `openssl_x509_read()` 解析 X.509 憑證鏈,驗證信任鏈與有效期限。
  • 非同步批次驗證:搭配 `openssl_verify` 無阻塞特性,配合 Swoole/OpenSwoole 並行處理大量簽名。
  • 金鑰快取:`openssl_get_publickey` 重複開銷大,建議快取 resource 或改用 `openssl_pkey_get_public()` 搭配靜態快取。

總結

`VerifyMsg()` 以 pack('H*') 處理 hex→bin、openssl_verify 核心驗證、OPENSSL_ALGO_* 切換演算法,結構清晰、相容性佳。新專案優先選 OPENSSL_ALGO_SHA256 搭配 RSA/ECDSA,淘汰 SHA1/DSA。

copyright © 萬盛學電腦網 all rights reserved