应将视频存于Web根目录外,用php校验用户角色后流式输出;需防路径遍历、禁用cdn缓存、处理Range请求,并抽离权限逻辑为独立函数。

判断用户角色后控制视频资源访问
PHP 本身不直接“播放”视频,真正要控制的是「用户能否获取到视频文件」。核心思路是:把视频文件放在 Web 根目录之外(如 /var/www/private/videos/),用 PHP 脚本做权限校验,再通过 readfile() 或 fpassthru() 输出二进制流。直接把 MP4 放在 /public/ 下并靠前端隐藏链接毫无安全性可言。
- 用户登录后,其角色应存于 session 或 JWT 中,例如
$_session['role']值为'student'、'teacher'或'admin' - 视频元数据(如 ID、路径、所需角色)建议存在数据库,避免硬编码;若简单场景,可用数组映射:
$video_permissions = [ 'math_lecture_01' => ['roles' => ['student', 'teacher']], 'exam_solution_vip' => ['roles' => ['teacher', 'admin']], ]; - 务必校验请求参数,防止路径遍历:
basename($_GET['id'])比直接拼接$_GET['id']安全得多
用 PHP 输出受控视频流的最小可行代码
关键不是“怎么播”,而是“怎么安全地吐出文件”。下面是一个带角色检查的 play.php 示例:
['student', 'teacher'], 'exam_solution_vip' => ['teacher', 'admin'], ]; $id = basename($_GET['id'] ?? ''); if (!isset($allowed_roles[$id])) { http_response_code(404); exit('Video not found'); } if (!in_array($_SESSION['role'], $allowed_roles[$id]['roles'])) { http_response_code(403); exit('Insufficient permissions'); } $video_path = '/var/www/private/videos/' . $id . '.mp4'; if (!is_file($video_path)) { http_response_code(404); exit('File not found'); } // 设置正确 MIME 类型和流式响应头 header('Content-Type: video/mp4'); header('Content-Length: ' . filesize($video_path)); header('Accept-Ranges: bytes'); header('Cache-Control: no-cache'); readfile($video_path); ?>
前端 html 只需用标准 标签指向该脚本:。注意:不要在 URL 中暴露真实路径或扩展名。
为什么不能用 .htaccess 或 nginx auth_basic 控制角色?
.htaccess 和 auth_basic 只能做“有无认证”,无法区分角色——它们不知道当前用户是学生还是管理员。PHP 才能读取 session、查数据库、执行复杂逻辑。如果强行用 Nginx 的 auth_request 模块转发鉴权,那背后仍是 PHP 接口,反而增加延迟和配置复杂度。简单角色模型下,纯 PHP 控制更直接可靠。
立即学习“PHP免费学习笔记(深入)”;
- http 范围请求(
Range: bytes=0-1023)对拖拽播放很重要,上面示例中Accept-Ranges: bytes是基础支持,但完整实现断点续传需解析HTTP_RANGE并手动fseek(),生产环境建议用fpassthru()配合fopen()流式处理 - 大视频文件会吃内存,
readfile()在 PHP 8+ 默认已流式处理,但若启用了output_buffering,需先ob_end_clean() - CDN 缓存会破坏权限控制,这类受控视频绝对不能走 CDN 静态缓存;必须确保所有请求都经过 PHP 层
前端 video 标签配合 PHP 的常见陷阱
浏览器对 的预加载行为很激进——它可能在用户点击前就发起请求,导致未登录用户也触发 PHP 鉴权失败报错。这不是 PHP 的问题,而是前端可控性不足的表现。
- 不要依赖
preload="none",它只是提示,不保证生效;更稳妥的方式是:初始不设src,点击播放按钮后再用 js 动态赋值:videoEl.src = 'play.php?id=' + id; - 若用 HLS(.m3u8),PHP 必须同样保护 m3u8 文件和所有
.ts分片,且每个分片请求都要单独鉴权——不能只保护主 m3u8 - 移动端 safari 对非 https 下的 video 流限制更严,确保整个链路(包括 play.php)走 HTTPS,否则可能静音或拒绝加载
权限逻辑越往后越容易堆砌 if-else,真正难的不是第一次写通,而是当角色加到 5 种、视频超 200 个、还要支持“试看前 30 秒”“按班级白名单”时,如何让校验逻辑不散落在各处。建议尽早把权限判定抽成独立函数,比如 can_access_video($user_role, $video_id),后面加策略才不会失控。