PHP无法直接转MP4，必须依赖ffmpeg命令行工具；需确保系统已安装ffmpeg、PHP启用exec类函数且未禁用、进程有文件读写权限；推荐用proc_open()替代exec()以获取实时进度；Web环境下应避免同步转码，改用异步队列处理。
PHP 本身不能直接转 MP4，必须调用外部命令行工具
PHP 没有内置视频编码能力，ffmpeg 是实际执行转码的核心。PHP 只负责拼接命令、调用 exec() 或 shell_exec() 启动它。如果你只装了 PHP 而没装 ffmpeg，任何 PHP 视频转换代码都会失败，报错类似 'ffmpeg' is not recognized as an internal or external command（Windows）或 sh: ffmpeg: command not found（Linux/macOS）。
验证是否就绪，终端运行：
ffmpeg -version
看到版本号才算通过。否则先安装 ffmpeg（Linux 用 apt install ffmpeg 或 brew install ffmpeg；Windows 下需下载静态二进制并加到系统 PATH）。
PHP 需要启用 exec 类函数且禁用安全限制
默认某些 PHP 环境（尤其共享主机）会禁用执行系统命令的函数，常见表现是 exec() 返回空数组、shell_exec() 返回 null，且无错误提示。
立即学习“PHP免费学习笔记（深入）”；
- 检查
disable_functions：运行phpinfo()，搜索该配置项，确认未包含exec、shell_exec、system、passthru - 检查
safe_mode（已废弃但旧配置可能残留）：必须为Off - 确保 PHP 进程有权限读取输入文件、写入输出目录（如 Web 服务器用户
www-data或_www需对/var/www/html/uploads/有写权限）
推荐用 proc_open() 替代 exec() 获取实时进度和错误
exec() 只能等命令结束才返回全部输出，无法监控转码进度，也容易因超时被 Nginx/Apache 中断。而 proc_open() 可以捕获标准输出和错误流，适合做进度条或失败诊断。
最小可用示例（将 MP3 转为带黑边的 MP4）：
$descriptorspec = [
0 => ["pipe", "r"],
1 => ["pipe", "w"],
2 => ["pipe", "w"]
];
$process = proc_open(
'ffmpeg -y -i "/path/to/input.mp3" -c:v libx264 -vf "pad=ceil(iw/2)*2:ceil(ih/2)*2" -c:a aac "/path/to/output.mp4"',
$descriptorspec,
$pipes
);
if (is_resource($process)) {
fclose($pipes[0]);
$output = stream_get_contents($pipes[1]);
$error = stream_get_contents($pipes[2]);
fclose($pipes[1]);
fclose($pipes[2]);
$return_code = proc_close($process);
if ($return_code !== 0) {
error_log("FFmpeg failed: " . $error);
}
}
Web 环境下转 MP4 的关键约束不能忽略
在浏览器触发的 PHP 请求中做视频转码，极易出问题：
- PHP
max_execution_time默认 30 秒，大视频必然超时 → 改为set_time_limit(0)或异步处理 - Apache/Nginx 有自身超时（如 Nginx
fastcgi_read_timeout），仅改 PHP 不够 - 大文件上传需调整
upload_max_filesize和post_max_size - 不建议在 Web 请求周期内直接转码，更稳妥做法是：上传后写入队列（Redis/RabbitMQ），由后台常驻进程（PHP CLI 脚本）消费并调用
ffmpeg
真正跑通，靠的不是“PHP 配置”，而是 ffmpeg 是否可用、PHP 是否允许调用它、以及整个请求生命周期是否被中间件掐断 —— 这三点漏掉任一，都会卡在“没反应”或“白屏”。
