1. 项目概述为什么我们需要一个跨语言的AES方案在前后端分离、微服务架构大行其道的今天数据安全传输是每个开发者绕不开的坎。你可能遇到过这样的场景前端用JavaScript收集了用户的敏感表单数据需要安全地传给后端的PHP接口或者后端PHP生成了加密的令牌需要在前端JavaScript环境中安全地解析。这时候AES高级加密标准这种对称加密算法就成了首选因为它速度快、安全性高且是国际标准。但坑也随之而来。我见过不少团队PHP端用openssl_encrypt加密得挺好结果前端用CryptoJS一解密要么乱码要么直接报错。两边代码看起来都没问题但就是对不上。核心原因往往出在几个不起眼的细节上密钥和初始向量的编码方式、加密模式、填充方案甚至字符串到字节的转换过程任何一个环节不一致都会导致加解密失败。所以今天我们不谈空泛的理论直接上手构建一套能在PHP和JavaScript之间无缝协作的AES-256-CBC加解密方案。我会把每一步的原理、代码和踩过的坑都掰开揉碎了讲清楚让你不仅能“抄作业”更能明白背后的“所以然”。2. 核心原理与前置知识搞懂AES-CBC的“游戏规则”在动手写代码之前我们必须统一“游戏规则”。AES就像一个高度精密的保险箱你得知道正确的密码密钥、正确的开门方式模式与填充才能打开。2.1 AES-256-CBC模式详解我们选择AES-256-CBC这个组合这是目前非常常用且推荐的一种方式。AES-256指的是使用256位32字节的密钥。密钥越长暴力破解的难度呈指数级增长安全性越好。CBC模式Cipher Block Chaining密码分组链接模式。这是关键在CBC模式下每个明文块在加密前都会先与前一个密文块进行异或操作。第一个块没有前一个密文块怎么办这就需要IVInitialization Vector初始向量。重要提示IV不需要保密但必须不可预测且每次加密最好都使用随机生成的IV。同一个密钥下如果IV重复使用会带来安全风险。在我们的方案中IV会随着密文一起传输。2.2 关键参数Key和IV的生成与处理这是跨语言加解密最容易出错的地方。密钥Key必须是准确的32字节256位。你不能简单地用一个32个字符的字符串就认为它是32字节。如果这个字符串是UTF-8编码的中文或特殊字符其字节长度可能远超32。最安全、最兼容的做法是使用一个由ASCII字符或十六进制字符串组成的、恰好32字节的密钥。例如0123456789abcdef0123456789abcdef32个字符每个字符1字节。初始向量IV必须是16字节128位因为AES块大小是128位。和Key一样需要确保它是准确的16字节。openssl_random_pseudo_bytes(16)或CryptoJS.lib.WordArray.random(16)是生成随机IV的好方法。编码与解码网络传输和存储时二进制数据如加密后的字节、IV不方便处理。我们通常使用Base64或Hex十六进制进行编码。Base64更紧凑Hex更易于调试。我们的方案将统一使用Base64。2.3 填充方案PaddingAES是块加密算法一次处理一个固定大小的数据块16字节。如果你的明文不是16字节的整数倍就需要填充。PKCS#7 Padding是事实上的标准在AES的上下文中PKCS#5和PKCS#7是等价的。它会确保明文长度是块大小的整数倍。 例如一个15字节的数据PKCS#7会填充1个值为0x01的字节。一个16字节的数据则会填充一整个16字节的块每个字节值为0x10。幸运的是PHP的openssl_encrypt/decrypt默认使用PKCS#7填充而CryptoJS也明确支持CryptoJS.pad.Pkcs7。我们只需要在两端显式声明即可避免默认值不同导致的意外。3. PHP端AES加解密实现我们先从服务端PHP开始。确保你的PHP环境已启用OpenSSL扩展大多数环境默认已开启。3.1 基础加密函数我们将构建一个健壮的加密函数它负责生成随机IV并将其与密文一起返回。/** * 使用AES-256-CBC加密字符串 * param string $plaintext 待加密的明文 * param string $key 32字节的加密密钥 * return string 返回Base64编码的字符串格式为IV 密文 */ function aesEncrypt($plaintext, $key) { // 1. 检查密钥长度 if (strlen($key) ! 32) { throw new InvalidArgumentException(加密密钥必须为32字节256位。); } // 2. 选择加密算法和模式 $cipher aes-256-cbc; // 3. 生成随机初始向量 (IV) $ivLength openssl_cipher_iv_length($cipher); $iv openssl_random_pseudo_bytes($ivLength); // 4. 执行加密 // OPENSSL_RAW_DATA 选项告诉openssl返回原始字节流而不是Base64字符串。 // 我们稍后自己处理Base64以便将IV和密文拼接。 $ciphertext openssl_encrypt( $plaintext, $cipher, $key, OPENSSL_RAW_DATA, $iv ); // 5. 将IV和密文拼接然后整体进行Base64编码 // 这样解密方才能先拿到IV。 $combined $iv . $ciphertext; return base64_encode($combined); }关键点解析openssl_cipher_iv_length(‘aes-256-cbc’)会返回16这正是我们需要的。我们使用OPENSSL_RAW_DATA标志让函数返回原始的二进制密文而不是Base64。这样我们可以自由地将IV也是二进制和它拼接。最终输出一个Base64字符串其解码后的前16字节是IV后面才是真正的密文。3.2 基础解密函数解密是加密的逆过程我们需要从Base64字符串中分离出IV和密文。/** * 使用AES-256-CBC解密字符串 * param string $encryptedDataBase64 由aesEncrypt生成的Base64字符串 * param string $key 32字节的加密密钥必须与加密时相同 * return string 解密后的明文 * throws Exception */ function aesDecrypt($encryptedDataBase64, $key) { // 1. 检查密钥长度 if (strlen($key) ! 32) { throw new InvalidArgumentException(解密密钥必须为32字节256位。); } // 2. Base64解码得到原始二进制数据 $encryptedData base64_decode($encryptedDataBase64); if ($encryptedData false) { throw new Exception(Base64解码失败数据可能已损坏。); } // 3. 分离IV和密文 $cipher aes-256-cbc; $ivLength openssl_cipher_iv_length($cipher); if (strlen($encryptedData) $ivLength) { throw new Exception(加密数据长度无效无法提取IV。); } $iv substr($encryptedData, 0, $ivLength); $ciphertext substr($encryptedData, $ivLength); // 4. 执行解密 // 同样使用 OPENSSL_RAW_DATA因为密文是原始二进制。 $plaintext openssl_decrypt( $ciphertext, $cipher, $key, OPENSSL_RAW_DATA, $iv ); if ($plaintext false) { // openssl_decrypt失败可能原因密钥错误、IV错误、数据被篡改、填充错误 throw new Exception(解密失败。请检查密钥、IV或数据完整性。); } return $plaintext; }关键点解析解密的第一步是反向操作Base64解码然后按约定切分前16字节IV和后续部分密文。openssl_decrypt失败时返回false。务必进行错误处理这在调试跨语言问题时非常有用。3.3 实战测试与注意事项让我们写个简单的测试脚本?php // 定义密钥32字节ASCII字符串 $key this_is_a_32_byte_long_key_123456; // 正好32个字符 $originalData {user_id: 12345, name: 张三, secret: TopSecret123}; try { echo 原始数据: . $originalData . PHP_EOL; // 加密 $encrypted aesEncrypt($originalData, $key); echo 加密后 (Base64): . $encrypted . PHP_EOL; // 解密 $decrypted aesDecrypt($encrypted, $key); echo 解密后: . $decrypted . PHP_EOL; // 验证 if ($originalData $decrypted) { echo ✅ 加解密成功 . PHP_EOL; } else { echo ❌ 加解密失败数据不一致 . PHP_EOL; } } catch (Exception $e) { echo 出错: . $e-getMessage() . PHP_EOL; }实操心得与避坑指南密钥管理是命门绝对不要将密钥硬编码在客户端JavaScript代码中。前端代码是公开的密钥一旦暴露加密形同虚设。正确的做法是场景一前端加密后端解密由后端动态生成一次性密钥或基于会话的密钥通过安全通道如HTTPS传递给前端前端用其加密后随密文传回。后端自己知道密钥自然可以解密。场景二后端加密前端解密通常用于传递一些可公开但需防篡改的数据如令牌。密钥可以放在后端前端解密所需的“密钥”可能是一个派生值或者这个场景本身对密钥保密性要求不高因为数据本身非绝密。IV必须随机且唯一每次加密都使用openssl_random_pseudo_bytes生成新的IV。切勿使用固定IV。处理中文字符PHP字符串是二进制安全的。但如果你从数据库或文件读取的字符串编码不是UTF-8可能需要先用mb_convert_encoding进行转换确保加密前的明文是统一的UTF-8编码否则解密后可能出现乱码。4. JavaScript端AES加解密实现基于CryptoJS前端我们使用经典的CryptoJS库。你可以通过CDN引入或使用npm安装。4.1 引入CryptoJS最简单的方式是使用CDNscript srchttps://cdnjs.cloudflare.com/ajax/libs/crypto-js/4.1.1/crypto-js.min.js/script如果你使用ES6模块npm install crypto-js然后导入import CryptoJS from crypto-js;4.2 JavaScript加密函数我们需要实现一个与PHP端aesEncrypt行为完全一致的函数。/** * 使用AES-256-CBC加密字符串 (与PHP端匹配) * param {string} plaintext - 待加密的明文 * param {string} key - 32字节的加密密钥ASCII字符串 * returns {string} Base64编码的字符串格式为IV 密文 */ function jsAesEncrypt(plaintext, key) { // 1. 将UTF-8字符串密钥转换为CryptoJS可用的WordArray // CryptoJS.enc.Utf8.parse 会将字符串按UTF-8编码转换成WordArray。 // 关键我们的key是ASCII字符串UTF-8解析后长度依然是32字节。 const keyWordArray CryptoJS.enc.Utf8.parse(key); // 2. 生成随机IV (16字节) const ivWordArray CryptoJS.lib.WordArray.random(16); // 3. 执行加密 // 模式CBC 填充Pkcs7 (CryptoJS中叫Pkcs7) const encrypted CryptoJS.AES.encrypt(plaintext, keyWordArray, { iv: ivWordArray, mode: CryptoJS.mode.CBC, padding: CryptoJS.pad.Pkcs7 }); // 4. 组合IV和密文 // encrypted.ciphertext 是密文的WordArray。 // 我们需要将IV的WordArray和密文的WordArray拼接起来。 const ivBase64 CryptoJS.enc.Base64.stringify(ivWordArray); const ciphertextBase64 CryptoJS.enc.Base64.stringify(encrypted.ciphertext); // 5. 将IV和密文都是Base64直接拼接不对 // 我们需要的是二进制拼接后再整体Base64。更简单的方法 // 将IV和密文的WordArray直接拼接成一个新的WordArray然后整体转Base64。 const combinedWordArray ivWordArray.clone().concat(encrypted.ciphertext); const combinedBase64 CryptoJS.enc.Base64.stringify(combinedWordArray); return combinedBase64; }4.3 JavaScript解密函数同样实现与PHP端aesDecrypt对应的函数。/** * 使用AES-256-CBC解密字符串 (与PHP端匹配) * param {string} encryptedDataBase64 - 由jsAesEncrypt或PHP的aesEncrypt生成的Base64字符串 * param {string} key - 32字节的加密密钥ASCII字符串 * returns {string} 解密后的明文 */ function jsAesDecrypt(encryptedDataBase64, key) { // 1. 将密钥转换为WordArray const keyWordArray CryptoJS.enc.Utf8.parse(key); // 2. Base64解码整体数据 const combinedWordArray CryptoJS.enc.Base64.parse(encryptedDataBase64); // 3. 分离IV和密文 (IV是前16字节) // CryptoJS的WordArray以4字节一个Word为单位存储但.sigBytes属性是总字节数。 // 前16字节是IV。 const ivWordArray CryptoJS.lib.WordArray.create(combinedWordArray.words.slice(0, 4)); // 16 bytes 4 words ivWordArray.sigBytes 16; // 密文是剩余部分 const ciphertextWordArray CryptoJS.lib.WordArray.create(combinedWordArray.words.slice(4)); ciphertextWordArray.sigBytes combinedWordArray.sigBytes - 16; // 4. 将密文WordArray转换为CryptoJS的“密文对象”所需格式 const encryptedCipherParams CryptoJS.lib.CipherParams.create({ ciphertext: ciphertextWordArray }); // 5. 执行解密 const decrypted CryptoJS.AES.decrypt(encryptedCipherParams, keyWordArray, { iv: ivWordArray, mode: CryptoJS.mode.CBC, padding: CryptoJS.pad.Pkcs7 }); // 6. 将解密结果从WordArray转回UTF-8字符串 return decrypted.toString(CryptoJS.enc.Utf8); }关键点解析CryptoJS.enc.Utf8.parse(key)这是将字符串密钥转换为CryptoJS内部格式的关键一步。务必确保你传递给这个函数的密钥字符串与PHP端使用的密钥字符串完全一致包括字符和长度。CryptoJS.AES.encrypt默认返回一个包含密文、盐等信息的对象。我们通过encrypted.ciphertext直接获取密文的WordArray。拼接IV和密文时我们操作的是它们的WordArray形式最后统一进行Base64编码。这确保了二进制数据的精确拼接与PHP端的$iv . $ciphertext逻辑一致。解密时从组合数据中分离IV和密文是难点。我们通过操作WordArray的words数组每个元素4字节和sigBytes属性来精确分割。4.4 前端实战测试我们可以在浏览器控制台或Node.js环境中测试。!DOCTYPE html html head script srchttps://cdnjs.cloudflare.com/ajax/libs/crypto-js/4.1.1/crypto-js.min.js/script /head body script // 使用与PHP端完全相同的密钥 const key this_is_a_32_byte_long_key_123456; const originalData {user_id: 12345, name: 张三, secret: TopSecret123}; console.log(原始数据:, originalData); // 加密 const encrypted jsAesEncrypt(originalData, key); console.log(JS加密后 (Base64):, encrypted); // 解密 const decrypted jsAesDecrypt(encrypted, key); console.log(JS解密后:, decrypted); // 验证 if (originalData decrypted) { console.log(✅ JS自身加解密成功); } else { console.error(❌ JS自身加解密失败); } // 接下来可以尝试用这个 encrypted 变量调用PHP的 aesDecrypt 函数看是否能解密。 // 反之亦然将PHP加密的结果拿到这里用 jsAesDecrypt 解密。 /script /body /html5. 跨语言互操作性测试与调试这是验证我们方案是否成功的最终关卡。我们将进行双向测试PHP加密 - JS解密以及JS加密 - PHP解密。5.1 测试用例设计我们准备一个简单的JSON字符串作为测试数据包含中文、英文、数字和特殊字符确保编码兼容性。测试数据{test: Hello World 你好世界 123!#}统一密钥my_super_secret_key_32_bytes_12345.2 PHP加密JavaScript解密步骤1在PHP中执行加密?php // php_encrypt.php $key my_super_secret_key_32_bytes_1234; // 32字节 $data {test: Hello World 你好世界 123!#}; $encryptedFromPHP aesEncrypt($data, $key); echo $encryptedFromPHP; // 输出类似dGhpcyBpcyBhbiBJViBwbHVzIGNpcGhlcnRleHQ (实际会更长)步骤2在JavaScript中尝试解密将上面PHP输出的Base64字符串复制到JS解密函数中。const key my_super_secret_key_32_bytes_1234; const encryptedFromPHP 粘贴PHP输出的Base64字符串; // 例如dGhpcyBpcyBhbiBJViBwbHVzIGNpcGhlcnRleHQ try { const decryptedInJS jsAesDecrypt(encryptedFromPHP, key); console.log(JS解密PHP加密的结果:, decryptedInJS); // 应该输出: {test: Hello World 你好世界 123!#} } catch (e) { console.error(解密失败:, e); }5.3 JavaScript加密PHP解密步骤1在JavaScript中执行加密const key my_super_secret_key_32_bytes_1234; const data {test: Hello World 你好世界 123!#}; const encryptedFromJS jsAesEncrypt(data, key); console.log(JS加密结果:, encryptedFromJS);步骤2在PHP中尝试解密将JS控制台输出的Base64字符串复制到PHP解密脚本中。?php // php_decrypt.php $key my_super_secret_key_32_bytes_1234; $encryptedFromJS 粘贴JS输出的Base64字符串; try { $decryptedInPHP aesDecrypt($encryptedFromJS, $key); echo PHP解密JS加密的结果: . $decryptedInPHP . PHP_EOL; // 应该输出: {test: Hello World 你好世界 123!#} } catch (Exception $e) { echo 解密失败: . $e-getMessage() . PHP_EOL; }5.4 常见跨语言问题排查清单如果测试失败别慌按照以下清单逐一排查密钥不一致这是头号杀手。确保两边的密钥字符串一字不差包括大小写和空格。使用console.log(key.length)和echo strlen($key)检查长度是否为32。IV处理错误确保加密时IV是随机的并且解密时从正确的位置Base64解码后的前16字节提取了IV。可以打印/日志记录IV的Base64值进行对比。编码问题密钥和明文在传递给加密函数前确保它们是你认为的编码。对于简单ASCII密钥问题不大。但如果涉及非ASCII字符务必小心。强烈建议密钥使用纯ASCII字符。加密模式/填充不匹配我们明确指定了CBC模式和Pkcs7填充。检查两边是否都是这个配置。数据拼接方式PHP是$iv . $ciphertext然后整体Base64。JS也必须是IV_Words Ciphertext_Words然后整体Base64。任何顺序或编码的差异都会导致失败。CryptoJS版本不同版本的CryptoJS默认行为可能有细微差别。我们使用的是4.1.1版本并显式指定了所有参数以消除歧义。空格或换行符复制粘贴Base64字符串时可能会意外引入换行符或空格。确保传输的字符串是“干净”的。调试技巧在开发初期可以分别在PHP和JS的加密函数中打印出密钥长度、IV的Hex值、密文的Hex值。对比这些中间值能快速定位问题出在哪个环节。6. 进阶话题密钥管理与安全增强基础功能跑通后我们需要关注更重要的生产环境问题安全。6.1 密钥的安全存储与传递如前所述硬编码密钥在前端是致命的。这里提供几个更安全的思路方案A动态密钥推荐用于前端加密用户访问页面时后端PHP生成一个随机的、一次性的加密密钥和IV。通过HTTPS接口将这个密钥和IV或者一个能推导出它们的令牌传递给前端。可以考虑用RSA加密这个对称密钥后再传输。前端用这个临时密钥加密数据将密文和IV如果IV没包含在密钥里传回后端。后端用对应的密钥解密。该密钥仅在此次会话或请求中有效之后废弃。方案B基于会话的密钥派生用户登录后服务端生成一个会话IDSession ID。前后端使用相同的密钥派生函数KDF例如HKDF根据会话ID和服务器端的盐Salt派生出加密密钥。这样每个用户的加密密钥都不同且前端无需存储固定密钥密钥随着会话变化。6.2 使用HMAC进行完整性验证防篡改CBC模式能保证机密性但不能保证完整性。攻击者可能篡改密文导致解密出无意义但可能有害的数据。我们可以结合HMAC哈希消息认证码来验证数据完整性。流程如下加密密文 AES-Encrypt(数据)。生成HMAC认证标签 HMAC-SHA256(IV 密文, 另一个认证密钥)。注意这里把IV也包含进去计算HMAC防止IV被篡改。发送将Base64(IV 密文 认证标签)发送出去。接收验证接收方解码分离IV、密文、认证标签。用相同的认证密钥对收到的IV 密文重新计算HMAC。比较计算出的HMAC与收到的认证标签是否一致。不一致则说明数据被篡改直接拒绝。验证通过后再用AES解密密文。PHP和JavaScript都可以方便地计算HMAC。这为你的数据传输增加了一层重要的保护。6.3 性能考量与数据长度AES-256-CBC加密速度很快对于绝大多数Web应用场景性能开销可忽略不计。但需要注意如果加密非常大的数据如数MB的文件考虑在客户端进行分块加密或使用流式加密Web Crypto API可能更合适。Base64编码会使数据体积增加约33%。如果传输效率是瓶颈可以考虑使用纯二进制传输如ArrayBuffer但这需要前后端API支持。7. 完整工具类封装与使用示例为了方便使用我们将PHP和JavaScript两端的代码封装成易于调用的类/模块。7.1 PHP工具类封装?php // CryptoHelper.php class AesCrypto { const CIPHER aes-256-cbc; const KEY_LENGTH 32; const IV_LENGTH 16; // openssl_cipher_iv_length(self::CIPHER) 的结果 /** * 加密 * param string $plaintext * param string $key 32字节密钥 * return string Base64编码的密文 * throws InvalidArgumentException|RuntimeException */ public static function encrypt(string $plaintext, string $key): string { if (strlen($key) ! self::KEY_LENGTH) { throw new InvalidArgumentException(sprintf(密钥长度必须为%d字节。, self::KEY_LENGTH)); } $iv openssl_random_pseudo_bytes(self::IV_LENGTH); if ($iv false) { throw new RuntimeException(生成初始向量(IV)失败。); } $ciphertext openssl_encrypt( $plaintext, self::CIPHER, $key, OPENSSL_RAW_DATA, $iv ); if ($ciphertext false) { throw new RuntimeException(加密过程失败。); } return base64_encode($iv . $ciphertext); } /** * 解密 * param string $encryptedDataBase64 * param string $key 32字节密钥 * return string 明文 * throws InvalidArgumentException|RuntimeException */ public static function decrypt(string $encryptedDataBase64, string $key): string { if (strlen($key) ! self::KEY_LENGTH) { throw new InvalidArgumentException(sprintf(密钥长度必须为%d字节。, self::KEY_LENGTH)); } $rawData base64_decode($encryptedDataBase64, true); if ($rawData false) { throw new InvalidArgumentException(Base64数据解码失败。); } if (strlen($rawData) self::IV_LENGTH) { throw new InvalidArgumentException(加密数据过短无法提取IV。); } $iv substr($rawData, 0, self::IV_LENGTH); $ciphertext substr($rawData, self::IV_LENGTH); $plaintext openssl_decrypt( $ciphertext, self::CIPHER, $key, OPENSSL_RAW_DATA, $iv ); if ($plaintext false) { throw new RuntimeException(解密失败。请检查密钥或数据完整性。); } return $plaintext; } /** * 生成一个随机的32字节密钥Hex格式 * return string 64字符的十六进制字符串 */ public static function generateRandomKeyHex(): string { return bin2hex(openssl_random_pseudo_bytes(self::KEY_LENGTH)); } /** * 从Hex字符串获取密钥确保为32字节 * param string $hexKey * return string * throws InvalidArgumentException */ public static function getKeyFromHex(string $hexKey): string { $key hex2bin($hexKey); if ($key false || strlen($key) ! self::KEY_LENGTH) { throw new InvalidArgumentException(无效的Hex密钥转换后长度不为32字节。); } return $key; } }7.2 JavaScript工具类封装// aesCrypto.js // 依赖 CryptoJS const AesCrypto (function() { const CIPHER AES; const KEY_SIZE 256 / 32; // CryptoJS内部参数 const IV_LENGTH_BYTES 16; const MODE CryptoJS.mode.CBC; const PADDING CryptoJS.pad.Pkcs7; /** * 加密 * param {string} plaintext - 明文 * param {string} key - 32字节的UTF-8字符串密钥 * returns {string} Base64编码的密文 */ function encrypt(plaintext, key) { const keyWordArray CryptoJS.enc.Utf8.parse(key); const ivWordArray CryptoJS.lib.WordArray.random(IV_LENGTH_BYTES); const encrypted CryptoJS.AES.encrypt(plaintext, keyWordArray, { iv: ivWordArray, mode: MODE, padding: PADDING }); // 组合 IV 和密文 const combinedWordArray ivWordArray.clone().concat(encrypted.ciphertext); return CryptoJS.enc.Base64.stringify(combinedWordArray); } /** * 解密 * param {string} encryptedDataBase64 - Base64编码的密文 * param {string} key - 32字节的UTF-8字符串密钥 * returns {string} 明文 */ function decrypt(encryptedDataBase64, key) { const keyWordArray CryptoJS.enc.Utf8.parse(key); // 解码并分离IV和密文 const combinedWordArray CryptoJS.enc.Base64.parse(encryptedDataBase64); const ivWords combinedWordArray.words.slice(0, 4); // 16 bytes 4 words const ciphertextWords combinedWordArray.words.slice(4); const ivWordArray CryptoJS.lib.WordArray.create(ivWords); ivWordArray.sigBytes IV_LENGTH_BYTES; const ciphertextWordArray CryptoJS.lib.WordArray.create(ciphertextWords); ciphertextWordArray.sigBytes combinedWordArray.sigBytes - IV_LENGTH_BYTES; const cipherParams CryptoJS.lib.CipherParams.create({ ciphertext: ciphertextWordArray }); const decrypted CryptoJS.AES.decrypt(cipherParams, keyWordArray, { iv: ivWordArray, mode: MODE, padding: PADDING }); return decrypted.toString(CryptoJS.enc.Utf8); } /** * 生成随机密钥Hex格式64字符 * returns {string} */ function generateRandomKeyHex() { const randomBytes CryptoJS.lib.WordArray.random(KEY_SIZE * 4); // 32 bytes return CryptoJS.enc.Hex.stringify(randomBytes); } return { encrypt, decrypt, generateRandomKeyHex }; })(); // 导出供模块化使用 // export { AesCrypto }; // 如果使用ES6模块7.3 综合使用示例假设我们有一个用户登录场景前端需要加密密码后再传输。前端 (JavaScript):// 1. 从安全接口获取一次性密钥这里模拟 // 实际中这个请求应由后端发起并用RSA等方式加密传输这个对称密钥。 async function getEncryptionKeyFromServer() { const resp await fetch(/api/get-encryption-key); const data await resp.json(); // 假设返回 { key: ..., iv: ... } 或一个加密过的令牌 return data.tempKey; // 这是一个Base64或Hex编码的密钥 } // 2. 加密并提交表单 async function submitLoginForm(username, password) { const tempKeyHex await getEncryptionKeyFromServer(); // 将Hex密钥转换为CryptoJS可用的格式我们的工具类接受UTF-8字符串密钥 // 注意如果后端返回的是Hex我们需要将其作为字符串传递但确保它是有效的32字节。 // 更安全的做法是后端返回Base64前端解码为WordArray。 const key CryptoJS.enc.Hex.parse(tempKeyHex).toString(CryptoJS.enc.Utf8); // 转换示例 const loginData { username: username, password: password, timestamp: Date.now() }; const plaintext JSON.stringify(loginData); const encryptedData AesCrypto.encrypt(plaintext, key); // 发送加密后的数据到服务器 const response await fetch(/api/login, { method: POST, headers: { Content-Type: application/json }, body: JSON.stringify({ encrypted: encryptedData, keyId: 本次会话的密钥标识 }) }); return response.json(); }后端 (PHP):// api/login.php require_once CryptoHelper.php; // 假设通过密钥标识从缓存如Redis中获取本次会话使用的真实密钥 $keyId $_POST[keyId] ?? ; $encryptedDataBase64 $_POST[encrypted] ?? ; $realKey $cache-get(encryption_key: . $keyId); // 从缓存获取密钥 if (!$realKey) { http_response_code(401); echo json_encode([error 无效或过期的会话密钥]); exit; } try { $decryptedJson AesCrypto::decrypt($encryptedDataBase64, $realKey); $loginData json_decode($decryptedJson, true); // 验证时间戳防止重放攻击可选 $timestamp $loginData[timestamp] ?? 0; if (abs(time() - intval($timestamp / 1000)) 300) { // 允许5分钟误差 throw new Exception(请求已过期); } // 进行正常的用户名密码验证... $username $loginData[username]; $password $loginData[password]; // ... 验证逻辑 ... echo json_encode([success true, token ...]); } catch (Exception $e) { http_response_code(400); echo json_encode([error 解密失败或数据无效: . $e-getMessage()]); }这套完整的方案从原理、实现、调试到安全实践应该能覆盖你在PHP和JavaScript间实现AES加解密的大部分需求。记住安全是一个过程而不是一个结果。在理解工具的基础上结合具体的业务场景设计安全的密钥管理流程才能真正守护好数据。
1. 项目概述为什么我们需要一个跨语言的AES方案在前后端分离、微服务架构大行其道的今天数据安全传输是每个开发者绕不开的坎。你可能遇到过这样的场景前端用JavaScript收集了用户的敏感表单数据需要安全地传给后端的PHP接口或者后端PHP生成了加密的令牌需要在前端JavaScript环境中安全地解析。这时候AES高级加密标准这种对称加密算法就成了首选因为它速度快、安全性高且是国际标准。但坑也随之而来。我见过不少团队PHP端用openssl_encrypt加密得挺好结果前端用CryptoJS一解密要么乱码要么直接报错。两边代码看起来都没问题但就是对不上。核心原因往往出在几个不起眼的细节上密钥和初始向量的编码方式、加密模式、填充方案甚至字符串到字节的转换过程任何一个环节不一致都会导致加解密失败。所以今天我们不谈空泛的理论直接上手构建一套能在PHP和JavaScript之间无缝协作的AES-256-CBC加解密方案。我会把每一步的原理、代码和踩过的坑都掰开揉碎了讲清楚让你不仅能“抄作业”更能明白背后的“所以然”。2. 核心原理与前置知识搞懂AES-CBC的“游戏规则”在动手写代码之前我们必须统一“游戏规则”。AES就像一个高度精密的保险箱你得知道正确的密码密钥、正确的开门方式模式与填充才能打开。2.1 AES-256-CBC模式详解我们选择AES-256-CBC这个组合这是目前非常常用且推荐的一种方式。AES-256指的是使用256位32字节的密钥。密钥越长暴力破解的难度呈指数级增长安全性越好。CBC模式Cipher Block Chaining密码分组链接模式。这是关键在CBC模式下每个明文块在加密前都会先与前一个密文块进行异或操作。第一个块没有前一个密文块怎么办这就需要IVInitialization Vector初始向量。重要提示IV不需要保密但必须不可预测且每次加密最好都使用随机生成的IV。同一个密钥下如果IV重复使用会带来安全风险。在我们的方案中IV会随着密文一起传输。2.2 关键参数Key和IV的生成与处理这是跨语言加解密最容易出错的地方。密钥Key必须是准确的32字节256位。你不能简单地用一个32个字符的字符串就认为它是32字节。如果这个字符串是UTF-8编码的中文或特殊字符其字节长度可能远超32。最安全、最兼容的做法是使用一个由ASCII字符或十六进制字符串组成的、恰好32字节的密钥。例如0123456789abcdef0123456789abcdef32个字符每个字符1字节。初始向量IV必须是16字节128位因为AES块大小是128位。和Key一样需要确保它是准确的16字节。openssl_random_pseudo_bytes(16)或CryptoJS.lib.WordArray.random(16)是生成随机IV的好方法。编码与解码网络传输和存储时二进制数据如加密后的字节、IV不方便处理。我们通常使用Base64或Hex十六进制进行编码。Base64更紧凑Hex更易于调试。我们的方案将统一使用Base64。2.3 填充方案PaddingAES是块加密算法一次处理一个固定大小的数据块16字节。如果你的明文不是16字节的整数倍就需要填充。PKCS#7 Padding是事实上的标准在AES的上下文中PKCS#5和PKCS#7是等价的。它会确保明文长度是块大小的整数倍。 例如一个15字节的数据PKCS#7会填充1个值为0x01的字节。一个16字节的数据则会填充一整个16字节的块每个字节值为0x10。幸运的是PHP的openssl_encrypt/decrypt默认使用PKCS#7填充而CryptoJS也明确支持CryptoJS.pad.Pkcs7。我们只需要在两端显式声明即可避免默认值不同导致的意外。3. PHP端AES加解密实现我们先从服务端PHP开始。确保你的PHP环境已启用OpenSSL扩展大多数环境默认已开启。3.1 基础加密函数我们将构建一个健壮的加密函数它负责生成随机IV并将其与密文一起返回。/** * 使用AES-256-CBC加密字符串 * param string $plaintext 待加密的明文 * param string $key 32字节的加密密钥 * return string 返回Base64编码的字符串格式为IV 密文 */ function aesEncrypt($plaintext, $key) { // 1. 检查密钥长度 if (strlen($key) ! 32) { throw new InvalidArgumentException(加密密钥必须为32字节256位。); } // 2. 选择加密算法和模式 $cipher aes-256-cbc; // 3. 生成随机初始向量 (IV) $ivLength openssl_cipher_iv_length($cipher); $iv openssl_random_pseudo_bytes($ivLength); // 4. 执行加密 // OPENSSL_RAW_DATA 选项告诉openssl返回原始字节流而不是Base64字符串。 // 我们稍后自己处理Base64以便将IV和密文拼接。 $ciphertext openssl_encrypt( $plaintext, $cipher, $key, OPENSSL_RAW_DATA, $iv ); // 5. 将IV和密文拼接然后整体进行Base64编码 // 这样解密方才能先拿到IV。 $combined $iv . $ciphertext; return base64_encode($combined); }关键点解析openssl_cipher_iv_length(‘aes-256-cbc’)会返回16这正是我们需要的。我们使用OPENSSL_RAW_DATA标志让函数返回原始的二进制密文而不是Base64。这样我们可以自由地将IV也是二进制和它拼接。最终输出一个Base64字符串其解码后的前16字节是IV后面才是真正的密文。3.2 基础解密函数解密是加密的逆过程我们需要从Base64字符串中分离出IV和密文。/** * 使用AES-256-CBC解密字符串 * param string $encryptedDataBase64 由aesEncrypt生成的Base64字符串 * param string $key 32字节的加密密钥必须与加密时相同 * return string 解密后的明文 * throws Exception */ function aesDecrypt($encryptedDataBase64, $key) { // 1. 检查密钥长度 if (strlen($key) ! 32) { throw new InvalidArgumentException(解密密钥必须为32字节256位。); } // 2. Base64解码得到原始二进制数据 $encryptedData base64_decode($encryptedDataBase64); if ($encryptedData false) { throw new Exception(Base64解码失败数据可能已损坏。); } // 3. 分离IV和密文 $cipher aes-256-cbc; $ivLength openssl_cipher_iv_length($cipher); if (strlen($encryptedData) $ivLength) { throw new Exception(加密数据长度无效无法提取IV。); } $iv substr($encryptedData, 0, $ivLength); $ciphertext substr($encryptedData, $ivLength); // 4. 执行解密 // 同样使用 OPENSSL_RAW_DATA因为密文是原始二进制。 $plaintext openssl_decrypt( $ciphertext, $cipher, $key, OPENSSL_RAW_DATA, $iv ); if ($plaintext false) { // openssl_decrypt失败可能原因密钥错误、IV错误、数据被篡改、填充错误 throw new Exception(解密失败。请检查密钥、IV或数据完整性。); } return $plaintext; }关键点解析解密的第一步是反向操作Base64解码然后按约定切分前16字节IV和后续部分密文。openssl_decrypt失败时返回false。务必进行错误处理这在调试跨语言问题时非常有用。3.3 实战测试与注意事项让我们写个简单的测试脚本?php // 定义密钥32字节ASCII字符串 $key this_is_a_32_byte_long_key_123456; // 正好32个字符 $originalData {user_id: 12345, name: 张三, secret: TopSecret123}; try { echo 原始数据: . $originalData . PHP_EOL; // 加密 $encrypted aesEncrypt($originalData, $key); echo 加密后 (Base64): . $encrypted . PHP_EOL; // 解密 $decrypted aesDecrypt($encrypted, $key); echo 解密后: . $decrypted . PHP_EOL; // 验证 if ($originalData $decrypted) { echo ✅ 加解密成功 . PHP_EOL; } else { echo ❌ 加解密失败数据不一致 . PHP_EOL; } } catch (Exception $e) { echo 出错: . $e-getMessage() . PHP_EOL; }实操心得与避坑指南密钥管理是命门绝对不要将密钥硬编码在客户端JavaScript代码中。前端代码是公开的密钥一旦暴露加密形同虚设。正确的做法是场景一前端加密后端解密由后端动态生成一次性密钥或基于会话的密钥通过安全通道如HTTPS传递给前端前端用其加密后随密文传回。后端自己知道密钥自然可以解密。场景二后端加密前端解密通常用于传递一些可公开但需防篡改的数据如令牌。密钥可以放在后端前端解密所需的“密钥”可能是一个派生值或者这个场景本身对密钥保密性要求不高因为数据本身非绝密。IV必须随机且唯一每次加密都使用openssl_random_pseudo_bytes生成新的IV。切勿使用固定IV。处理中文字符PHP字符串是二进制安全的。但如果你从数据库或文件读取的字符串编码不是UTF-8可能需要先用mb_convert_encoding进行转换确保加密前的明文是统一的UTF-8编码否则解密后可能出现乱码。4. JavaScript端AES加解密实现基于CryptoJS前端我们使用经典的CryptoJS库。你可以通过CDN引入或使用npm安装。4.1 引入CryptoJS最简单的方式是使用CDNscript srchttps://cdnjs.cloudflare.com/ajax/libs/crypto-js/4.1.1/crypto-js.min.js/script如果你使用ES6模块npm install crypto-js然后导入import CryptoJS from crypto-js;4.2 JavaScript加密函数我们需要实现一个与PHP端aesEncrypt行为完全一致的函数。/** * 使用AES-256-CBC加密字符串 (与PHP端匹配) * param {string} plaintext - 待加密的明文 * param {string} key - 32字节的加密密钥ASCII字符串 * returns {string} Base64编码的字符串格式为IV 密文 */ function jsAesEncrypt(plaintext, key) { // 1. 将UTF-8字符串密钥转换为CryptoJS可用的WordArray // CryptoJS.enc.Utf8.parse 会将字符串按UTF-8编码转换成WordArray。 // 关键我们的key是ASCII字符串UTF-8解析后长度依然是32字节。 const keyWordArray CryptoJS.enc.Utf8.parse(key); // 2. 生成随机IV (16字节) const ivWordArray CryptoJS.lib.WordArray.random(16); // 3. 执行加密 // 模式CBC 填充Pkcs7 (CryptoJS中叫Pkcs7) const encrypted CryptoJS.AES.encrypt(plaintext, keyWordArray, { iv: ivWordArray, mode: CryptoJS.mode.CBC, padding: CryptoJS.pad.Pkcs7 }); // 4. 组合IV和密文 // encrypted.ciphertext 是密文的WordArray。 // 我们需要将IV的WordArray和密文的WordArray拼接起来。 const ivBase64 CryptoJS.enc.Base64.stringify(ivWordArray); const ciphertextBase64 CryptoJS.enc.Base64.stringify(encrypted.ciphertext); // 5. 将IV和密文都是Base64直接拼接不对 // 我们需要的是二进制拼接后再整体Base64。更简单的方法 // 将IV和密文的WordArray直接拼接成一个新的WordArray然后整体转Base64。 const combinedWordArray ivWordArray.clone().concat(encrypted.ciphertext); const combinedBase64 CryptoJS.enc.Base64.stringify(combinedWordArray); return combinedBase64; }4.3 JavaScript解密函数同样实现与PHP端aesDecrypt对应的函数。/** * 使用AES-256-CBC解密字符串 (与PHP端匹配) * param {string} encryptedDataBase64 - 由jsAesEncrypt或PHP的aesEncrypt生成的Base64字符串 * param {string} key - 32字节的加密密钥ASCII字符串 * returns {string} 解密后的明文 */ function jsAesDecrypt(encryptedDataBase64, key) { // 1. 将密钥转换为WordArray const keyWordArray CryptoJS.enc.Utf8.parse(key); // 2. Base64解码整体数据 const combinedWordArray CryptoJS.enc.Base64.parse(encryptedDataBase64); // 3. 分离IV和密文 (IV是前16字节) // CryptoJS的WordArray以4字节一个Word为单位存储但.sigBytes属性是总字节数。 // 前16字节是IV。 const ivWordArray CryptoJS.lib.WordArray.create(combinedWordArray.words.slice(0, 4)); // 16 bytes 4 words ivWordArray.sigBytes 16; // 密文是剩余部分 const ciphertextWordArray CryptoJS.lib.WordArray.create(combinedWordArray.words.slice(4)); ciphertextWordArray.sigBytes combinedWordArray.sigBytes - 16; // 4. 将密文WordArray转换为CryptoJS的“密文对象”所需格式 const encryptedCipherParams CryptoJS.lib.CipherParams.create({ ciphertext: ciphertextWordArray }); // 5. 执行解密 const decrypted CryptoJS.AES.decrypt(encryptedCipherParams, keyWordArray, { iv: ivWordArray, mode: CryptoJS.mode.CBC, padding: CryptoJS.pad.Pkcs7 }); // 6. 将解密结果从WordArray转回UTF-8字符串 return decrypted.toString(CryptoJS.enc.Utf8); }关键点解析CryptoJS.enc.Utf8.parse(key)这是将字符串密钥转换为CryptoJS内部格式的关键一步。务必确保你传递给这个函数的密钥字符串与PHP端使用的密钥字符串完全一致包括字符和长度。CryptoJS.AES.encrypt默认返回一个包含密文、盐等信息的对象。我们通过encrypted.ciphertext直接获取密文的WordArray。拼接IV和密文时我们操作的是它们的WordArray形式最后统一进行Base64编码。这确保了二进制数据的精确拼接与PHP端的$iv . $ciphertext逻辑一致。解密时从组合数据中分离IV和密文是难点。我们通过操作WordArray的words数组每个元素4字节和sigBytes属性来精确分割。4.4 前端实战测试我们可以在浏览器控制台或Node.js环境中测试。!DOCTYPE html html head script srchttps://cdnjs.cloudflare.com/ajax/libs/crypto-js/4.1.1/crypto-js.min.js/script /head body script // 使用与PHP端完全相同的密钥 const key this_is_a_32_byte_long_key_123456; const originalData {user_id: 12345, name: 张三, secret: TopSecret123}; console.log(原始数据:, originalData); // 加密 const encrypted jsAesEncrypt(originalData, key); console.log(JS加密后 (Base64):, encrypted); // 解密 const decrypted jsAesDecrypt(encrypted, key); console.log(JS解密后:, decrypted); // 验证 if (originalData decrypted) { console.log(✅ JS自身加解密成功); } else { console.error(❌ JS自身加解密失败); } // 接下来可以尝试用这个 encrypted 变量调用PHP的 aesDecrypt 函数看是否能解密。 // 反之亦然将PHP加密的结果拿到这里用 jsAesDecrypt 解密。 /script /body /html5. 跨语言互操作性测试与调试这是验证我们方案是否成功的最终关卡。我们将进行双向测试PHP加密 - JS解密以及JS加密 - PHP解密。5.1 测试用例设计我们准备一个简单的JSON字符串作为测试数据包含中文、英文、数字和特殊字符确保编码兼容性。测试数据{test: Hello World 你好世界 123!#}统一密钥my_super_secret_key_32_bytes_12345.2 PHP加密JavaScript解密步骤1在PHP中执行加密?php // php_encrypt.php $key my_super_secret_key_32_bytes_1234; // 32字节 $data {test: Hello World 你好世界 123!#}; $encryptedFromPHP aesEncrypt($data, $key); echo $encryptedFromPHP; // 输出类似dGhpcyBpcyBhbiBJViBwbHVzIGNpcGhlcnRleHQ (实际会更长)步骤2在JavaScript中尝试解密将上面PHP输出的Base64字符串复制到JS解密函数中。const key my_super_secret_key_32_bytes_1234; const encryptedFromPHP 粘贴PHP输出的Base64字符串; // 例如dGhpcyBpcyBhbiBJViBwbHVzIGNpcGhlcnRleHQ try { const decryptedInJS jsAesDecrypt(encryptedFromPHP, key); console.log(JS解密PHP加密的结果:, decryptedInJS); // 应该输出: {test: Hello World 你好世界 123!#} } catch (e) { console.error(解密失败:, e); }5.3 JavaScript加密PHP解密步骤1在JavaScript中执行加密const key my_super_secret_key_32_bytes_1234; const data {test: Hello World 你好世界 123!#}; const encryptedFromJS jsAesEncrypt(data, key); console.log(JS加密结果:, encryptedFromJS);步骤2在PHP中尝试解密将JS控制台输出的Base64字符串复制到PHP解密脚本中。?php // php_decrypt.php $key my_super_secret_key_32_bytes_1234; $encryptedFromJS 粘贴JS输出的Base64字符串; try { $decryptedInPHP aesDecrypt($encryptedFromJS, $key); echo PHP解密JS加密的结果: . $decryptedInPHP . PHP_EOL; // 应该输出: {test: Hello World 你好世界 123!#} } catch (Exception $e) { echo 解密失败: . $e-getMessage() . PHP_EOL; }5.4 常见跨语言问题排查清单如果测试失败别慌按照以下清单逐一排查密钥不一致这是头号杀手。确保两边的密钥字符串一字不差包括大小写和空格。使用console.log(key.length)和echo strlen($key)检查长度是否为32。IV处理错误确保加密时IV是随机的并且解密时从正确的位置Base64解码后的前16字节提取了IV。可以打印/日志记录IV的Base64值进行对比。编码问题密钥和明文在传递给加密函数前确保它们是你认为的编码。对于简单ASCII密钥问题不大。但如果涉及非ASCII字符务必小心。强烈建议密钥使用纯ASCII字符。加密模式/填充不匹配我们明确指定了CBC模式和Pkcs7填充。检查两边是否都是这个配置。数据拼接方式PHP是$iv . $ciphertext然后整体Base64。JS也必须是IV_Words Ciphertext_Words然后整体Base64。任何顺序或编码的差异都会导致失败。CryptoJS版本不同版本的CryptoJS默认行为可能有细微差别。我们使用的是4.1.1版本并显式指定了所有参数以消除歧义。空格或换行符复制粘贴Base64字符串时可能会意外引入换行符或空格。确保传输的字符串是“干净”的。调试技巧在开发初期可以分别在PHP和JS的加密函数中打印出密钥长度、IV的Hex值、密文的Hex值。对比这些中间值能快速定位问题出在哪个环节。6. 进阶话题密钥管理与安全增强基础功能跑通后我们需要关注更重要的生产环境问题安全。6.1 密钥的安全存储与传递如前所述硬编码密钥在前端是致命的。这里提供几个更安全的思路方案A动态密钥推荐用于前端加密用户访问页面时后端PHP生成一个随机的、一次性的加密密钥和IV。通过HTTPS接口将这个密钥和IV或者一个能推导出它们的令牌传递给前端。可以考虑用RSA加密这个对称密钥后再传输。前端用这个临时密钥加密数据将密文和IV如果IV没包含在密钥里传回后端。后端用对应的密钥解密。该密钥仅在此次会话或请求中有效之后废弃。方案B基于会话的密钥派生用户登录后服务端生成一个会话IDSession ID。前后端使用相同的密钥派生函数KDF例如HKDF根据会话ID和服务器端的盐Salt派生出加密密钥。这样每个用户的加密密钥都不同且前端无需存储固定密钥密钥随着会话变化。6.2 使用HMAC进行完整性验证防篡改CBC模式能保证机密性但不能保证完整性。攻击者可能篡改密文导致解密出无意义但可能有害的数据。我们可以结合HMAC哈希消息认证码来验证数据完整性。流程如下加密密文 AES-Encrypt(数据)。生成HMAC认证标签 HMAC-SHA256(IV 密文, 另一个认证密钥)。注意这里把IV也包含进去计算HMAC防止IV被篡改。发送将Base64(IV 密文 认证标签)发送出去。接收验证接收方解码分离IV、密文、认证标签。用相同的认证密钥对收到的IV 密文重新计算HMAC。比较计算出的HMAC与收到的认证标签是否一致。不一致则说明数据被篡改直接拒绝。验证通过后再用AES解密密文。PHP和JavaScript都可以方便地计算HMAC。这为你的数据传输增加了一层重要的保护。6.3 性能考量与数据长度AES-256-CBC加密速度很快对于绝大多数Web应用场景性能开销可忽略不计。但需要注意如果加密非常大的数据如数MB的文件考虑在客户端进行分块加密或使用流式加密Web Crypto API可能更合适。Base64编码会使数据体积增加约33%。如果传输效率是瓶颈可以考虑使用纯二进制传输如ArrayBuffer但这需要前后端API支持。7. 完整工具类封装与使用示例为了方便使用我们将PHP和JavaScript两端的代码封装成易于调用的类/模块。7.1 PHP工具类封装?php // CryptoHelper.php class AesCrypto { const CIPHER aes-256-cbc; const KEY_LENGTH 32; const IV_LENGTH 16; // openssl_cipher_iv_length(self::CIPHER) 的结果 /** * 加密 * param string $plaintext * param string $key 32字节密钥 * return string Base64编码的密文 * throws InvalidArgumentException|RuntimeException */ public static function encrypt(string $plaintext, string $key): string { if (strlen($key) ! self::KEY_LENGTH) { throw new InvalidArgumentException(sprintf(密钥长度必须为%d字节。, self::KEY_LENGTH)); } $iv openssl_random_pseudo_bytes(self::IV_LENGTH); if ($iv false) { throw new RuntimeException(生成初始向量(IV)失败。); } $ciphertext openssl_encrypt( $plaintext, self::CIPHER, $key, OPENSSL_RAW_DATA, $iv ); if ($ciphertext false) { throw new RuntimeException(加密过程失败。); } return base64_encode($iv . $ciphertext); } /** * 解密 * param string $encryptedDataBase64 * param string $key 32字节密钥 * return string 明文 * throws InvalidArgumentException|RuntimeException */ public static function decrypt(string $encryptedDataBase64, string $key): string { if (strlen($key) ! self::KEY_LENGTH) { throw new InvalidArgumentException(sprintf(密钥长度必须为%d字节。, self::KEY_LENGTH)); } $rawData base64_decode($encryptedDataBase64, true); if ($rawData false) { throw new InvalidArgumentException(Base64数据解码失败。); } if (strlen($rawData) self::IV_LENGTH) { throw new InvalidArgumentException(加密数据过短无法提取IV。); } $iv substr($rawData, 0, self::IV_LENGTH); $ciphertext substr($rawData, self::IV_LENGTH); $plaintext openssl_decrypt( $ciphertext, self::CIPHER, $key, OPENSSL_RAW_DATA, $iv ); if ($plaintext false) { throw new RuntimeException(解密失败。请检查密钥或数据完整性。); } return $plaintext; } /** * 生成一个随机的32字节密钥Hex格式 * return string 64字符的十六进制字符串 */ public static function generateRandomKeyHex(): string { return bin2hex(openssl_random_pseudo_bytes(self::KEY_LENGTH)); } /** * 从Hex字符串获取密钥确保为32字节 * param string $hexKey * return string * throws InvalidArgumentException */ public static function getKeyFromHex(string $hexKey): string { $key hex2bin($hexKey); if ($key false || strlen($key) ! self::KEY_LENGTH) { throw new InvalidArgumentException(无效的Hex密钥转换后长度不为32字节。); } return $key; } }7.2 JavaScript工具类封装// aesCrypto.js // 依赖 CryptoJS const AesCrypto (function() { const CIPHER AES; const KEY_SIZE 256 / 32; // CryptoJS内部参数 const IV_LENGTH_BYTES 16; const MODE CryptoJS.mode.CBC; const PADDING CryptoJS.pad.Pkcs7; /** * 加密 * param {string} plaintext - 明文 * param {string} key - 32字节的UTF-8字符串密钥 * returns {string} Base64编码的密文 */ function encrypt(plaintext, key) { const keyWordArray CryptoJS.enc.Utf8.parse(key); const ivWordArray CryptoJS.lib.WordArray.random(IV_LENGTH_BYTES); const encrypted CryptoJS.AES.encrypt(plaintext, keyWordArray, { iv: ivWordArray, mode: MODE, padding: PADDING }); // 组合 IV 和密文 const combinedWordArray ivWordArray.clone().concat(encrypted.ciphertext); return CryptoJS.enc.Base64.stringify(combinedWordArray); } /** * 解密 * param {string} encryptedDataBase64 - Base64编码的密文 * param {string} key - 32字节的UTF-8字符串密钥 * returns {string} 明文 */ function decrypt(encryptedDataBase64, key) { const keyWordArray CryptoJS.enc.Utf8.parse(key); // 解码并分离IV和密文 const combinedWordArray CryptoJS.enc.Base64.parse(encryptedDataBase64); const ivWords combinedWordArray.words.slice(0, 4); // 16 bytes 4 words const ciphertextWords combinedWordArray.words.slice(4); const ivWordArray CryptoJS.lib.WordArray.create(ivWords); ivWordArray.sigBytes IV_LENGTH_BYTES; const ciphertextWordArray CryptoJS.lib.WordArray.create(ciphertextWords); ciphertextWordArray.sigBytes combinedWordArray.sigBytes - IV_LENGTH_BYTES; const cipherParams CryptoJS.lib.CipherParams.create({ ciphertext: ciphertextWordArray }); const decrypted CryptoJS.AES.decrypt(cipherParams, keyWordArray, { iv: ivWordArray, mode: MODE, padding: PADDING }); return decrypted.toString(CryptoJS.enc.Utf8); } /** * 生成随机密钥Hex格式64字符 * returns {string} */ function generateRandomKeyHex() { const randomBytes CryptoJS.lib.WordArray.random(KEY_SIZE * 4); // 32 bytes return CryptoJS.enc.Hex.stringify(randomBytes); } return { encrypt, decrypt, generateRandomKeyHex }; })(); // 导出供模块化使用 // export { AesCrypto }; // 如果使用ES6模块7.3 综合使用示例假设我们有一个用户登录场景前端需要加密密码后再传输。前端 (JavaScript):// 1. 从安全接口获取一次性密钥这里模拟 // 实际中这个请求应由后端发起并用RSA等方式加密传输这个对称密钥。 async function getEncryptionKeyFromServer() { const resp await fetch(/api/get-encryption-key); const data await resp.json(); // 假设返回 { key: ..., iv: ... } 或一个加密过的令牌 return data.tempKey; // 这是一个Base64或Hex编码的密钥 } // 2. 加密并提交表单 async function submitLoginForm(username, password) { const tempKeyHex await getEncryptionKeyFromServer(); // 将Hex密钥转换为CryptoJS可用的格式我们的工具类接受UTF-8字符串密钥 // 注意如果后端返回的是Hex我们需要将其作为字符串传递但确保它是有效的32字节。 // 更安全的做法是后端返回Base64前端解码为WordArray。 const key CryptoJS.enc.Hex.parse(tempKeyHex).toString(CryptoJS.enc.Utf8); // 转换示例 const loginData { username: username, password: password, timestamp: Date.now() }; const plaintext JSON.stringify(loginData); const encryptedData AesCrypto.encrypt(plaintext, key); // 发送加密后的数据到服务器 const response await fetch(/api/login, { method: POST, headers: { Content-Type: application/json }, body: JSON.stringify({ encrypted: encryptedData, keyId: 本次会话的密钥标识 }) }); return response.json(); }后端 (PHP):// api/login.php require_once CryptoHelper.php; // 假设通过密钥标识从缓存如Redis中获取本次会话使用的真实密钥 $keyId $_POST[keyId] ?? ; $encryptedDataBase64 $_POST[encrypted] ?? ; $realKey $cache-get(encryption_key: . $keyId); // 从缓存获取密钥 if (!$realKey) { http_response_code(401); echo json_encode([error 无效或过期的会话密钥]); exit; } try { $decryptedJson AesCrypto::decrypt($encryptedDataBase64, $realKey); $loginData json_decode($decryptedJson, true); // 验证时间戳防止重放攻击可选 $timestamp $loginData[timestamp] ?? 0; if (abs(time() - intval($timestamp / 1000)) 300) { // 允许5分钟误差 throw new Exception(请求已过期); } // 进行正常的用户名密码验证... $username $loginData[username]; $password $loginData[password]; // ... 验证逻辑 ... echo json_encode([success true, token ...]); } catch (Exception $e) { http_response_code(400); echo json_encode([error 解密失败或数据无效: . $e-getMessage()]); }这套完整的方案从原理、实现、调试到安全实践应该能覆盖你在PHP和JavaScript间实现AES加解密的大部分需求。记住安全是一个过程而不是一个结果。在理解工具的基础上结合具体的业务场景设计安全的密钥管理流程才能真正守护好数据。
![[C++]内存管理：串顺序存储的内存回收](http://pic.xiahunao.cn/yaotu/[C++]内存管理：串顺序存储的内存回收)
