php 8.2 中不应手动设置 transfer-encoding，因其由 web 服务器自动管理；应正确设置 content-length 以确保下载正常，避免分块传输导致的进度失效等问题。
PHP 8.2 中不该手动设置 Transfer-Encoding
PHP 8.2（及所有现代 PHP 版本）下，你不该、也不能手动设置 Transfer-Encoding: chunked 或其他值。这个响应头由 Web 服务器（如 Nginx、Apache）或 PHP SAPI 层自动管理，PHP 脚本层无权直接控制它。你调用 header('Transfer-Encoding: chunked') 不仅无效，还可能触发警告或被服务器静默丢弃。
真正要设的是 Content-Length，且必须准确
当你用 readfile()、fpassthru() 或流式输出时，浏览器依赖 Content-Length 判断下载是否完成。如果省略或设错：
- 浏览器可能卡在“正在下载”状态，进度条不动
- 部分 iOS Safari 会拒绝触发下载，直接空白页
- 断点续传（
Range请求）完全失效
正确做法是：在发送头之前，确保文件存在且可读，并用 filesize($filepath) 获取真实字节数：
if (!file_exists($filepath) || !is_readable($filepath)) {
http_response_code(404);
die('文件不可访问');
}
header('Content-Length: ' . filesize($filepath));
注意：filesize() 对符号链接、NFS 挂载或某些网络文件系统可能返回不准确值；大文件（>2GB）在 32 位系统上会溢出，此时应改用 stream_stat() + ['size'] 并做类型检查。
为什么 Content-Transfer-Encoding 还在用，但它和 HTTP 传输无关
Content-Transfer-Encoding 是 MIME 协议里的概念（源自 email），不是 HTTP 标准头。PHP 示例中常出现它，纯属历史遗留 —— 它对现代浏览器下载行为没有任何影响。你可以安全删掉这行：
// ❌ 无意义，可删
header('Content-Transfer-Encoding: binary');
真正起作用的是：
-
Content-Type：告诉浏览器“这是个二进制流”，别尝试解析渲染 -
Content-Disposition: attachment：强制触发下载对话框 -
Content-Length：让客户端知道要收多少字节
大文件下载时，Transfer-Encoding 的实际控制点在 Nginx/Apache
如果你观察到响应里出现了 Transfer-Encoding: chunked，那一定是 Web 服务器在你没发 Content-Length 时自动启用的分块传输。这不是 bug，是 HTTP/1.1 的合规行为。但对下载体验不利：
- 无法显示剩余时间与进度百分比
- 暂停/续传功能不可用
- 某些旧版下载工具（如 wget 1.19 之前）可能报错
解决路径只有两个：
- 坚持设好
Content-Length（推荐，适用于已知大小的静态文件） - 改用 Web 服务器原生服务：把文件放在
alias或location下，由 Nginx 直接sendfile，完全绕过 PHP（最高效，也最安全）
最后提醒：任何输出（空格、BOM、echo、错误提示）出现在 header() 之前，都会导致 headers already sent 错误，使所有头设置失效 —— 这比 Transfer-Encoding 问题更常见，也更难排查。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
