PHP读取视频元数据方法【途径】

PHP解析视频元数据最可靠方案是调用ffprobe命令：需服务器安装ffmpeg、启用shell_exec，用escapeshellarg处理路径，合并stderr并校验JSON；纯PHP库如php-ffmpeg仍依赖ffprobe，手动解析容器格式不具实用性。

PHP 本身不内置视频元数据解析能力，getimagesize() 对视频返回 false 或不完整信息，直接用 file_get_contents() 读二进制头也极不可靠。真正可用的方案只有两个：调用外部命令（如 ffprobe）或使用封装好的 PHP 扩展（如 ffmpeg-php 已废弃，不推荐）。

用 ffprobe 命令行工具获取完整视频元数据

这是目前最稳定、最通用的做法。前提是服务器已安装 ffmpeg 套件（含 ffprobe），且 PHP 有执行系统命令权限（shell_exec 或 exec 未被禁用）。

• ffprobe 比 ffmpeg -i 更轻量，专为元数据提取设计，输出结构清晰
• 推荐使用 JSON 格式输出，便于 PHP 解析：ffprobe -v quiet -print_format json -show_format -show_streams $video_path
• 注意路径必须是服务器本地绝对路径，不能是 URL；若路径含空格或特殊字符，需用 escapeshellarg() 包裹
• 错误时 ffprobe 可能输出到 stderr，建议用 2>&1 合并流，并检查返回值是否为空或含 error 字符串

$videoPath = '/var/www/videos/sample.mp4';
$cmd = sprintf('ffprobe -v quiet -print_format json -show_format -show_streams %s 2>&1', escapeshellarg($videoPath));
$output = shell_exec($cmd);
$data = json_decode($output, true);

if (json_last_error() !== JSON_ERROR_NONE || empty($data)) {
    throw new RuntimeException('ffprobe failed or returned invalid JSON');
}

$duration = $data['format']['duration'] ?? null; // 秒数，字符串类型
$width = $data['streams'][0]['width'] ?? null;
$height = $data['streams'][0]['height'] ?? null;

PHP 中处理 ffprobe 输出的常见陷阱

看似简单的一行命令，实际部署中出错率很高，多数问题不在 PHP 代码，而在环境与调用细节。

• shell_exec() 返回 null？先确认 disable_functions 是否禁用了它，或 safe_mode（已废弃但旧配置可能残留）是否开启
• 返回空字符串或报错 “No such file or directory”？不是视频路径错，而是 ffprobe 命令找不到——检查 which ffprobe 路径，必要时写绝对路径如 /usr/bin/ffprobe
• 中文路径乱码？Linux 下一般无此问题，但若 Web 服务运行在 Windows + WSL 混合环境，需统一编码为 UTF-8 并确保 locale 支持
• 超大视频（>2GB）导致超时？默认 ffprobe 会扫描整个文件以计算准确时长，加 -vframes 1 或用 -count_frames 可跳过分析，但时长可能不准

不用系统命令的替代方案：纯 PHP 库（如 php-ffmpeg）

php-ffmpeg（alcaeus/php-ffmpeg）是目前最活跃的纯 PHP 封装，但它**底层仍依赖 ffprobe 可执行文件**，只是帮你拼命令、解析 JSON、提供面向对象接口。它不解决“没 ffprobe 怎么办”的问题，只解决“懒得手写 exec 和 json_decode”的问题。

• 安装：composer require php-ffmpeg/php-ffmpeg
• 它不会自动找 ffprobe，需显式指定路径：$ffmpeg = FFMpeg\FFMpeg::create(['ffprobe' => '/usr/local/bin/ffprobe']);
• 调用 $ffprobe->streams($videoPath)->videos()->first() 看似简洁，但内部仍是执行命令+解析，性能和容错没本质提升
• 不要误以为它是“纯 PHP 实现”——它无法脱离 ffmpeg 生态独立工作

真正绕开系统命令的纯 PHP 方案（如手动解析 MP4 的 moov box）理论上可行，但 MP4、AVI、MKV 结构差异大，边缘 case 极多，维护成本远高于引入一个可靠命令行工具。生产环境别碰。