在 laravel 中强制下载文件应使用 response() 配合 download() 方法，该方法底层基于 binaryfileresponse 或 streamedresponse 实现。直接调用 return response()->download($path, $name) 即可触发浏览器下载行为并设置正确的 mime 类型与 content-disposition 头。若需自定义流式处理逻辑，可实例化 illuminate\http\response 并手动设置头部，但通常无需手动操作。
如何指定文件名和 MIME 类型？
通过 download() 方法的第二个参数指定文件名，第三个参数指定附加头部。Laravel 会自动检测文件扩展名并设置合适的 MIME 类型。若需强制特定类型，可在第三个参数数组中添加 'Content-Type' 键。例如 response()->download('file.pdf', 'custom.pdf', ['Content-Type' => 'application/pdf']) 将确保浏览器以 PDF 方式处理。
$filename = storage_path('app/public/report.pdf');
$customName = 'my_report.pdf';
return response()
->download($filename, $customName)
->header('Cache-Control', 'no-cache');
上述代码将返回一个响应对象，其 Content-Disposition 头为 attachment; filename="my_report.pdf"。MIME 类型由 Laravel 的 MimeTypeGuesser 根据扩展名推断。若文件不存在，将抛出 Symfony\Component\HttpFoundation\Exception\NotFoundHttpException。
大文件下载时内存占用如何控制？
Laravel 的 download() 方法在处理大文件时采用流式读取，不会将整个文件加载到内存。它使用 PHP 的 fopen 和 fread 循环输出数据块。对于超过服务器内存限制的文件，此机制依然有效。可通过 setTimeLimit(0) 防止执行超时，并确保 PHP 配置允许长运行脚本。
ini_set('max_execution_time', 300);
$path = storage_path('app/large_dump.sql');
return response()
->download($path, 'dump.sql')
->withHeaders([
'Content-Length' => filesize($path),
]);
该代码显式设置了 Content-Length 头，帮助客户端预估下载进度。流式传输过程中，内存峰值仅取决于缓冲区大小（默认通常为 8KB）。若需更细粒度控制，可继承 BinaryFileResponse 并重写 prepare() 方法，但一般场景下 download() 已足够。
当文件路径包含中文或特殊字符时如何处理？
Laravel 的 download() 方法内部使用 Symfony 的 BinaryFileResponse，其对文件名进行 URL 编码处理。中文文件名会被自动转义为 RFC 5987 格式，确保跨浏览器兼容性。无需手动编码，直接传入含中文的路径或文件名即可。例如 response()->download('file.pdf', '报告.pdf') 将生成兼容的 Content-Disposition 头。
