php视频转码失败时，退出码通常由底层命令（如ffmpeg）返回，需通过执行函数的返回值获取。在php中，使用`proc_open`或`shell_exec`配合`$status`变量可捕获该值；若使用`exec()`函数，第三个参数即为退出码。常见非零值代表不同错误：1为通用错误，2为配置问题，10-13为编码/解码器相关错误，14为音频流处理错误，15为视频流处理错误，16为复用器错误，17为比特流过滤错误，19为输入文件无法打开，20为输出文件无法打开，21为写入错误，22为格式未注册，23为编码器未注册，24为解码器未注册，25为过滤器未注册，26为选项无效，27为内存分配失败，28为内部bug，29为中断信号，30为未知错误。
如何获取FFmpeg的退出码
在PHP中调用FFmpeg时，推荐使用`proc_open`以精确控制进程并获取退出码。通过读取标准错误输出，可以进一步定位具体错误原因。以下代码展示了如何启动FFmpeg进程、等待其完成并获取退出码及错误信息。
$command = 'ffmpeg -i input.mp4 output.avi 2>&1';
$descriptorspec = array(
0 => array('pipe', 'r'), // stdin
1 => array('pipe', 'w'), // stdout
2 => array('pipe', 'w') // stderr
);
$process = proc_open($command, $descriptorspec, $pipes);
if (is_resource($process)) {
fclose($pipes[0]);
$stderr = stream_get_contents($pipes[2]);
fclose($pipes[1]);
fclose($pipes[2]);
$return_value = proc_close($process);
echo "Exit Code: $return_value\n";
echo "Error Output: $stderr\n";
}
上述代码将FFmpeg的标准错误输出重定向到标准输出，以便在PHP中捕获。`proc_close`返回的值即为FFmpeg进程的退出码。如果退出码为非零值，则表明转码失败。结合错误输出内容，可以更准确地诊断问题。
立即学习“PHP免费学习笔记（深入）”；
常见退出码及其含义
FFmpeg的退出码遵循一定的规范，大多数情况下，退出码1表示通用错误，而其他特定范围的退出码对应不同类型的错误。例如，退出码10-13通常与编码或解码器有关，14-15与音视频流处理有关，16-17与复用器和比特流过滤有关。了解这些退出码有助于快速定位问题。
// 示例：检查退出码并给出提示
switch ($return_value) {
case 0:
echo "Transcoding successful.";
break;
case 1:
echo "General error occurred.";
break;
case 10:
echo "Encoder or decoder issue.";
break;
case 14:
echo "Audio stream processing error.";
break;
case 15:
echo "Video stream processing error.";
break;
default:
echo "Unknown error with code: $return_value";
break;
}
通过上述代码，可以根据不同的退出码给出具体的错误提示。这有助于开发者快速识别和解决转码过程中遇到的问题。需要注意的是，FFmpeg的退出码可能会随着版本更新而变化，因此建议查阅最新文档以获取准确信息。
基于输入文件无法打开的退出码分析
当FFmpeg尝试打开输入文件失败时，通常会返回退出码19。这可能是由于文件路径错误、权限不足或文件格式不支持等原因导致。在实际开发中，应确保输入文件路径正确且具备读取权限，同时验证文件格式是否符合FFmpeg支持的范围。
// 示例：检查输入文件是否存在及可读性
$inputFile = 'input.mp4';
if (!file_exists($inputFile)) {
echo "Input file does not exist.";
} elseif (!is_readable($inputFile)) {
echo "Input file is not readable.";
} else {
// 继续执行转码逻辑
}
在执行转码之前，先对输入文件进行存在性和可读性检查，可以有效避免因文件问题导致的转码失败。此外，还可以结合日志记录功能，详细记录每次转码操作的输入文件路径、退出码及错误信息，便于后续排查和分析。
