PHP 8.4上传文件下载出现文件损坏怎么办？完整性校验方法-php教程-PHP中文网

php 8.4 文件上传下载“损坏”主因是二进制完整性被破坏，需禁用编码转换、关闭输出缓冲、用 move_uploaded_file 和 readfile 保障字节零损耗，并强制 sha256 校验。

php 8.4上传文件下载出现文件损坏怎么办？完整性校验方法

PHP 8.4 上传或下载文件后出现“损坏”，通常不是 PHP 本身破坏了文件，而是传输链路中某环节未保持二进制完整性，或服务端处理时意外修改了原始字节流。尤其在 PHP 8.4 中，对字符编码、输出缓冲、文件读写行为更严格，稍不注意就会引入 BOM、换行截断、UTF-8 转义等隐性污染。

下面从上传和下载两个方向，给出可落地的完整性保障方法：

上传环节：防止文件被 PHP 或环境篡改

禁用所有自动编码转换和输出缓冲干扰
确保上传处理脚本开头就关闭可能影响二进制数据的机制：
```
if (function_exists('mb_http_output')) mb_http_output('pass');
if (function_exists('mb_internal_encoding')) mb_internal_encoding('BINARY');
if (function_exists('iconv_set_encoding')) {
    iconv_set_encoding('internal_encoding', 'BINARY');
    iconv_set_encoding('output_encoding', 'BINARY');
}
```
避免 echo、print、空白符、BOM 输出到响应体——哪怕一个空格也会让 Content-Disposition: attachment 下载的文件头部多出无效字节。

PHP
编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载
跳过 $_FILES['type'] 和任何字符串解析逻辑
PHP 8.4 彻底弃用客户端伪造的 $_FILES['file']['type']，也不再做扩展名→MIME 映射。直接用 finfo_buffer(file_get_contents($tmp), FILEINFO_MIME_TYPE) + 扩展名白名单双校验，且不经过任何 str_replace、trim、utf8_encode 等函数处理原始二进制内容。
临时文件操作必须原子、无损
不要用 file_get_contents() + file_put_contents() 处理大文件（内存溢出+编码风险）；改用 move_uploaded_file($tmp, $dest) 直接移动，这是唯一保证字节零损耗的方式。若需预处理（如加水印），务必使用 fopen($tmp, 'rb') 模式读取，并用 fopen($dest, 'wb') 写入。

下载环节：确保响应流与原始文件完全一致

强制二进制响应头，禁用输出缓冲污染
下载脚本开头立即设置：

header('Content-Type: application/octet-stream');
header('Content-Transfer-Encoding: binary');
header('Content-Disposition: attachment; filename="' . rawurlencode(basename($file_path)) . '"');
header('Content-Length: ' . filesize($file_path));
header('Cache-Control: no-cache, no-store, must-revalidate');
header('Pragma: no-cache');
header('Expires: 0');
// 关闭所有可能的输出缓冲
if (ob_get_level()) ob_end_clean();
// 强制以二进制方式读取并输出
readfile($file_path);
exit;

避免通过 echo 或 print 输出文件内容
echo file_get_contents($path) 在 PHP 8.4 中可能触发隐式 UTF-8 转义（尤其含中文路径或系统 locale 不一致时），导致文件尾部多出 \xEF\xBB\xBF 或乱码字节。readfile() 是唯一安全的原生流输出方式。

完整性校验：上传/下载前后比对 SHA256

服务端校验（推荐）
上传成功后立即计算哈希并存库：
```
$hash = hash_file('sha256', $_FILES['file']['tmp_name']);
// 存入数据库或缓存，关联原始文件名、时间戳、用户ID
```
用户下载前，重新计算目标文件哈希，与存储值比对；不一致则拒绝下载并告警。
客户端辅助校验（增强可信）
前端上传时可用 FileReader + CryptoJS 或原生 SubtleCrypto 计算 SHA256，和服务端返回值比对；下载后浏览器也可用 fetch() + arrayBuffer() 本地验签（适合关键文件，如安装包、证书）。
注意：不要用 md5_file() 做关键校验
MD5 碰撞已被实证攻破，PHP 8.4 场景下建议统一用 hash_file('sha256', $path)，它稳定、快速，且不受文件权限/编码影响。