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免费学习笔记（深入）”；


								


									PaperAiBye

支持近30多种语言降ai降重，并且支持多种语言免费测句子的ai率，支持英文aigc报告等

								下载 
							



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 逻辑只是第一步，后面两层不配合，照样白忙。
https://www.php.cn/faq/1993282.html