首先检查文件接收情况，确认PHP能正确获取上传的视频数据。使用var_dump($_FILES)查看文件信息，确保表单设置了enctype="multipart/form-data"且请求方式为POST。接着验证php.ini中upload_max_filesize和post_max_size配置是否支持大文件上传。若上传成功，则进入第二步：通过finfo_file()检测MIME类型，防止仅依赖扩展名导致的安全问题，并将文件移至临时目录保存。第三步调试FFmpeg转码，利用shell_exec()执行命令并附加2>&1捕获错误输出，确保PHP用户有权限访问输入输出路径，同时在终端手动测试相同命令验证可行性。最后，通过error_log()记录关键步骤日志，接口返回结构化JSON信息，便于追踪问题。整个流程需逐步验证上传、校验、存储与转码环节，重点关注权限、路径拼写及MIME限制等易错细节。
调试 PHP 接口中的视频上传与转码功能，关键在于分步验证每个环节是否正常工作。从文件接收、格式校验、临时存储到调用转码工具（如 FFmpeg），每一步都可能出错。下面介绍几种实用的调试方法，帮助你快速定位问题。
1. 检查视频上传接口的接收情况
确保前端传来的视频数据能被 PHP 正确接收：
- 使用 var_dump($_FILES) 查看上传的文件信息，确认文件是否成功提交
- 检查 php.ini 配置：upload_max_filesize、post_max_size 是否支持大文件上传
- 验证表单是否设置 enctype="multipart/form-data"
- 打印 $_SERVER['REQUEST_METHOD'] 确认请求方式为 POST
示例代码片段：
if ($_FILES['video']['error'] === UPLOAD_ERR_OK) {
echo "文件名：" . $_FILES['video']['name'] . "\n";
echo "大小：" . $_FILES['video']['size'] . " 字节\n";
} else {
echo "上传错误代码：" . $_FILES['video']['error'];
}
2. 验证视频文件合法性与临时保存
上传后需判断文件类型和完整性，避免非法文件或损坏视频：
立即学习“PHP免费学习笔记（深入）”；
- 使用 finfo_file() 检测 MIME 类型，不能仅依赖扩展名
- 将文件移动到临时目录，并记录路径用于后续转码
- 添加日志记录，例如写入 error_log() 或自定义 log 文件
示例：
$finfo = finfo_open(FILEINFO_MIME_TYPE);
$mime = finfo_file($finfo, $_FILES['video']['tmp_name']);
if (!in_array($mime, ['video/mp4', 'video/avi', 'video/mov'])) {
die("不支持的视频格式");
}
$uploadPath = '/tmp/' . uniqid() . '.mp4';
move_uploaded_file($_FILES['video']['tmp_name'], $uploadPath);
3. 调试 FFmpeg 转码命令执行
PHP 通常通过 exec()、shell_exec() 或 proc_open() 调用 FFmpeg，容易因权限、路径或参数错误失败：
- 在命令后追加 2>&1 捕获错误输出，例如：
$output = shell_exec("ffmpeg -i $input $outputPath 2>&1"); - 打印完整命令并在服务器终端手动执行，验证是否可行
- 确保 PHP 运行用户（如 www-data）有权限读写输入输出目录
- 检查系统是否安装 FFmpeg：运行 ffmpeg -version 确认
建议添加超时控制和资源监控，防止大文件长时间占用服务器资源。
4. 使用日志与响应返回辅助调试
每次请求记录关键步骤，便于排查线上问题：
- 使用 error_log() 记录上传路径、转码命令、执行结果
- 接口返回 JSON 格式结果，包含 status、message、data 字段
- 在开发环境开启 display_errors 和 error_reporting(E_ALL)
返回示例：
header('Content-Type: application/json');
echo json_encode([
'status' => 'success',
'message' => '转码完成',
'data' => ['url' => '/videos/output.mp4']
]);
基本上就这些。只要一步步验证上传、校验、保存、转码流程，结合日志输出和命令行测试，大多数问题都能快速定位。关键是别跳过小细节，比如权限、路径拼写、MIME 类型限制等，这些最容易导致“看似正确却没反应”的情况。
