PHP7.4移除mcrypt后 3DES加解密代码的OpenSSL替代方案咨询

核心适配要点 #

• 原代码中的IV生成逻辑完全无效：代码基于ECB模式做3DES加密，mcrypt在ECB模式下会直接丢弃传入的IV参数，重构时不需要保留随机IV的生成步骤，否则会破坏和历史存量密文的兼容性。
• 必须对齐mcrypt的密钥处理规则：mcrypt对3DES密钥的默认处理是截取传入密钥的前24字节，长度不足时用\0自动补全；OpenSSL不会自动做这个截断/补全操作，必须手动实现该逻辑，否则会出现解密失败。
• 填充规则天然匹配：原mcrypt实现采用PKCS7默认填充，和OpenSSL内置的des-ede3-ecb算法填充规则完全一致，不需要额外调整。

可直接替换的等价代码 #

/**
 * 3DES encryption
 *
 * @param string $plain Plaintext
 * @return string cipher Ciphertext
 */
public function encrypt3DES($plain) {
    // 对齐mcrypt的3DES密钥处理规则：截前24字节，不足补\0
    $key = substr(self::AUTH_KEY, 0, 24);
    $key = str_pad($key, 24, "\0");
    // ECB模式无有效IV，传空字符串即可
    $rawCipher = openssl_encrypt(
        $plain,
        'des-ede3-ecb',
        $key,
        OPENSSL_RAW_DATA
    );
    return bin2hex($rawCipher);
}

/**
 * 3DES decryption
 *
 * @param string $cipher Ciphertext
 * @return string Plaintext
 */
public function decrypt3DES($cipher) {
    if (!ctype_xdigit($cipher)) {
        return '';
    }
    // 对齐mcrypt的3DES密钥处理规则
    $key = substr(self::AUTH_KEY, 0, 24);
    $key = str_pad($key, 24, "\0");
    $rawCipher = pack("H*", $cipher);
    $plain = openssl_decrypt(
        $rawCipher,
        'des-ede3-ecb',
        $key,
        OPENSSL_RAW_DATA
    );
    return trim($plain);
}

上线注意事项

• 代码替换完成后，必须抽取历史存储的加密密文做解密验证，确认返回的明文和原系统结果完全一致再正式上线
• 不要照搬通用替换建议中给ECB模式配置随机IV的操作，ECB模式本身不依赖IV，额外加IV只会导致加解密逻辑错位，不会提升安全性
• 后续业务迭代阶段可以逐步将加密模式从安全性较弱的ECB迁移到CBC/GCM模式，但历史存量密文的兼容解密逻辑需要长期保留

内容的提问来源于stack exchange，提问作者scottie320