Extbase控制器动作返回大Zip文件附件失败问题求助

核心问题分析 #

你当前的代码将整个文件内容加载到内存（$content变量）后再创建响应流，这会导致大文件（300MB+）占用大量内存，即便调高memory_limit，也可能触发PHP执行超时、进程内存超限被系统终止，或是Web服务器的超时限制，最终引发传输中断或500错误。

解决方案：流式输出（避免全量加载内存） #

替换原代码中创建响应体的方式，直接基于本地临时文件创建流式响应，而非将文件内容全部读入内存：

// 替换为你的临时文件实际路径
$tmpZipPath = '/path/to/your/tmp/submissionId.zip';

return $this->responseFactory->createResponse()
    ->withAddedHeader('Content-Type', 'application/zip')
    ->withAddedHeader('Content-Disposition', 'attachment; filename="submissionId.zip"')
    ->withAddedHeader('Content-Length', (string)filesize($tmpZipPath))
    ->withBody($this->streamFactory->createStreamFromFile($tmpZipPath, 'r'));

关键调整说明 #

• 使用createStreamFromFile替代createStream：该方法直接打开文件流，逐块读取并输出，内存占用仅为当前传输的小块数据大小，彻底解决大文件内存溢出问题。
• 移除Content-Transfer-Encoding: binary：HTTP/1.1协议下该头字段已无需显式声明，多余的头可能引发兼容性问题。

额外必要配置检查 #

即便使用流式输出，仍需确保以下超时设置足够大，避免传输过程中被中断：

• PHP配置：修改php.ini中的max_execution_time，建议设置为300（秒）或更长，大文件传输需要足够的执行时间。
• PHP-FPM配置：若使用FastCGI，调整php-fpm.conf中的request_terminate_timeout，值需大于等于max_execution_time。
• Web服务器配置：
  • Nginx：调整proxy_read_timeout（若有反向代理）或fastcgi_read_timeout，设置为300s以上。
  • Apache：修改Timeout参数，确保大于文件传输所需时间。

其他验证点 #

• 确认临时文件所在目录的权限，确保PHP进程拥有读取权限。
• 验证临时文件的完整性（你已确认文件完整，可跳过此步）。

内容的提问来源于stack exchange，提问作者krischanski