php转mp4需要什么环境_php运行环境配置视频转换说明【说明】

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，且无错误提示。

• 检查 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 是否允许调用它、以及整个请求生命周期是否被中间件掐断 —— 这三点漏掉任一，都会卡在“没反应”或“白屏”。