PHP 不能直接生成 MP4,需调用 ffmpeg 等外部工具;常见失败原因包括未安装 ffmpeg、权限不足、路径错误、函数被禁用或参数不安全,须按环境链路顺序排查。
PHP 本身不能直接“变成” MP4,它只是服务端脚本语言;真正生成或转码 MP4 的是外部命令行工具(如 ffmpeg),PHP 负责调用它们。如果你在服务器上执行 PHP 脚本却得不到 MP4 文件,大概率是没装 ffmpeg、权限不对、路径写错,或者 PHP 禁用了执行函数。
PHP 转 MP4 的核心依赖是 ffmpeg 命令行工具,不是 PHP 扩展。必须先在系统层面验证它是否存在且可用。
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 模块别用 exec() 直接拼接用户输入的参数,容易被注入。用 escapeshellarg() 包裹每个外部输入,并限制工作目录和超时。
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);
ffmpeg.exe 绝对路径,且反斜杠要双写或用正斜杠if (file_exists($mp4_path) && filesize($mp4_path) > 1024) { /* 成功 */ } else { /* 查 $output 错误日志 */ }不是代码写错,而是环境链路上某个环节断了。按顺序排查比重写逻辑更有效。
Permission denied:PHP 进程用户(如 www-data 或 nobody)没有 ffmpeg 执行权限,或输出目录不可写 —— 用 ls -l $(which ffmpeg)和
ls -ld /path/to/output/查看
frame_0001.png 实际叫 img_1.png),或帧率/编码参数不兼容播放器Unable to find a suitable output format:文件扩展名与实际编码不匹配,比如用了 .mp4 但指定了 -f avi;或 libx264 编码器未编译进当前 ffmpeg
timeout,大视频转码耗时超过 max_execution_time,建议改用后台队列(如 nohup php job.php > /dev/null 2>&1 &)真正难的不是写那几行 shell_exec(),而是让 ffmpeg 在你服务器的用户权限、PATH、磁盘空间、编码支持这四个约束下稳定跑通。每台服务器的“能用”状态都不一样
,别跳过 which、权限、输出重定向这些基础验证。