萬盛學電腦網

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

PHP mcrypt 擴充實戰:Twofish ECB 模式加密解密完整流程

⚠️ 重要提示

mcrypt 擴充自 PHP 7.1 棄用,PHP 7.2 移除核心,PHP 8.0 完全移除。
現代專案請改用 OpenSSL (openssl_encrypt/openssl_decrypt) 或 Sodium (sodium_crypto_*) 原生函數,兩者皆為 CSPRNG 級安全、標準化、長期維護。

歷史代碼維護參考:Twofish ECB 模式流程

若必須維護舊專案無法立即遷移,以下為標準流程:

<?php
/**
 * mcrypt 兩魚加密/解密示範 (僅供舊代碼維護參考)
 * 
 * @param string $data 明文
 * @param string $keyBase 密鑰基礎字串
 * @return array ['encrypted' => string, 'decrypted' => string, 'iv' => string, 'key' => string]
 */
function mcryptTwofishDemo(string $data, string $keyBase = 'very secret key'): array
{
    // 1. 開啟模組:Twofish 演算法、ECB 模式 (無 IV)
    $td = mcrypt_module_open('twofish', '', 'ecb', '');
    if (!$td) throw new RuntimeException('無法開啟 mcrypt 模組: twofish');
    
    // 2. 取得金鑰長度並生成金鑰 (MD5 截取,非現代最佳實踐)
    $keySize = mcrypt_enc_get_key_size($td); // 32 bytes for Twofish-256
    $key = substr(md5($keyBase), 0, $keySize);
    
    // 3. ECB 模式不需要 IV,但 API 要求提供,建立空 IV
    $ivSize = mcrypt_enc_get_iv_size($td); // ECB 為 0
    $iv = $ivSize ? mcrypt_create_iv($ivSize, MCRYPT_RAND) : '';
    
    // 4. 初始化加密
    if (mcrypt_generic_init($td, $key, $iv) < 0) {
        throw new RuntimeException('加密初始化失敗');
    }
    
    // 5. 加密
    $encrypted = mcrypt_generic($td, $data);
    
    // 6. 解密初始化 (重新初始化相同參數)
    mcrypt_generic_deinit($td);
    mcrypt_generic_init($td, $key, $iv);
    
    // 7. 解密
    $decrypted = mdecrypt_generic($td, $encrypted);
    
    // 8. 清理
    mcrypt_generic_deinit($td);
    mcrypt_module_close($td);
    
    return [
        'encrypted' => $encrypted,
        'decrypted' => rtrim($decrypted, "\0"), // 移除 PKCS#7 padding 殘留
        'iv'        => $iv,
        'key'       => $key,
    ];
}

// 使用
$result = mcryptTwofishDemo('This is very important data');
echo "Encrypted (raw): " . bin2hex($result['encrypted']) . "\n";
echo "Decrypted: " . $result['decrypted'] . "\n";
?>

遷移指南:mcrypt → OpenSSL (AES-256-GCM 推薦)

<?php
/**
 * 現代標準加密:AES-256-GCM (Authenticated Encryption)
 * 
 * @param string $data 明文
 * @param string $key  32 位元組二進位金鑰 (可用 hash('sha256', $password, true) 衍生)
 * @return string Base64 編碼:IV(12) + Ciphertext + Tag(16)
 */
function encryptModern(string $data, string $key): string
{
    $iv = random_bytes(12); // GCM 建議 96-bit IV
    $ciphertext = openssl_encrypt($data, 'aes-256-gcm', $key, OPENSSL_RAW_DATA, $iv, $tag, '', 16);
    if ($ciphertext === false) throw new RuntimeException('加密失敗');
    // 組合:IV + Ciphertext + Tag
    return base64_encode($iv . $ciphertext . $tag);
}

/**
 * 現代標準解密
 */
function decryptModern(string $base64Payload, string $key): string
{
    $payload = base64_decode($base64Payload, true);
    if ($payload === false) throw new RuntimeException('Base64 解碼失敗');
    
    $iv = substr($payload, 0, 12);
    $tag = substr($payload, -16);
    $ciphertext = substr($payload, 12, -16);
    
    $decrypted = openssl_decrypt($ciphertext, 'aes-256-gcm', $key, OPENSSL_RAW_DATA, $iv, $tag, '', 16);
    if ($decrypted === false) throw new RuntimeException('解密失敗:資料可能被竄改或金鑰錯誤');
    return $decrypted;
}

// 使用
$key = random_bytes(32); // 實際應從 KMS/環境變數/密碼衍生函數 (PBKDF2/Argon2) 取得
$plaintext = '敏感資料:信用卡、身分證、API 金鑰...';
$encrypted = encryptModern($plaintext, $key);
$decrypted = decryptModern($encrypted, $key);
var_dump($plaintext === $decrypted); // true
?>

遷移對照表

mcryptOpenSSL / Sodium 替代備註
mcrypt_module_open('rijndael-128', '', 'cbc', '')openssl_encrypt($data, 'aes-256-cbc', $key, OPENSSL_RAW_DATA, $iv)AES = Rijndael-128 區塊大小,金鑰長度決定強度
mcrypt_module_open('twofish', '', 'ecb', '')無直接對應,建議遷移至 AES-256-GCMTwofish 非 NIST 標準,OpenSSL 不支援
mcrypt_create_iv($size, MCRYPT_DEV_URANDOM)random_bytes($size)CSPRNG,PHP 7+ 內建
mcrypt_enc_get_key_size()固定:AES-256 = 32 bytes
mdecrypt_generic()openssl_decrypt()

結語

mcrypt 歷史使命已畢。所有新專案、重構專案請直接採用 AES-256-GCM (OpenSSL) 或 XChaCha20-Poly1305 (Sodium),兩者均提供認證加密 (AEAD),同時保證機密性、完整性、真實性,且效能優異、硬體加速友善。舊專案若暫時無法遷移,請嚴格限制 mcrypt 使用範圍,並制定遷移時間表。

copyright © 萬盛學電腦網 all rights reserved