本教程详细阐述了在PHP中使用FFmpeg处理用户上传视频文件时，如何正确处理文件路径的问题。核心在于理解FFmpeg需要文件的绝对路径。文章将指导您完成文件上传到服务器的指定安全目录，并在此基础上，通过PHP脚本构建并执行FFmpeg命令，实现对视频文件的各种处理，确保操作的稳定性和安全性。
1. 理解FFmpeg与文件路径
在使用FFmpeg进行视频或图片处理时，FFmpeg程序本身并不知道PHP脚本运行时$_FILES数组中name属性所指示的文件名在文件系统中的实际位置。$_FILES["file"]["name"]仅提供上传文件的原始文件名，而$_FILES["file"]["tmp_name"]则指向文件上传到服务器后，在临时目录中的存储路径。FFmpeg需要的是文件在服务器文件系统中的绝对路径。
因此，直接将$_FILES["video"]["name"]或$_FILES["image"]["name"]传递给FFmpeg命令是不可行的，除非这些文件恰好与FFmpeg可执行文件或PHP脚本位于同一工作目录，这在实际应用中并不常见，且不安全。正确的做法是，首先将用户上传的文件从临时目录移动到服务器上一个可控、安全的持久化存储目录，然后将该文件的绝对路径传递给FFmpeg。
2. 安全地上传文件到服务器
在PHP中处理用户上传的文件，核心步骤是将文件从临时位置移动到一个您指定的服务器目录。这通过move_uploaded_file()函数实现。
立即学习“PHP免费学习笔记（深入）”；
文件上传脚本示例 (upload.php):
<?php
// 定义文件上传的目标目录
// 建议使用绝对路径，并确保该目录对Web服务器用户具有写入权限
$upload_dir = '/var/www/html/uploads/'; // 请根据您的服务器配置修改此路径，例如 /home/user/web_uploads/
// 确保上传目录存在且可写
if (!is_dir($upload_dir)) {
if (!mkdir($upload_dir, 0755, true)) {
die("错误：无法创建上传目录 " . $upload_dir);
}
}
$uploaded_video_path = '';
$uploaded_image_path = '';
// 处理视频文件上传
if (isset($_FILES['video']) && $_FILES['video']['error'] === UPLOAD_ERR_OK) {
// 对文件名进行安全处理，例如使用uniqid生成唯一文件名，防止冲突
$video_filename = basename($_FILES['video']['name']);
$uploaded_video_path = $upload_dir . uniqid('video_', true) . '_' . $video_filename;
if (move_uploaded_file($_FILES['video']['tmp_name'], $uploaded_video_path)) {
echo "视频文件上传成功: " . $uploaded_video_path . "\n";
} else {
echo "视频文件上传失败。\n";
// 实际应用中应记录更详细的错误日志
}
} else {
echo "未选择视频文件或视频上传出错。\n";
}
// 处理图片文件上传
if (isset($_FILES['image']) && $_FILES['image']['error'] === UPLOAD_ERR_OK) {
$image_filename = basename($_FILES['image']['name']);
$uploaded_image_path = $upload_dir . uniqid('image_', true) . '_' . $image_filename;
if (move_uploaded_file($_FILES['image']['tmp_name'], $uploaded_image_path)) {
echo "图片文件上传成功: " . $uploaded_image_path . "\n";
} else {
echo "图片文件上传失败。\n";
}
} else {
echo "未选择图片文件或图片上传出错。\n";
}
// 如果需要将这些路径传递给另一个脚本进行FFmpeg处理，可以使用会话、GET/POST参数或数据库
// 对于耗时操作，通常会将FFmpeg处理放入队列或异步执行
echo "准备进行FFmpeg处理...\n";
// 示例：将上传的路径存储到会话中，以便在另一个脚本中获取
/*
session_start();
$_SESSION['video_path'] = $uploaded_video_path;
$_SESSION['image_path'] = $uploaded_image_path;
header('Location: process_video.php'); // 重定向到处理脚本
exit;
*/
// 或者，如果操作不复杂且非异步，直接在此脚本中继续FFmpeg处理
// ... (见下一节FFmpeg处理)
?>关键点：
- $upload_dir: 这是文件在服务器上最终存储的位置。请务必选择一个Web服务器用户可写但又不在Web可访问根目录下的目录，以增加安全性。例如，/var/www/uploads/ 或 /home/user/web_uploads/。如果必须在Web可访问目录下，请确保配置Web服务器禁止直接访问该目录下的文件，或者至少禁止执行脚本。
- basename(): 用于从文件路径中提取文件名，防止路径遍历攻击。
- uniqid(): 结合原始文件名，生成一个唯一的文件名，避免文件覆盖冲突。
- 错误处理: 检查$_FILES['file']['error']以捕获上传过程中可能发生的错误。
3. 使用绝对路径执行FFmpeg命令
一旦文件被安全地上传到服务器并获得了其绝对路径，就可以将这些路径传递给FFmpeg命令。
FFmpeg处理脚本示例 (process_video.php):
<?php
// 假设您已经通过某种方式（例如会话、POST请求、数据库查询）获取了上传文件的绝对路径
// 这里为了演示，我们直接使用示例路径，实际应用中应替换为动态获取的路径
$uploaded_video_path = '/var/www/html/uploads/video_65c8e0a32e1d7_my_video.mp4'; // 替换为实际上传的视频绝对路径
$uploaded_image_path = '/var/www/html/uploads/image_65c8e0a32e1d8_overlay_image.png'; // 替换为实际上传的图片绝对路径
// 确保文件存在
if (!file_exists($uploaded_video_path) || !file_exists($uploaded_image_path)) {
die("错误：视频或图片文件不存在，无法进行FFmpeg处理。\n");
}
// 定义FFmpeg输出文件的目录
$output_dir = '/var/www/html/outputs/'; // 请根据您的服务器配置修改此路径
if (!is_dir($output_dir)) {
if (!mkdir($output_dir, 0755, true)) {
die("错误：无法创建输出目录 " . $output_dir);
}
}
// 1. 处理图片：调整图片大小
$output_resized_image_path = $output_dir . 'output_resized_' . uniqid() . '.jpeg'; // 输出图片路径
$command_resize_image = "ffmpeg -i " . escapeshellarg($uploaded_image_path) . " -s 128x128 " . escapeshellarg($output_resized_image_path);
echo "执行命令: " . $command_resize_image . "\n";
$resize_output = shell_exec($command_resize_image);
echo "图片大小调整结果:\n" . $resize_output . "\n";
if (file_exists($output_resized_image_path)) {
echo "图片已成功调整大小。\n";
} else {
echo "图片大小调整失败。请检查FFmpeg输出。\n";
}
// 2. 处理视频：叠加图片到视频上
$output_overlay_video_path = $output_dir . 'output_with_overlay_' . uniqid() . '.mp4'; // 输出视频路径
$command_overlay_video = "ffmpeg -i " . escapeshellarg($uploaded_video_path) . " -i " . escapeshellarg($output_resized_image_path);
$command_overlay_video .= " -filter_complex \"[0:v][1:v] overlay=25:25\"";
$command_overlay_video .= " -c:a copy " . escapeshellarg($output_overlay_video_path);
echo "执行命令: " . $command_overlay_video . "\n";
// 使用 system() 可以实时输出命令执行结果，但如果命令耗时，可能会导致PHP脚本超时
// 对于长时间运行的FFmpeg任务，推荐使用 exec() 或 passthru()，或将任务放入后台队列
system($command_overlay_video);
if (file_exists($output_overlay_video_path)) {
echo "图片已成功叠加到视频上，输出文件: " . $output_overlay_video_path . "\n";
} else {
echo "图片叠加到视频失败。请检查FFmpeg输出。\n";
}
// 清理临时文件 (可选，根据业务需求决定)
// unlink($uploaded_video_path);
// unlink($uploaded_image_path);
// unlink($output_resized_image_path); // 如果不再需要调整大小后的图片
?>关键点：
- escapeshellarg(): 这是非常重要的一步！它用于转义传递给shell命令的参数，以防止命令注入攻击。任何从用户输入获取的字符串，在作为命令行参数使用前，都应该通过escapeshellarg()进行处理。
-
shell_exec() 与 system():
- shell_exec(): 执行命令并返回完整的输出结果作为字符串。适用于需要捕获命令所有输出的情况。
- system()
