PHP解密文件通常不是简单调用一个函数就能完成，而是要先确认加密算法、密钥长度、初始化向量和密文格式。很多加密文件会用Base64编码保存，这样方便在文本环境中传输。解密时先读取文件内容，还原成原始二进制数据，再交给对应的解密函数处理。本文以PHP内置的OpenSSL扩展为例，演示读取AES加密文件并恢复明文的具体做法。
一、确认加密文件的关键参数
解密之前最忌讳拿到文件就盲目尝试。加密文件通常由密钥、算法和初始向量共同决定，参数不匹配会导致解密直接失败。AES对称加密里，AES-128、AES-192、AES-256对应的密钥长度分别是16、24和32字节，而CBC模式的IV固定是16字节。如果密文以Base64文本保存，读取后必须先还原为原始二进制数据。可以用base64_decode()的严格模式检查内容是否合法，避免格式错误。
实际项目中，密钥可能来自配置文件、环境变量或密码派生。如果你拿到的是用户密码而不是固定密钥，就不能直接把密码当密钥使用，因为AES要求固定长度。正确的做法是通过hash()或hash_pbkdf2()派生密钥。很多加密实现会把盐和IV一起写入文件头部，解密时按约定长度读取出来。没有这些参数，即便知道算法也几乎无法还原明文。
还要注意密文是否存在编码层。有些系统会先加密再Base64，有些则直接输出二进制。判断方法很简单：用文本编辑器打开文件，如果满屏是英文字母、数字和加号、斜杠、等号，大概率是Base64；如果出现不可打印字符，则更可能是原始二进制密文。格式不同，读取和解密的路径也不同。
二、用OpenSSL解密Base64编码的AES文件
如果加密文件内容是一段Base64文本，PHP的OpenSSL扩展可以轻松完成解密。核心函数是openssl_decrypt()，它支持多种对称算法。下面的示例演示了如何读取Base64密文文件，使用AES-256-CBC算法和已知的密钥、IV进行解密。这里用hash('sha256', $password, true)把任意长度的密码转换为32字节密钥，避免密钥长度不符合要求。
<?php
$file = 'encrypted.txt';
if (!is_readable($file)) {
exit('无法读取加密文件');
}
// 1. 读取并还原密文
$base64Cipher = file_get_contents($file);
$ciphertext = base64_decode($base64Cipher, true);
if ($ciphertext === false) {
exit('文件不是有效的Base64密文');
}
// 2. 设置密钥与IV，长度必须与算法匹配
$password = 'your-strong-password';
$key = hash('sha256', $password, true); // 32字节，对应AES-256
$iv = '1234567890123456'; // 16字节，AES-CBC要求
// 3. 解密
$plaintext = openssl_decrypt(
$ciphertext,
'AES-256-CBC',
$key,
OPENSSL_RAW_DATA,
$iv
);
if ($plaintext === false) {
exit('解密失败：' . openssl_error_string());
}
file_put_contents('decrypted.txt', $plaintext);
echo '解密完成';
?>
代码中base64_decode()的第二个参数设为true，可以避免非法Base64字符被静默忽略。如果文件内容包含中文或二进制数据，保存解密结果时应当使用二进制安全函数，例如file_put_contents()默认就是二进制安全的。解密失败时不要忽略openssl_error_string()，它能给出具体原因，常见的有密钥长度错误、IV长度错误或填充损坏。
这个示例适合已经明确知道加密参数的场景。如果密钥和IV不是硬编码，而是从其他来源读取，一定要保证读取的值没有多余空格或换行。很多解密失败的案例都是因为配置文件里的密钥末尾多了一个换行符。对密钥和IV可以使用trim()处理，但要注意某些合法密钥可能包含空格，因此更推荐在配置时就严格约束格式。
三、处理二进制密文与密钥派生
如果加密文件不是Base64文本，而是二进制格式，通常加密端会把盐、IV和密文拼接在一起。常见的布局可能是：前16字节盐、接着16字节IV、剩余部分才是密文。解密时需要按照这个布局拆分数据。下面示例演示了如何从单个二进制加密文件中提取盐和IV，并用hash_pbkdf2()派生出AES-256密钥。
<?php
$data = file_get_contents('encrypted.bin');
if ($data === false) {
exit('无法读取加密文件');
}
$salt = substr($data, 0, 16);
$iv = substr($data, 16, 16);
$ciphertext = substr($data, 32);
$password = 'user-password';
$iterations = 100000;
$key = hash_pbkdf2('sha256', $password, $salt, $iterations, 32, true);
$plaintext = openssl_decrypt(
$ciphertext,
'AES-256-CBC',
$key,
OPENSSL_RAW_DATA,
$iv
);
if ($plaintext === false) {
exit('解密失败：' . openssl_error_string());
}
file_put_contents('decrypted.bin', $plaintext);
echo '二进制文件解密完成';
?>
使用hash_pbkdf2()派生密钥比直接使用md5()或sha1()更安全，因为它可以设置迭代次数，增加暴力破解成本。迭代次数并非越高越好，100000次在多数服务器上可以在可接受时间内完成，过高会导致解密接口响应变慢。盐必须是随机的，并且每次加密都不同，但解密时盐可以公开，不必保密。
对于已经使用密码短语加密的文件，一定要找加密实现方确认PBKDF2或类似函数的细节，比如使用的哈希算法、迭代次数和输出长度。参数稍有不同，派生出的密钥就完全不一样，这种情况下不会有任何提示，只会得到一串乱码或解密失败。文档化这些参数是可靠解密的前提。
四、大文件解密与常见错误排查
小文件可以直接用file_get_contents()一次性读入内存，但如果加密文件达到几百MB甚至更大，这样做会迅速消耗内存。对于大文件，应优先考虑流式读取和写入。PHP的Sodium扩展提供了sodium_crypto_secretstream_xchacha20poly1305_pull()，可以按块解密经过认证的流数据。不过Sodium的流加密格式与普通OpenSSL分块加密不兼容，必须在加密端也使用相同的Sodium流接口。
如果不具备Sodium环境，可以折中处理：检查服务器内存上限，确认文件大小在可接受范围内时仍用一次性读取；否则应重新评估加密方案，避免在PHP层手动拼接CBC密文块。手动分块解密AES-CBC很容易破坏填充和块边界，导致最后一块解密失败。推荐在加密端就采用支持流式处理的算法和库，而不是在解密端临时补救。
排查解密错误时，先确认OpenSSL扩展已经启用，可以通过php -m | findstr openssl或访问phpinfo()查看。Windows环境需要开启extension=openssl，并确认PHP目录下的OpenSSL库存在。其次检查密文是否为Base64，有无URL安全Base64变体，例如把+替换成-、把/替换成_。最后检查密钥和IV的字节长度是否与算法匹配，必要时输出strlen()进行确认。
安全建议上，解密后的明文不要直接输出到浏览器，应该写入权限受限的目录，或者仅在需要时使用。密钥禁止硬编码在源代码中，尤其不要提交到Git仓库。可以使用环境变量或专门的密钥管理服务保存。临时解密文件在使用后应尽早删除，并设置合理的文件权限，例如Linux下chmod 600 decrypted.txt。
PHP解密文件openssl_decryptAES加密修改时间：2026-09-22 06:32:36