swoole 4 http服务器不推荐直接服务大静态文件，应优先启用sendfile零拷贝；若不可用则分块流式发送并检查iswritable；需禁用冗余响应头、设置准确content-length与缓存头；最佳实践是nginx前置拦截静态请求。
Swoole 4 的 HTTP 服务器本身不推荐直接用作静态资源服务，尤其面对大文件（如几十 MB 以上）时，若使用常规方式（如 readfile、file_get_contents + echo）输出，会将整个文件读入内存，极易触发 OOM 或拖慢响应。优化核心是：**绕过用户态内存加载，交由内核零拷贝处理，并严格控制协程生命周期与缓冲行为。**
启用 sendfile 零拷贝机制
Swoole 4+ 的 Http\Response 提供了原生 sendfile() 方法，它调用 Linux sendfile(2) 系统调用，直接在内核空间完成文件到 socket 的数据搬运，全程不经过 PHP 用户内存。
- 确保文件路径合法且 Web 进程有读取权限（建议放在
public/下，避免穿透到敏感目录） - 调用方式简洁：
$response->sendfile('/path/to/file.zip'); - 该方法自动支持
Range请求，返回206 Partial Content和Content-Range，天然适配断点续传 - 注意：Windows 不支持
sendfile，需降级为分块write()（见下一条）
大文件分块流式发送（兼容 Windows / 特殊场景）
当无法使用 sendfile（如 Windows、加密文件、动态生成内容），应避免一次性读取全量内容。改用协程安全的流式分块写入：
Swoole 6.1.1
下载
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
- 打开文件句柄：
$fp = fopen($filepath, 'rb'); - 设置合适的缓冲区大小（如 64KB）：
$bufferSize = 65536; - 循环读取并写入：
while (!feof($fp) && $response->isWritable()) { $chunk = fread($fp, $bufferSize); if ($chunk !== false && $chunk !== '') { $response->write($chunk); } } - 务必在循环中检查
$response->isWritable()，防止客户端提前断连导致协程卡死 - 最后关闭句柄：
fclose($fp);
禁用不必要的响应头与缓冲
默认 Swoole 会添加一些通用头（如 X-Powered-By）并可能启用输出缓冲，对静态文件纯属冗余开销：
- 显式清除无关头：
$response->header('X-Powered-By', ''); - 禁用 PHP 输出缓冲（确保未开启
output_buffering，或在启动前调用ob_end_clean()） - 设置准确的
Content-Length（sendfile会自动设置；手动流式发送时需提前计算并设头，否则可能触发 chunked 编码，增加解析负担） - 添加
Cache-Control和ETag（可选但推荐），减少重复请求
资源访问路由隔离与前置代理分流
最根本的优化不是“怎么在 Swoole 里发得更好”，而是“让 Swoole 少发静态资源”：
- 在 Nginx 前置层直接拦截静态路径（如
/static/、/uploads/），由 Nginx 原生sendfile或directio处理，完全绕过 PHP/Swoole - 若必须由 Swoole 处理（如鉴权后下载），应在路由层快速识别静态请求，跳过所有中间件和业务逻辑，直通文件发送逻辑
- 对超大文件（>1GB），考虑结合 CDN 回源或临时预签名 URL，把带宽压力从应用层剥离
