FrankenPHP 下载大文件时内存飙升该怎么流式输出-php教程-PHP中文网

根本原因是php默认输出缓冲机制导致文件全量驻留内存；需关闭ob/zlib、改用fread+flush分块输出，或启用x-sendfile由web服务器接管传输。

frankenphp 下载大文件时内存飙升该怎么流式输出

FrankenPHP 下载大文件时内存飙升，根本原因不是 FrankenPHP 本身，而是 PHP 默认输出机制在缓冲环境下的行为——哪怕你用 readfile()，只要输出缓冲（ob）或压缩（zlib）开启，整个文件就会被暂存在内存里再一次性送出。FrankenPHP 虽基于 SAPI 重构，但依然遵循 PHP 的输出缓冲规则，所以老问题照旧发生。

确认并关闭所有输出缓冲层

FrankenPHP 默认可能启用 ob 或自动 gzip，必须显式清空：

在输出头之前加循环清空：while (ob_get_level()) ob_end_clean();
禁用运行时压缩：ini_set('zlib.output_compression', 0);
避免框架自动开启 ob（如 Laravel 的中间件、Symfony 的 HttpKernel），检查是否调用了 ob_start()

改用 fread + flush 分块流式输出

这是 FrankenPHP 下最稳妥、零 Web 服务器配置依赖的方案：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

打开文件句柄后逐块读取（建议 512KB–1MB），每次 echo 后立即 flush()
确保响应头完整：Content-Type、Content-Disposition、Content-Length（必须提前知道文件大小）
示例关键段：

php
ignore_user_abort(true); // 防止用户中断影响进程
if (ob_get_level()) ob_end_clean();
ini_set('zlib.output_compression', 0);

$fp = fopen($file_path, 'rb');
if (!$fp) die('File not readable');

header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename="' . basename($file_path) . '"');
header('Content-Length: ' . filesize($file_path));
header('X-Accel-Buffering: no'); // Nginx 兼容提示，FrankenPHP 会忽略但无害

while (!feof($fp)) {
  echo fread($fp, 1048576);
  if (connection_aborted()) break;
  flush();
}
fclose($fp);
?>

启用 X-Sendfile（推荐用于生产）

FrankenPHP 支持 X-Sendfile（通过 Caddy 或 Nginx 中转），让 PHP 只做鉴权，不碰文件内容：

FrankenPHP 不直接发送文件，只返回带 X-Sendfile 头的响应
Caddy 配置需启用 file_server 并允许内部重写；Nginx 需开启 sendfile on 和 underscores_in_headers on
代码只需：

header('X-Sendfile: ' . $file_path);
header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename="' . basename($file_path) . '"');
exit;

此时内存占用恒定在几 KB，彻底规避 PHP 层传输压力。