PHP解析视频元数据必须依赖外部工具或扩展：首选FFmpeg命令行（ffprobe），其次php-ffmpeg扩展，或轻量级getID3库；三者在兼容性、精度和部署难度上各有取舍。
PHP 本身不内置视频元数据解析能力，getimagesize() 对视频无效，exif_read_data() 仅支持 JPEG/TIFF，直接用 fopen() 读二进制头也极不可靠——必须依赖外部工具或扩展。
用 FFmpeg 命令行 + shell_exec() 最通用
这是目前最稳定、兼容性最好的方案，几乎所有 Linux/macOS 服务器都可部署，Windows 需额外配置 FFmpeg 路径。
- 确保系统已安装 FFmpeg：运行
ffmpeg -version能输出版本号 - PHP 中调用：
ffprobe（FFmpeg 的元数据专用工具）比ffmpeg -i更轻量、更结构化 - 务必对视频路径做
escapeshellarg()过滤，否则存在命令注入风险 - 推荐使用 JSON 输出格式，便于
json_decode()解析，避免正则匹配的脆弱性
function getVideoMetadata($videoPath) {
$escapedPath = escapeshellarg($videoPath);
$cmd = "ffprobe -v quiet -print_format json -show_format -show_streams {$escapedPath}";
$output = shell_exec($cmd);
return json_decode($output, true);
}
// 示例返回中重点关注：
// $meta['format']['duration'] → 总时长（秒，字符串）
// $meta['streams'][0]['width'] / ['height'] → 分辨率
// $meta['streams'][0]['codec_name'] → 编码器（如 'h264'）
// $meta['streams'][0]['r_frame_rate'] → 帧率（如 '30/1'，需计算）
用 php-ffmpeg 扩展（需编译安装）
这是纯 PHP 封装层，底层仍调用 FFmpeg 二进制，但提供了面向对象接口，适合中大型项目统一管理。
- 必须通过
pecl install ffmpeg或源码编译安装，不是composer require能解决的 - PHP 版本兼容性敏感：PHP 8.0+ 需用 ffmpeg 4.x 分支，旧版扩展可能报
Class 'ffmpeg_movie' not found - 不支持 Windows 下的线程安全（TS）PHP 构建，生产环境慎用
- 获取时长需注意：
$movie->getFrameCount() / $movie->getFrameRate()不可靠，应优先读$movie->getDuration()
用 getID3 库（纯 PHP，无依赖）
适合不能装 FFmpeg、又需要快速获取基础信息（如时长、尺寸、编码）的轻量场景，但对 HEVC、AV1、QuickTime 新格式支持滞后。
立即学习“PHP免费学习笔记（深入）”；
- 通过 Composer 安装：
composer require james-heinrich/getid3 - 它本质是“猜”格式：基于文件头和字节偏移解析，遇到非标准 MP4（如由手机直录带私有 atom）可能返回空或错误 duration
- 关键字段命名与 FFmpeg 不同：
$info['video']['resolution_x']而非width；$info['playtime_seconds']是浮点数时长 - 不解析音频流详细参数（如 AAC 的profile），只给
codec字符串，精度有限
真正麻烦的不是“怎么读”，而是“读到的数据是否可信”：移动端录的 MP4 常缺 moov box（放在文件开头），FFmpeg 默认能容错，而 getID3 可能直接放弃；某些剪辑软件导出的 MOV 会把帧率写成 0/0，需要 fallback 到采样估算。别跳过验证步骤。