php不能直接切换视频清晰度，仅能动态生成含多分辨率url的json元数据供前端播放器调用；需校验文件存在、白名单过滤参数、设置正确content-type与range支持。
PHP 本身不处理视频清晰度切换
PHP 是服务端脚本语言，无法直接控制前端视频播放器的清晰度切换逻辑。所谓“PHP 实现清晰度切换”，实际是指：用 PHP 动态生成多清晰度视频资源的元数据（如不同分辨率的 .mp4 或 .m3u8 地址），供前端播放器（如 video.js、hls.js 或原生 <video></video>）调用和切换。如果误以为 PHP 能在服务端“实时切换清晰度”，会导致架构设计错误。
后端需提供清晰度元数据接口（JSON 格式）
前端切换清晰度时，需要知道有哪些可用选项及其对应 URL。PHP 负责返回结构化数据，例如：
{
"sources": [
{
"label": "1080p",
"src": "/videos/movie_1080p.mp4",
"type": "video/mp4"
},
{
"label": "720p",
"src": "/videos/movie_720p.mp4",
"type": "video/mp4"
},
{
"label": "480p",
"src": "/videos/movie_480p.mp4",
"type": "video/mp4"
}
]
}
关键点：
-
label必须是前端可读的字符串（如"1080p"），不能含空格或特殊符号（避免 JS 解析异常） -
src值应由 PHP 动态拼接，推荐使用realpath()+basename()校验文件是否存在，防止路径遍历或 404 - 若用 HLS（
.m3u8），type应为"application/vnd.apple.mpegurl"，且需确保 Web 服务器支持该 MIME 类型 - 务必设置响应头：
header('Content-Type: application/json; charset=utf-8');
PHP 需预生成并校验多码率视频文件
清晰度切换的前提是——对应分辨率的视频文件已存在。PHP 不转码，但可做轻量级检查与路由分发：
立即学习“PHP免费学习笔记（深入）”；
- 用
getimagesize()对 MP4 不可靠，改用ffprobe（需系统安装 FFmpeg）获取真实分辨率：exec("ffprobe -v quiet -show_entries stream=width,height -of csv=p=0 $filepath", $output); - 文件命名建议统一规则，如
video_id_720p.mp4，PHP 可通过$_GET['q']接收清晰度参数（如q=720p），再拼路径：$file = '/videos/' . $id . '_' . $_GET['q'] . '.mp4'; - 禁止直接输出用户可控的
$_GET值到文件路径，必须白名单校验：in_array($_GET['q'], ['480p', '720p', '1080p']) - 若用 Nginx，建议配置
try_files $uri =404;，避免 PHP 处理静态文件请求，减轻压力
前端播放器才是切换执行者，PHP 只是数据源
常见误区：试图用 PHP 输出 JS 代码或重定向到不同清晰度 URL。这不可行——视频播放上下文（当前时间、音量、缓冲状态）会丢失。正确方式是前端播放器内部切换 source 或 HLS 的 variant。
例如 video.js 需配合 videojs-contrib-quality-levels 插件，其 qualityLevels() 方法依赖你提供的 JSON 中的 sources 数组。PHP 接口返回的数据，只是这个数组的源头。
容易被忽略的一点：HTTP 范围请求（Range: bytes=...）必须正常工作，否则切换清晰度后首帧加载极慢。确认 PHP 脚本未禁用 Accept-Ranges，且 Web 服务器（Apache/Nginx）对 MP4 文件开启了字节范围支持。
