PHP无法直接替换加密文件内容，必须先解密→修改明文→重新加密→覆盖原文件；因密文是二进制流，str_replace会破坏结构、填充、IV及MAC校验，导致解密失败。
PHP 本身不提供“加密文件内容替换”的内置函数，所谓“替换加密文件内容”本质上是：先解密 → 修改明文 → 再加密 → 覆盖原文件。直接对密文做字符串替换（如 str_replace）几乎必然破坏加密结构，导致后续无法解密。
为什么不能直接用 str_replace 处理加密文件
加密后的数据是二进制字节流，不是可读文本。常见错误包括：
- 把加密后的内容当 UTF-8 字符串处理，
str_replace可能截断多字节序列，产生乱码或解密失败 - 密文长度固定（如 AES-CBC 模式需填充），任意替换会破坏块对齐和填充验证
- 现代加密通常含 IV、MAC 或 nonce，直接修改密文会导致完整性校验失败（如 OpenSSL 抛出
error:06065064:digital envelope routines:EVP_DecryptFinal_ex:bad decrypt）
安全替换流程：解密 → 修改 → 重新加密
必须走完整加解密闭环。以 AES-256-CBC 为例（使用 OpenSSL 扩展）：
// 假设 $cipherText 是从文件读取的原始密文（二进制）
$key = hash('sha256', 'your-secret-key', true); // 密钥需固定且安全
$iv = substr($cipherText, 0, 16); // IV 存在密文开头（约定）
$encryptedData = substr($cipherText, 16); // 实际密文部分
// 1. 解密
$plainText = openssl_decrypt($encryptedData, 'AES-256-CBC', $key, OPENSSL_RAW_DATA, $iv);
if ($plainText === false) {
throw new Exception('Decryption failed: ' . openssl_error_string());
}
// 2. 修改明文（例如替换某个字段）
$decoded = json_decode($plainText, true);
$decoded['status'] = 'processed';
$plainText = json_encode($decoded, JSON_UNESCAPED_UNICODE);
// 3. 重新加密（新 IV）
$newIv = openssl_random_pseudo_bytes(16);
$newEncrypted = openssl_encrypt($plainText, 'AES-256-CBC', $key, OPENSSL_RAW_DATA, $newIv);
// 4. 合并 IV + 密文，写回文件
file_put_contents('secure.dat', $newIv . $newEncrypted);
注意：openssl_encrypt 和 openssl_decrypt 的 $options 参数必须一致（如都用 OPENSSL_RAW_DATA）；IV 必须每次随机生成且随密文存储。
立即学习“PHP免费学习笔记（深入）”；
避免踩坑的关键细节
实际操作中高频出错点：
- 密钥长度不匹配：AES-256 要求 32 字节密钥，
hash('sha256', ..., true)正确，而md5()或裸字符串直接传入会失败 - IV 复用：同一密钥下重复使用 IV 会严重削弱安全性，绝不能硬编码或复用旧 IV
- 未验证解密结果：
openssl_decrypt失败返回false，不检查就继续处理会导致逻辑错误甚至信息泄露 - 文件读写模式：用
file_get_contents读取时确保是二进制模式（默认就是），但若用fopen必须加b标志（如'rb'）
真正要替换的是业务数据，不是密文本身。所有修改必须落在解密后的结构化数据上，再严格按相同算法、密钥、IV 生成规则重新封装——漏掉任何一个环节，文件就彻底不可恢复。
