PHP 不能直接生成 MP4，需调用 ffmpeg 等外部工具；常见失败原因包括未安装 ffmpeg、权限不足、路径错误、函数被禁用或参数不安全，须按环境链路顺序排查。
PHP 本身不能直接“变成” MP4，它只是服务端脚本语言；真正生成或转码 MP4 的是外部命令行工具（如 ffmpeg），PHP 负责调用它们。如果你在服务器上执行 PHP 脚本却得不到 MP4 文件，大概率是没装 ffmpeg、权限不对、路径写错，或者 PHP 禁用了执行函数。
确认服务器是否已安装 ffmpeg
PHP 转 MP4 的核心依赖是 ffmpeg 命令行工具，不是 PHP 扩展。必须先在系统层面验证它是否存在且可用。
- SSH 登录服务器后运行：
which ffmpeg
或ffmpeg -version
，有输出说明已安装 - 若提示
command not found，需手动安装：apt install ffmpeg
（Debian/Ubuntu）或yum install epel-release && yum install ffmpeg
（CentOS/RHEL） - 某些面板（如宝塔）可能把
ffmpeg装在非标准路径（如/www/server/panel/install/ffmpeg/ffmpeg），PHP 调用时得写全路径 -
phpinfo()里查不到ffmpeg—— 它和gd、curl这类扩展不同，不依赖 PHP 模块
PHP 中安全调用 ffmpeg 生成 MP4
别用 exec() 直接拼接用户输入的参数，容易被注入。用 escapeshellarg() 包裹每个外部输入，并限制工作目录和超时。
- 确保 PHP 配置允许执行命令：
disable_functions中不能包含exec、shell_exec、system - 推荐用
shell_exec()获取完整输出，配合timeout防卡死：$cmd = 'timeout 300 /usr/bin/ffmpeg -y -f image2 -framerate 24 -i "/path/to/frame_%04d.png" -c:v libx264 -pix_fmt yuv420p /path/to/output.mp4 2>&1';$output = shell_exec($cmd);
- 注意：Windows 服务器要用
ffmpeg.exe绝对路径，且反斜杠要双写或用正斜杠 - 生成 MP4 后务必检查返回值和文件是否存在：
if (file_exists($mp4_path) && filesize($mp4_path) > 1024) { /* 成功 */ } else { /* 查 $output 错误日志 */ }
常见失败原因和对应检查点
不是代码写错，而是环境链路上某个环节断了。按顺序排查比重写逻辑更有效。
立即学习“PHP免费学习笔记（深入）”；
-
Permission denied：PHP 进程用户（如www-data或nobody）没有ffmpeg执行权限，或输出目录不可写 —— 用ls -l $(which ffmpeg)
和ls -ld /path/to/output/
查看 - 空 MP4 或只有几 KB：多数因输入帧路径错误（比如
frame_0001.png实际叫img_1.png），或帧率/编码参数不兼容播放器 -
Unable to find a suitable output format：文件扩展名与实际编码不匹配，比如用了.mp4但指定了-f avi；或libx264编码器未编译进当前ffmpeg - PHP 页面卡住无响应：没设
timeout，大视频转码耗时超过max_execution_time，建议改用后台队列（如nohup php job.php > /dev/null 2>&1 &）
真正难的不是写那几行 shell_exec()，而是让 ffmpeg 在你服务器的用户权限、PATH、磁盘空间、编码支持这四个约束下稳定跑通。每台服务器的“能用”状态都不一样，别跳过 which、权限、输出重定向这些基础验证。
