webman需手动解析range头、校验范围、fseek定位并分块输出,返回206状态码及accept-ranges、content-range、content-length等严格符合rfc 7233的响应头,禁用gzip,流式读取避免内存溢出。

Webman 本身不支持分布式分片下载,所谓“分布式”必须由你自行拆解:把一个大文件的 Range 请求路由到不同节点、协调各节点返回对应片段、客户端合并——Webman 只负责单节点上的 Range 解析与流式输出,它不处理跨节点调度、一致性哈希或片段聚合。
Webman 怎么正确响应 Range 请求并返回 206
浏览器发 Range: bytes=1000-1999,Webman 必须返回 206 + 严格符合 RFC 7233 的头,否则 Chrome/Firefox 直接降级为全量下载。
- 用
$request->getHeaderLine('Range')获取头,别碰$_SERVER['HTTP_RANGE'](Swoole 下不可靠) - 正则匹配
/^bytes=(\d+)-(\d+)?$/,匹配失败直接返回 416,不 fallback 到 200 -
$start超过filesize($path)就 416;$end为空时设为$size - 1 - 状态码必须是
HTTP/1.1 206 Partial Content,不是206 OK - 响应头缺一不可:
Accept-Ranges: bytes、Content-Range: bytes 1000-1999/123456、Content-Length: 1000(注意不是总大小) - 禁用 gzip:Nginx 反代要关掉
gzip on和proxy_buffering,Swoole 默认不压缩但别信配置覆盖
为什么不能用 readfile() 或 fpassthru()
这些函数会把整个文件读进内存或触发系统缓冲,对 GB 级文件等于主动 OOM。Webman 常驻进程下,一次卡死影响整个 worker。
Webman 2.2.0版本强化了 TCP/UDP 服务支持,优化路由组管理,并增强异步任务处理能力。结合协程与连接池技术,Webman 能轻松应对高并发场景,适用于网站、接口服务、即时通讯、物联网及游戏开发,兼具高性能、灵活扩展与稳定可靠,是多场景 PHP 服务开发的理想选择。
- 必须用
fopen($path, 'rb')打开,fseek($fp, $start)定位,再循环fread($fp, 8192) - 每次
fread后检查返回值:false是 I/O 错误,''是 EOF,不能只判空 - 用
echo输出每块,配合ob_flush()和flush()(仅当zlib.output_compression关闭时有效) - 所有异常分支(如 416)前必须
fclose($fp),否则句柄泄漏
分布式协调不在 Webman 职责内
Webman 不提供节点发现、负载均衡或片段状态同步。如果你真要做“分布式分片下载”,得在它前面加一层网关或调度服务。
- 例如:前端请求
/download?id=abc123,网关查元数据得知该文件被切为 4 片,分别存于 node-a、node-b、node-c、node-d - 网关按
Range计算应由哪个节点响应(比如bytes=5000000-落在 node-c),再反向代理过去 - 各 Webman 节点只管自己那部分文件的 Range 解析和流式输出,不感知其他节点
- 客户端需自行发起多个并发请求(如用
fetch+ReadableStream),拼接二进制片段——Webman 不参与这个过程
最容易被忽略的是 Content-Range 中的总大小字段:它必须是原始文件的完整字节数,不是当前节点上那一片的大小;还有就是 Nginx 缓冲问题——哪怕 Webman 输出正确,Nginx 没关 proxy_buffering,照样截断响应导致续传失败。










