应先检查视频文件是否存在且可读,再验证文件头魔数,最后用ffprobe检测流信息;三步组合预检可拦截多数无法播放问题。

检查视频文件是否存在且可读
很多“无法播放”问题其实发生在 PHP 层就失败了,比如路径错误、权限不足或文件被移动。必须先确认 PHP 能正常访问该文件:
-
file_exists($path)返回false?说明路径写错、符号链接断开,或 Web 服务器用户(如 www-data)无权遍历上级目录 -
is_readable($path)返回false?常见于文件权限为600或所属用户不是 Web 进程用户 - 注意:Windows 下
is_readable()对某些网络路径可能返回不准确结果,建议搭配@fopen($path, 'rb')尝试打开并立即fclose()
验证视频文件头是否符合常见格式
仅靠扩展名(如 .mp4)完全不可信。真实可播放的前提是文件开头有合法的魔数(magic bytes)。PHP 可用 fopen() + fread() 读取前几十字节比对:
function is_valid_video_header($path) {
if (!is_readable($path)) return false;
$fp = @fopen($path, 'rb');
if (!$fp) return false;
$header = fread($fp, 32);
fclose($fp);
// MP4 / MOV: "ftyp" 或 "moov" 在前 12 字节内
if (strpos($header, 'ftyp') !== false || strpos($header, 'moov') !== false) return true;
// AVI: "RIFF" + "AVI "
if (substr($header, 0, 4) === 'RIFF' && substr($header, 8, 4) === 'AVI ') return true;
// MKV: EBML header(以 0x1A 0x45 0xDF 0xA3 开头)
if (substr($header, 0, 4) === "\x1A\x45\xDF\xA3") return true;
return false;
}
注意:fread() 读取长度要足够覆盖各种容器头部,32 是较稳妥值;不要用 getimagesize(),它只支持极少数视频格式且易报错中断。
用 FFmpeg 检查流信息与关键帧结构
文件有合法头 ≠ 能实际播放。损坏的索引、缺失关键帧、编码参数超出浏览器解码能力(如 H.265 在 Safari 外多数浏览器不支持),都需底层工具验证。PHP 调用 ffprobe 是最可靠方式:
立即学习“PHP免费学习笔记(深入)”;
- 确保系统已安装
ffmpeg套件,并 Web 用户能执行ffprobe(常被 SELinux 或 open_basedir 限制) - 命令示例:
ffprobe -v quiet -show_entries stream=codec_type,width,height,duration -of default=nw=1 $path - 关键判断点:
- 输出中是否含
codec_type=video流?没有则可能是纯音频或损坏 -
duration是否为有效数字(非N/A或负值)?N/A往往表示缺少 moov box(未 faststart) - 若需兼容性更强,检查
codec_name是否为h264或vp8—— 避免在代码里硬判hevc或av1
- 输出中是否含
浏览器端播放前的最小化服务端预检
PHP 无法代替浏览器解码,但可以拦截明显不可播请求,减少 404/500 和前端卡顿。建议组合以下三步:
- 用
mime_content_type($path)或finfo_open()确认 MIME 类型是video/mp4、video/webm等标准值,而非application/octet-stream - 检查文件大小:小于 1KB 的视频文件几乎肯定无效(连基本 header 都塞不下)
- 对 MP4 文件,额外运行
exiftool -fast -q -t -s -FileType $path 2>/dev/null确认其声称的格式与后缀一致(防伪后缀攻击)
真正难处理的是“能打开但花屏/卡顿”的情况——这涉及编码 profile、level、B-frame 分布等深层参数,PHP 层只能记录日志供后续分析,不能实时拦截。











