在phpdocker环境中使用ffmpeg转视频，核心做法是确保dockerfile安装了`ffmpeg`二进制文件，并在php代码中通过`shell_exec()`或`proc_open()`调用该命令。这样做可以直接利用容器内的系统工具处理媒体文件，无需安装额外的php扩展。如果输入视频路径正确且权限允许，php进程将返回转换后的文件路径或标准输出日志。
如何配置Docker环境以支持ffmpeg
要让PHP容器识别并执行ffmpeg，必须在构建镜像时安装对应的系统包。对于基于Debian或Ubuntu的基础镜像，使用`apt-get install ffmpeg`即可；若使用Alpine，则需使用`apk add ffmpeg`。配置完成后，PHP脚本可以通过系统环境变量或绝对路径访问该命令。这一步解决了“找不到命令”的常见报错，确保运行时依赖到位。
FROM php:8.1-apache
RUN apt-get update && apt-get install -y \
ffmpeg \
&& rm -rf /var/lib/apt/lists/*
COPY . /var/www/html
WORKDIR /var/www/html
上述Dockerfile片段展示了基础配置。构建镜像后，容器内即包含ffmpeg可执行文件。PHP代码中可直接调用`ffmpeg`，无需指定完整路径，除非将其放置在非PATH目录。建议同时挂载宿主机目录到容器内，以便方便地传入待转码视频和获取结果文件。
立即学习“PHP免费学习笔记（深入）”；
Docker Hub (hub.docker.com)。此技能适用于所有 Docker Hub 操作，包括读取、创建、更新和删除数据。只要任务涉及 Docker Hub，就使用此技能。
如何在PHP代码中调用ffmpeg进行转码
在PHP中调用ffmpeg通常使用`shell_exec`函数执行命令行字符串。例如，将MP4视频转换为WebM格式，命令结构为`ffmpeg -i input.mp4 output.webm`。PHP代码负责拼接这个字符串并捕获输出。若转换成功，函数返回null或空字符串（取决于ffmpeg版本和参数）；若失败，错误信息会写入stderr，需通过重定向捕获。这种方法简单直接，适合大多数常规转码任务。
<?php
$input = '/var/www/html/input.mp4';
$output = '/var/www/html/output.webm';
$cmd = "ffmpeg -i $input -c:v libvpx -b:v 1000k $output";
$output_str = shell_exec($cmd);
if ($output_str === null) {
echo "Command failed or returned nothing.";
} else {
echo "Conversion completed.";
}
?>
这段代码演示了基本调用流程。注意，`shell_exec`默认不返回stderr内容，因此调试困难时建议使用`proc_open`并重定向stderr到文件。此外，务必验证输入文件存在且可读，避免ffmpeg因权限问题静默失败。转码参数如比特率、编码器可根据需求调整，但核心调用逻辑不变。
当输入文件不存在时ffmpeg会返回什么
如果指定的输入文件路径无效或文件不存在，ffmpeg会在标准错误流输出类似“No such file or directory”的错误信息，并返回非零退出状态码。在PHP中，若使用`shell_exec`，由于它不直接暴露退出状态码，开发者可能误以为命令成功执行（因为函数可能返回null）。实际上，检查输出文件或依赖`proc_open`获取退出码是更可靠的做法。此行为表明，必须在前置逻辑中校验文件存在性，否则后续步骤将不可靠。
