查看 php-ffmpeg 报错信息的核心做法是捕获 exception 对象并调用其 getoutput() 方法获取 ffmpeg 的标准错误输出，同时通过 geterroroutput() 获取 php 层面的执行错误。如果程序抛出异常，直接打印异常消息即可定位问题；若未抛出异常但命令失败，则需检查返回状态码并读取对应的错误流。
如何捕获 FFmpeg 进程的标准错误输出
当使用 run() 或 start() 方法执行命令时，FFmpeg 产生的日志（如编码参数错误、文件损坏等）会被写入标准错误流。开发者可以通过 Process 对象的 getOutput() 方法获取这些内容。需要注意的是，getOutput() 通常返回标准输出，而 getErrorOutput() 返回标准错误，具体取决于底层封装的实现，但在大多数 php-ffmpeg 版本中，getOutput() 会包含混合输出或主要错误信息。为了准确获取 FFmpeg 的报错，应优先检查 getOutput() 和 getErrorOutput() 的内容。
$ffmpeg = FFMpeg\FFMpeg::create($config);
$video = $ffmpeg->open('path/to/video.mp4');
try {
$video->filters()->resize(new \FFMpeg\Coordinate\Dimension(320, 240));
$video->save('path/to/output.mp4');
} catch (\Exception $e) {
// 获取 FFmpeg 输出的错误信息
echo $e->getMessage();
if ($e instanceof \FFMpeg\Exception\FFMpegException) {
echo $e->getOutput();
echo $e->getErrorOutput();
}
}
上述代码展示了在保存视频时捕获异常并输出详细错误信息的流程。如果 FFmpeg 命令执行失败，getMessage() 通常会给出简短描述，而 getOutput() 和 getErrorOutput() 则提供完整的 FFmpeg 终端输出，便于排查具体原因，如编解码器不支持或参数无效。
立即学习“PHP免费学习笔记（深入）”；
如何处理未抛出异常的静默失败
在某些情况下，FFmpeg 命令可能不会抛出 PHP 异常，而是以非零退出码结束。此时，开发者需要手动检查 Process 对象的 isSuccessful() 方法。如果返回 false，则必须调用 getOutput() 和 getErrorOutput() 来获取错误详情。这种做法适用于直接使用底层 Process 对象或通过 run() 方法执行自定义命令的场景。
$process = $ffmpeg->commandFromMediaObject($video)->save('path/to/output.mp4');
if (!$process->isSuccessful()) {
echo "FFmpeg command failed:\n";
echo "Output: " . $process->getOutput() . "\n";
echo "Error: " . $process->getErrorOutput() . "\n";
}
该代码片段演示了如何检查命令执行状态并在失败时输出错误信息。通过这种方式，可以确保即使在没有异常抛出的情况下，也能捕获到 FFmpeg 的详细错误日志，从而进行有效的调试和问题定位。
基于输入文件路径错误的常见问题排查
在实际开发中，最常见的报错之一是输入文件路径错误或文件不存在。当传入的路径指向一个不存在的文件或权限不足时，FFmpeg 会立即报错并终止执行。开发者应首先验证文件路径的有效性，并确保 Web 服务器用户具有读取权限。此外，如果路径中包含特殊字符或空格，需要进行适当的转义或使用绝对路径以避免解析错误。
$inputPath = 'path/to/nonexistent.mp4';
if (!file_exists($inputPath)) {
die("Input file does not exist: $inputPath");
}
$video = $ffmpeg->open($inputPath); // 这将抛出异常
以上代码展示了在打开视频文件前检查文件存在性的最佳实践。通过预先验证输入条件，可以避免不必要的异常抛出，并提供更清晰的错误提示，帮助快速定位问题根源。
