PHP不能直接将文件转为MP4,必须调用ffmpeg等外部工具;需确认ffmpeg已安装、PATH正确、exec未被禁用,并使用escapeshellarg()防止命令注入,最后通过HTTP响应或URL提供MP4。

PHP 本身不能把本地文件“变成” MP4 —— 它不是视频编码器,也没有内置的 FFmpeg 或 libx264 绑定。所谓“PHP 文件转 MP4”,实际是用 PHP 调用外部命令(如 ffmpeg)来处理音视频文件,比如把图片序列、文本、音频或已有视频转成 MP4。
如果你手头只有一个 .php 文件(比如 video.php),它本身不会“变成” MP4;你真正需要的是:让 PHP 触发一次视频生成任务,并输出 MP4 文件到磁盘或响应流。
确认系统已安装 ffmpeg 并可被 PHP 调用
PHP 无法凭空生成视频,必须依赖外部工具。最常用的是 ffmpeg,它支持从图像、音频、字幕甚至纯色画布合成 MP4。
常见错误现象:exec('ffmpeg -version') 返回空、command not found、或 PHP 报错 sh: ffmpeg: command not found
立即学习“PHP免费学习笔记(深入)”;
- 确保在终端执行
ffmpeg -version能正常输出版本号 - 如果是 WAMP/XAMPP/MAMP,PHP 进程可能使用不同 PATH,需显式指定完整路径,例如:
/usr/local/bin/ffmpeg(macOS/Linux)或C:\ffmpeg\bin\ffmpeg.exe(Windows) - 检查 PHP 的
disable_functions是否禁用了exec、shell_exec、system—— 在php.ini中搜索并移除这些函数名
用 PHP 调用 ffmpeg 合成一个最简 MP4(比如纯色画面 + 音频)
这是验证流程是否跑通的最小可行示例。目标:生成一个 5 秒的红色画面 MP4,带静音音频(避免 FFmpeg 报错“no audio stream”)。
exec('/usr/local/bin/ffmpeg -f lavfi -i color=c=red:s=1280x720:d=5 -f lavfi -i anullsrc=r=44100:cl=stereo -c:v libx264 -c:a aac -t 5 output.mp4 2>&1', $output, $return_code);
var_dump($return_code, $output);说明:
--f lavfi -i color=...:用 FFmpeg 内置滤镜生成纯色视频帧
- -f lavfi -i anullsrc=...:生成空白音频流(MP4 容器通常要求音视频共存,否则某些播放器打不开)
- -c:v libx264 -c:a aac:强制指定编码器,兼容性最好
- 2>&1:捕获错误输出,方便调试
- $return_code !== 0 表示失败,$output 里会有具体报错(如 Unknown encoder 'libx264' 说明编译时没启用 x264)
PHP 中处理用户上传的图片/音频 → 合成 MP4
典型场景:用户上传一张 PNG 和一个 MP3,PHP 把它们合成为带背景图+音频的 MP4。
关键点:
- 确保上传文件路径安全,不要直接拼接进 shell 命令(防命令注入)—— 用
escapeshellarg()包裹每个路径 - FFmpeg 对输入格式敏感:PNG 需要加
-loop 1才能当视频流用;MP3 长度若短于视频,需用-shortest或循环音频 - 合成命令示例(假设图片
/tmp/bg.png,音频/tmp/audio.mp3):
$cmd = '/usr/local/bin/ffmpeg -loop 1 -i ' . escapeshellarg('/tmp/bg.png') . ' -i ' . escapeshellarg('/tmp/audio.mp3') . ' -c:v libx264 -tune stillimage -c:a aac -b:a 192k -pix_fmt yuv420p -shortest -y /tmp/output.mp4 2>&1';
exec($cmd, $output, $return_code);注意:
--tune stillimage:优化静态图编码效率
- -pix_fmt yuv420p:保证 iOS/Android 播放兼容(很多设备不支持 yuv444p)
- -y:自动确认覆盖输出文件
- 不要用 shell_exec() 直接 echo 命令字符串调试 —— 特殊字符(空格、括号、&)会导致截断或执行异常
生成后如何提供下载或网页播放
PHP 生成 MP4 文件只是第一步。后续要让用户访问,有两条路:
-
直接输出文件流(适合小文件、一次性下载)
if (file_exists('/tmp/output.mp4')) { header('Content-Type: video/mp4'); header('Content-Length: ' . filesize('/tmp/output.mp4')); header('Content-Disposition: attachment; filename="video.mp4"'); readfile('/tmp/output.mp4'); exit; } -
返回 MP4 文件 URL(推荐)
把文件存到 Web 可访问目录(如
/var/www/html/videos/xxx.mp4),然后输出 HTML:注意权限:确保 Web 服务器用户(如
www-data或_www)有读取该 MP4 的权限;Windows 下 IIS/Apache 要确认 MIME 类型已注册.mp4 → video/mp4
真正的难点从来不在 PHP 写几行 exec,而在于 FFmpeg 参数组合是否满足目标容器规范、编码兼容性、错误捕获粒度、以及并发调用时的资源竞争(比如多个请求同时写同一个 output.mp4)。别跳过 escapeshellarg(),也别信“本地能跑线上就一定行”——生产环境 PATH、权限、超时限制,往往和开发机差很远。











