video标签直接播放静态路径无法支持拖动、缓冲和分片加载，因缺少range请求处理；真实项目需手写控制器响应206 partial content，正确设置accept-ranges、content-range头，并用fopen/fseek/fpassthru精确输出字节段。
video 标签直接播放静态路径，能跑通但不适用于真实项目——它无法支持拖动、缓冲、大文件分片加载，用户拖进度条会卡死或报错 ERR_CONNECTION_ABORTED。真正可用的在线播放必须走流式响应（range request），ThinkPHP 5/6 都得自己手写控制器处理 HTTP 头。
为什么 readfile() 直接输出视频会失败
浏览器点进度条时，会发带 Range: bytes=1024-2047 的请求，而 readfile() 默认返回整个文件、状态码是 200 OK，服务器没做 range 解析，客户端就认为“断连”或“不支持拖拽”。常见现象包括：
– 视频加载后无法拖动
– 控制台报 Failed to load resource: net::ERR_CONTENT_LENGTH_MISMATCH
– 移动端 Safari 完全不播放
– 某些 CDN 或 Nginx 代理直接拦截非 200 响应
解决方案不是换框架，而是补全 HTTP 流媒体语义：
- 检查请求头是否含
Range，有则返回206 Partial Content - 必须设置
Accept-Ranges: bytes和Content-Range头 - 用
fopen()+fseek()+fpassthru()精确输出字节段，避免内存溢出 - 不要用
echo file_get_contents()，大视频会 OOM
VideoController::stream() 必须校验的 3 个边界
实际部署中，以下逻辑漏掉任意一个都会导致 500 或播放异常：
-
$start不能小于 0，否则fseek()失败；建议强制max(0, $start) -
$end不能大于$videoSize - 1，否则fpassthru()报 warning；应取min($end, $videoSize - 1) - 若
Range格式非法（如bytes=abc-），需 fallback 到完整响应，否则返回空内容
示例片段（TP6）：
if (!preg_match('/^bytes=(\d+)-(\d+)?$/i', $range, $matches)) {
// fallback：全量发送
header('HTTP/1.1 200 OK');
header('Content-Type: video/mp4');
header('Content-Length: ' . $videoSize);
readfile($videoPath);
exit;
}
$start = (int)$matches[1];
$end = isset($matches[2]) ? (int)$matches[2] : $videoSize - 1;
$start = max(0, $start);
$end = min($end, $videoSize - 1);
TP6 路由和 Nginx 配置容易忽略的坑
开发时本地 php think run 可能正常，一上生产环境就失效，大概率是 Web 服务器拦截了 Range 请求或重写了路径：
- TP6 路由别用
get('video/stream')这种带斜杠的，改用闭包路由并显式允许 HEAD/OPTIONS 方法 - Nginx 需显式开启
add_header Accept-Ranges bytes;，且禁用fastcgi_buffering off;（否则缓存整个响应） - 如果视频存在
public/uploads/videos/，确保该目录不在location ~ \.php$规则下被 PHP-FPM 错误解析（应直出静态文件或交由 PHP 控制器） - 云服务器（如腾讯云 CVM）若开了 WAF，要检查是否拦截了含
Range头的请求
缩略图与播放地址分离时的权限控制要点
前端 <video src="/video/stream?name=xxx.mp4"></video> 是公开 URL，但你不希望用户拼出任意文件路径下载原始视频：
- 不要把真实文件名（如
xxx_123456789.mp4）暴露在 URL 中，用 UUID 或加密 ID 映射 - 控制器内必须校验该
name是否属于当前用户/频道/权限组，不能只查数据库存在性 - 缩略图路径（
thumbnail字段）可直出，但播放接口必须走鉴权 —— ThinkPHP 的Auth中间件或自定义checkVideoAccess()方法要嵌入 stream 逻辑前 - 若启用 Redis 缓存视频元信息（如时长、分辨率），记得缓存 key 绑定用户 session 或 token，防止越权读取
流式播放的核心不是“怎么播”，而是“怎么不让它播错”。每个 header()、每次 fseek()、每处 exit 的位置，都得对应浏览器真实的网络行为。调试时打开 Chrome DevTools → Network → 找 video 请求 → 看 Headers 和 Preview，比看 PHP 日志更直接。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
