PHP需正确处理HTTP Range请求头以实现断点续播：检查Range头、返回206状态码、设置Accept-Ranges: bytes、Content-Range及Content-Length；同时确保MP4含faststart、禁用gzip压缩、关闭输出缓冲，并注意CDN缓存配置。
PHP 如何响应 Range 请求头实现断点续播
PHP 本身不直接“播放”视频，但能通过正确处理 HTTP Range 请求头，让浏览器在暂停后继续请求视频文件的某一段（比如从第 120 秒开始），从而支持 HTML5 的断点续播。关键不是 PHP 解析视频，而是 PHP 做好字节范围响应。
常见错误是直接用 readfile() 输出整个文件，或忽略 Accept-Ranges、Content-Range 等响应头，导致浏览器始终重新下载——哪怕只拖动进度条一小段，也会卡顿、重载、无法续播。
- 必须检查客户端是否带了
Range请求头（格式如bytes=1024-2047） - 必须返回
206 Partial Content状态码（不能是200 OK） - 必须设置
Accept-Ranges: bytes告诉浏览器“我支持分段” - 必须计算并返回准确的
Content-Range和Content-Length
video.php 最简可用断点续播脚本
以下是一个生产环境可直接调整使用的最小可行版本，适用于 .mp4、.webm 等支持流式播放的格式（注意：不适用于 .avi 或未做 moov 原子前置的 MP4）：
#!/usr/bin/env php $fileSize = filesize($videoPath); $fp = fopen($videoPath, 'rb');// 检查 Range 头 $range = $_SERVER['HTTP_RANGE'] ?? ''; if (preg_match('/^bytes=(\d+)-(\d*)$/', $range, $matches)) { $start = (int)$matches[1]; $end = $matches[2] === '' ? $fileSize - 1 : (int)$matches[2]; $length = $end - $start + 1;
header('HTTP/1.1 206 Partial Content'); header('Content-Type: video/mp4'); header('Accept-Ranges: bytes'); header("Content-Range: bytes $start-$end/$fileSize"); header("Content-Length: $length"); header('Connection: close'); fseek($fp, $start); while ($length > 0 && !feof($fp)) { $chunk = min(8192, $length); echo fread($fp, $chunk); $length -= $chunk; }} else { // 无 Range 头，完整返回（兼容旧浏览器或首次加载） header('HTTP/1.1 200 OK'); header('Content-Type: video/mp4'); header("Content-Length: $fileSize"); header('Accept-Ranges: bytes'); fpassthru($fp); }
fclose($fp); ?>
为什么有些 MP4 仍无法断点续播？
即使 PHP 正确返回了
206和Content-Range，浏览器仍可能拒绝拖动或报错Failed to load resource: net::ERR_CONTENT_LENGTH_MISMATCH—— 这通常和视频文件本身结构有关。立即学习“PHP免费学习笔记（深入）”；
-
moov原子必须在文件开头（fast-start）。默认 FFmpeg 生成的 MP4 把moov放末尾，浏览器没读完就无法解析时长、分辨率等元信息 - 修复方法：用
ffmpeg -i input.mp4 -c copy -movflags +faststart output.mp4 - 验证方式：用
ffprobe -v quiet -show_entries format=duration input.mp4能秒出结果，说明moov可读；否则需重编码或加faststart - 不要用
Content-Encoding: gzip压缩视频流 —— 会破坏字节偏移，导致Range错乱
Web 服务器比 PHP 更适合干这事？
是的。Nginx / Apache 原生支持 Range，开箱即用且零 PHP 开销。只有当需要权限控制（如校验登录态、限制单用户并发数）、动态拼接、或按 URL 参数改写路径时，才该用 PHP 中转。
若必须用 PHP，务必注意：
- 禁用输出缓冲：
ob_end_clean()或ini_set('output_buffering', 'Off')，否则fseek后输出会错位 - 避免任何
echo/print在 header 之前（包括 BOM 字符） - 大文件建议用
fpassthru()而非file_get_contents()，防止内存溢出 - CDN 或反向代理（如 Cloudflare）可能缓存
200响应却丢弃206，需配置缓存规则显式放行Range请求
最易被忽略的是视频文件结构和 Web 服务器层的干扰 —— 写对 PHP 逻辑只是第一步，后面两层不配合，照样白忙。
