PHP不直接控制视频播放,仅能通过HTTP范围请求支持分段加载;实现拖拽快进需服务端返回206状态及正确Content-Range头,但生产环境应由Nginx/Apache原生处理Range,PHP仅作权限校验。

PHP 本身不直接控制视频播放,它只能配合 HTTP 协议提供支持分段加载(即「范围请求」Range)的响应。能否实现视频拖拽、快进、边下边播,关键在于服务端是否正确返回 206 Partial Content 和正确的 Content-Range 头 —— 而不是靠 PHP 渲染一个播放器。
PHP 如何响应视频的 Range 请求
浏览器在拖动进度条或初始化播放时,会发送带 Range: bytes=xxx-yyy 头的 GET 请求。PHP 脚本需解析该头、读取对应字节段、设置正确响应头并输出二进制数据。
- 必须检查
$_SERVER['HTTP_RANGE']是否存在,否则直接返回完整文件(200 OK)或重定向到静态路径更高效 - 用
fopen($file, 'rb')打开视频文件,避免file_get_contents()加载整个大文件到内存 - 计算
start、end、length时注意边界:若end超出文件大小,应设为filesize($file) - 1 - 必须设置:
Content-Type(如video/mp4)、Accept-Ranges: bytes、Content-Range、Content-Length,且状态码为206
header('HTTP/1.1 206 Partial Content');
header('Content-Type: video/mp4');
header('Accept-Ranges: bytes');
header("Content-Range: bytes $start-$end/$size");
header("Content-Length: " . ($end - $start + 1));
header('Connection: close');
$fp = fopen($file, 'rb');
fseek($fp, $start);
while (!feof($fp) && (connection_status() == CONNECTION_NORMAL)) {
echo fread($fp, 8192);
ob_flush();
flush();
}
fclose($fp);
为什么直接用 PHP 输出视频性能差
PHP 是阻塞式脚本语言,每个请求独占一个 FPM 进程;视频流持续输出时,该进程无法处理其他请求。并发稍高就导致 Nginx/Apache 连接堆积、超时、502。
- 真实生产环境几乎从不靠 PHP 动态输出视频流 —— 静态文件由 Web 服务器(Nginx / Apache)原生支持
Range,性能高出数倍 - PHP 只适合做权限校验(例如验证登录态、过期时间),然后用
X-Accel-Redirect(Nginx)或X-Sendfile(Apache)交由 Web 服务器下发文件 - 若必须 PHP 输出,务必加
set_time_limit(0)和ignore_user_abort(true),但仅缓解,不根治
Nginx 下用 PHP 校验后代理视频文件(推荐方案)
让 PHP 做鉴权,再把路径透传给 Nginx 内部处理,兼顾安全与性能。
立即学习“PHP免费学习笔记(深入)”;
- PHP 中验证通过后,不输出文件,而是设置响应头:
header('X-Accel-Redirect: /internal/videos/'.basename($path)); - Nginx 配置中定义
location /internal/videos/,并设置internal;(禁止外部直接访问),同时开启add_header Accept-Ranges bytes; - 确保该 location 指向真实视频目录,且 Nginx 有读取权限
- 此时所有
Range、缓存、断点续传均由 Nginx 完成,PHP 仅耗时几毫秒
前端播放器必须支持 HTTP Range
即使后端完全正确, 标签仍可能无法拖拽 —— 常见原因不是 PHP,而是前端或部署问题。
- 确认浏览器开发者工具 Network 面板中,视频请求响应状态是
206,且含Content-Range头 - 避免将视频 URL 写成
play.php?id=123这类无扩展名路径,部分浏览器/播放器拒绝对其发起Range请求;可用play.php/abc.mp4(PATH_INFO)或添加.mp4后缀伪静态 - CDN 或反向代理(如 Cloudflare)可能默认禁用
Range请求,需手动开启「Partial Request」或「Byte Range」支持 -
即可触发 Range,无需额外 JS;若用video.src = 'play.php?...',请确保 URL 被识别为媒体资源类型
真正卡住的往往不是 PHP 怎么写,而是没意识到:Range 支持是 HTTP 层特性,Web 服务器比 PHP 更擅长这件事;PHP 的角色应该是守门人,而不是搬运工。











