mcrypt 擴充自 PHP 7.1 棄用,PHP 7.2 移除核心,PHP 8.0 完全移除。
現代專案請改用 OpenSSL (openssl_encrypt/openssl_decrypt) 或 Sodium (sodium_crypto_*) 原生函數,兩者皆為 CSPRNG 級安全、標準化、長期維護。
若必須維護舊專案無法立即遷移,以下為標準流程:
<?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";
?>
<?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
?>
| mcrypt | OpenSSL / 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-GCM | Twofish 非 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 使用範圍,並制定遷移時間表。