PHP AES加解密工具类实现与安全注意事项

结果与目标

我们需要一个能够在PHP中使用的、具备以下特性的加解密工具：

• 可逆性：支持加密后通过特定密钥还原原始明文。
• 安全性基础：使用比MD5更安全的对称加密算法，避免明文直接存储。
• 易用性：提供简化的API，自动处理Base64编码以适配URL或数据库存储。

准备条件

该代码示例依赖于PHP传统的 MCRYPT 扩展。请注意：
- PHP 7.1.0起已默认移除该扩展。
- ECBC模式存在已知弱点，现代应用应优先选用CBC-GCM或AES-256-GCM等更安全的模式。

真实操作顺序

第1步：理解核心加密类结构

该类名为 Crypt，主要包含构造函数和四个核心方法：

1. __construct($key)：接收一个字符串密钥，并通过MD5哈希生成32字节的关键种子（skey），作为后续对称加密的主密钥。
2. safe_b64encode / safe_b64decode：自定义的Base64编解码函数。标准Base64字符 +, /, = 在URL或文件名中可能产生歧义，此方法将其替换为 -, _ 及去除填充符，提升数据在Web环境中的兼容性。
3. encode($value)：执行加密流程。
4. decode($value)：执行解密流程。

第2步：加密操作详解

调用 encode() 时，程序执行以下步骤：

1. 获取IV大小：使用 mcrypt_get_iv_size(MCRYPT_RIJNDAEL_256, MCRYPT_MODE_ECB) 获取初始化向量所需长度。注意：虽然此处调用了获取IV的接口，但在ECB模式中，初始化向量实际上未发挥其应有的混淆作用，每块独立加密。
2. 生成随机IV：使用 mcrypt_create_iv() 生成随机向量（尽管对于ECB来说，这步在严格意义上是多余的，但为了保持接口统一仍会执行）。
3. 执行加密：调用 mcrypt_encrypt()，指定算法为 MCRYPT_RIJNDAEL_256，模式为 MCRYPT_MODE_ECB。
4. 格式化输出：将二进制的密文进行Base64编码并经过Safe替换，返回最终字符串。

第3步：解密操作详解

调用 decode() 时，执行逆向过程：

1. 恢复Base64：通过 safe_b64decode() 将安全编码的字符串还原为标准Base64，再解码为二进制数据。
2. 重新生成IV：再次尝试生成一个新的随机IV。**重要风险点**：由于使用了ECB模式和随机IV，如果每次解密生成的IV与加密时不一致，且非ECB模式下会导致解密失败；而在纯ECB模式下，只要密钥正确，即使IV不匹配也能解密出乱码或错误明文。此旧版实现逻辑存在缺陷，现代AES-CBC/GCM必须严格复用加密时的IV。
3. 执行解密：调用 mcrypt_decrypt()。

第4步：完整代码实现

<?php
class Crypt {
    private $skey;

    public function __construct($key) {
        // 使用MD5将任意长度密钥转换为32字节的二进制密钥
        $this->skey = hash("md5", $key, true);
    }

    // 安全的Base64编码，替换特殊字符以适应URL/DB
    public function safe_b64encode($string) {
        $data = base64_encode($string);
        $data = str_replace(array('+', '/', '='), array('-', '_', ''), $data);
        return $data;
    }

    // 安全的Base64解码
    public function safe_b64decode($string) {
        $data = str_replace(array('-', '_'), array('+', '/'), $string);
        $mod4 = strlen($data) % 4;
        if ($mod4) {
            $data .= substr('====', $mod4);
        }
        return base64_decode($data);
    }

    // 加密入口
    public function encode($value) {
        if (!$value) {
            return false;
        }
        $text = $value;
        
        // 注意：MCRYPT扩展已在PHP 7.1+移除，且AES-256通常指代Rijndael-128块大小的变体
        // 这里保留了原始草稿中的 Rijndael_256 块大小选项
        $iv_size = mcrypt_get_iv_size(MCRYPT_RIJNDAEL_256, MCRYPT_MODE_ECB);
        $iv = mcrypt_create_iv($iv_size, MCRYPT_RAND);
        
        $crypttext = mcrypt_encrypt(MCRYPT_RIJNDAEL_256, $this->skey, $text, MCRYPT_MODE_ECB, $iv);
        
        return trim($this->safe_b64encode($crypttext));
    }

    // 解密入口
    public function decode($value) {
        if (!$value) {
            return false;
        }
        $crypttext = $this->safe_b64decode($value);
        
        $iv_size = mcrypt_get_iv_size(MCRYPT_RIJNDAEL_256, MCRYPT_MODE_ECB);
        $iv = mcrypt_create_iv($iv_size, MCRYPT_RAND); // ECB模式下IV影响有限，但代码保留此结构
        
        $decrypttext = mcrypt_decrypt(MCRYPT_RIJNDAEL_256, $this->skey, $crypttext, MCRYPT_MODE_ECB, $iv);
        
        return trim($decrypttext);
    }
}
?>

完成判断

验证类是否正常工作：实例化 Crypt 对象传入密钥 $crypt = new Crypt('my_secret_key');，调用 $encrypted = $crypt->encode('SensitiveData'); 获得密文，再调用 $decrypted = $crypt->decode($encrypted);。若 $decrypted 等于 'SensitiveData'，则加解密逻辑在当前环境中有效。

原文有依据的排错与现代替代建议

在实际应用中，上述经典代码面临三个主要问题，建议参考以下修复思路：

1. 扩展废弃：MCRYPT 已不再维护。请使用内置的 openssl_encrypt 和 openssl_decrypt 函数，或者更推荐的 sodium_crypto_secretbox。
2. ECB模式弱点：ECB模式不隐藏数据模式，相同的明文块会产生相同的密文块。务必改用 CBC、CFB 或 GCM 模式，并正确传递和存储IV（初始向量）。
3. 密钥管理：直接使用MD5截断作为AES密钥强度不足。建议使用 hash_pbkdf2 进行密钥派生，增强暴力破解难度。

简要总结

上述关于PHP加解密类的详细内容，更多关于开发安全与AES加密最佳实践的资料请关注本站其它相关文章！