PHP需手动处理Range请求:解析HTTP_RANGE头、设置206状态及Accept-Ranges/Content-Range/Content-Length响应头,用fopen+fseek+fread流式输出视频片段,并禁用输出缓冲;Nginx须配置fastcgi_buffering off,Apache需启用mod_headers透传Range头。

PHP如何响应视频分段请求(Range 请求)
PHP 本身不自动处理视频的 Range 请求,必须手动解析 HTTP_RANGE 头、计算字节范围、设置正确响应头并输出对应片段。否则浏览器会卡在加载中或报 ERR_CONTENT_LENGTH_MISMATCH。
- 检查客户端是否发了
Range头:if (isset($_SERVER['HTTP_RANGE'])) { ... } - 用
preg_match()提取字节范围,例如bytes=0-1023→ 得到$start = 0,$end = 1023 - 必须设置
Status: 206 Partial Content,不能用200 - 响应头必须包含:
Accept-Ranges: bytes、Content-Range: bytes $start-$end/$filesize、Content-Length: $length(即$end - $start + 1)
PHP读取并输出视频片段的正确方式
直接 readfile() 或 file_get_contents() 整体加载大视频会爆内存,且无法支持分段;必须用 fopen() + fseek() + fread() 流式读取指定区间。
- 用
fopen($path, 'rb')以二进制只读打开文件,避免换行符转换干扰字节偏移 - 调用
fseek($fp, $start)定位起点,再fread($fp, $length)精确读取 - 读完立即
fclose($fp),防止句柄泄漏 - 输出前禁用输出缓冲:
if (ob_get_level()) ob_end_clean();,否则头部可能被截断
常见错误:Nginx/Apache 拦截了 Range 请求
即使 PHP 脚本写对了,Web 服务器也可能绕过它,直接返回整个文件或 416 错误。关键看是否启用了 fastcgi_buffering off(Nginx)或是否配置了 mod_headers 允许转发 Range 头。
- Nginx 中,如果用了
fastcgi_pass,必须加:fastcgi_buffering off;
否则 Nginx 会缓存整个响应,破坏分段逻辑 - Apache 下确保
mod_headers已启用,并在虚拟主机中允许传递:Header set Accept-Ranges "bytes"
- 用
curl -I -H "Range: bytes=0-100" http://yoursite/video.php检查返回状态码和Content-Range头是否真实存在
为什么不能用 Content-Disposition: attachment
浏览器播放器依赖 Content-Type: video/mp4 和 Accept-Ranges: bytes 自动发起后续分段请求;一旦设了 Content-Disposition: attachment,浏览器就当下载处理,不会触发流式加载。
立即学习“PHP免费学习笔记(深入)”;
- 必须设
header('Content-Type: video/mp4');(根据实际扩展名调整,如video/webm) - 绝对不要加
header('Content-Disposition: attachment; filename="..."); - 若需兼容 iOS Safari,还需添加:
header('X-Content-Type-Options: nosniff');防止 MIME 类型嗅探失败
实际部署时最容易被忽略的是 Web 服务器层对 Range 的透传控制 —— PHP 脚本再严谨,挡不住 Nginx 默认开启的 fastcgi_buffering。











