视频断点续播功能可以让用户在中断播放后，再次打开视频时直接从之前的播放位置继续加载内容，不需要重新下载整个视频文件，既提升了用户体验，也减少了服务器的带宽消耗。PHP实现这个功能主要依赖HTTP协议的Range请求机制，通过解析客户端发送的范围请求头，返回对应区间的视频数据。
断点续播的核心原理
当用户拖动视频进度条或者暂停后继续播放时，浏览器会自动在请求头中带上Range字段，格式为Range: bytes=start-end，表示请求视频文件的第start到第end字节的内容。如果end未指定，则表示请求从start到文件末尾的所有内容。
服务器收到这样的请求后，需要完成以下几个步骤：
- 解析
Range请求头，获取需要返回的字节范围 - 检查请求的范围是否合法，避免超出文件总大小
- 设置正确的响应头，告知客户端返回的是部分内容
- 移动文件指针到指定位置，读取对应范围的字节数据返回
HTTP响应头设置要点
处理断点续播请求时，需要返回的响应头有固定的规范，错误的响应头会导致浏览器无法正确解析内容，无法实现续播功能。核心的响应头如下：
| 响应头字段 | 作用说明 |
|---|---|
| HTTP/1.1 206 Partial Content | 状态码必须设置为206，表示返回的是部分内容，而不是完整的200响应 |
| Content-Range | 格式为bytes start-end/total，告知客户端返回的字节范围以及文件总大小 |
| Accept-Ranges | 设置为bytes，告知客户端服务器支持字节范围请求 |
| Content-Length | 设置为本次返回的字节数量，即end-start+1 |
| Content-Type | 设置为视频对应的MIME类型，比如video/mp4 |
PHP实现完整代码
以下是一个可以直接使用的PHP视频断点续播处理脚本，支持MP4格式的视频文件，同时处理了无Range请求时的完整文件返回场景。
<?php
// 视频文件路径，根据实际项目调整
$videoPath = '/data/videos/test.mp4';
// 检查文件是否存在
if (!file_exists($videoPath)) {
header("HTTP/1.1 404 Not Found");
exit('视频文件不存在');
}
// 获取文件大小和基本信息
$fileSize = filesize($videoPath);
$fileMime = mime_content_type($videoPath);
// 处理Range请求头
$range = isset($_SERVER['HTTP_RANGE']) ? $_SERVER['HTTP_RANGE'] : null;
// 默认的起始和结束位置
$start = 0;
$end = $fileSize - 1;
$length = $fileSize;
// 如果有Range请求头，解析范围
if ($range) {
// 匹配Range格式，比如 bytes=0-1023 或者 bytes=1024-
if (preg_match('/bytes=(d*)-(d*)/', $range, $matches)) {
$start = $matches[1] === '' ? 0 : intval($matches[1]);
$end = $matches[2] === '' ? $fileSize - 1 : intval($matches[2]);
// 校验范围合法性，避免超出文件大小
if ($start > $end || $start >= $fileSize) {
header("HTTP/1.1 416 Requested Range Not Satisfiable");
header("Content-Range: bytes */$fileSize");
exit;
}
if ($end >= $fileSize) {
$end = $fileSize - 1;
}
$length = $end - $start + 1;
// 设置206部分内容响应
header("HTTP/1.1 206 Partial Content");
header("Content-Range: bytes $start-$end/$fileSize");
}
}
// 设置通用响应头
header("Accept-Ranges: bytes");
header("Content-Type: $fileMime");
header("Content-Length: $length");
header("Cache-Control: no-cache, no-store, must-revalidate");
header("Pragma: no-cache");
header("Expires: 0");
// 打开文件并移动指针到起始位置
$fp = fopen($videoPath, 'rb');
fseek($fp, $start);
// 分块读取文件内容返回，避免大文件占用过多内存
$bufferSize = 8192; // 每次读取8KB
$bytesSent = 0;
while (!feof($fp) && $bytesSent < $length && connection_status() == 0) {
$readSize = min($bufferSize, $length - $bytesSent);
echo fread($fp, $readSize);
$bytesSent += $readSize;
flush();
}
fclose($fp);
exit;
?>
注意事项
在实际项目中使用上述代码时，需要注意以下几点：
- 视频文件的路径需要做权限校验，避免用户通过修改路径访问到非授权的视频文件
- 对于超大视频文件，建议配合Nginx等Web服务器的X-Sendfile功能，让服务器直接处理文件发送，减少PHP进程的资源占用
- 部分浏览器可能对Range请求的处理有差异，需要测试不同浏览器下的兼容性
- 如果视频文件是加密存储的，需要先解密到临时文件再处理，或者调整读取逻辑直接读取解密后的字节流
常见问题排查
如果实现后断点续播不生效，可以按照以下步骤排查：
- 检查浏览器请求头中是否携带了
Range字段，如果没有说明是客户端没有触发范围请求 - 检查服务器返回的响应状态码是否为206，响应头中的
Content-Range是否正确 - 检查
Content-Length是否和返回的实际字节数一致 - 检查视频文件的读取权限，确保PHP进程可以读取到文件内容
PHP断点续播视频播放HTTP_range修改时间：2026-07-05 11:12:37