PHP跨平台转MP4本质是调用ffmpeg，需统一路径处理、环境检测与容错机制，并通过escapeshellarg()、显式编解码参数及Docker等方案适配三端差异。

PHP 本身不直接转码视频，所谓“跨平台 PHP 转 MP4”本质是用 PHP 调用系统级音视频工具（如 ffmpeg），再通过统一路径处理、错误容错和环境检测实现 Linux / Windows / Mac 三端可用。

确认 ffmpeg 是否可用且路径一致

所有平台都依赖 ffmpeg 命令行工具，但安装方式和默认路径差异大：

• Linux：通常 /usr/bin/ffmpeg 或 /usr/local/bin/ffmpeg，用 which ffmpeg 查
• macOS：Homebrew 安装后多在 /opt/homebrew/bin/ffmpeg（Apple Silicon）或 /usr/local/bin/ffmpeg（Intel），也可用 brew --prefix ffmpeg
• Windows：需手动下载静态编译版（如 https://www.gyan.dev/ffmpeg/builds/），解压后把 bin\ffmpeg.exe 所在目录加进系统 PATH，或在 PHP 中硬编码绝对路径（不推荐）

建议在 PHP 启动时检测：

if (!file_exists('/usr/bin/ffmpeg') && !file_exists('/opt/homebrew/bin/ffmpeg') && !file_exists('C:\ffmpeg\bin\ffmpeg.exe')) {
    throw new RuntimeException('ffmpeg not found in common paths');
}

更稳妥的做法是让运维/部署脚本写入配置项 FFMPEG_PATH 到环境变量，PHP 读取：getenv('FFMPEG_PATH')。

立即学习“PHP免费学习笔记（深入）”；

PHP exec() 调用 ffmpeg 的跨平台写法

Windows 对空格、反斜杠、引号更敏感；Linux/macOS 对权限和路径大小写敏感。关键点：

• 统一用正斜杠 / 或 DIRECTORY_SEPARATOR 拼接路径（PHP 自动适配）
• 所有含空格的路径（如 Windows 下 C:/Program Files/...）必须用双引号包裹，并用 escapeshellarg() 处理
• 避免直接拼接用户输入；视频文件名必须过滤或重命名成安全格式（如 preg_replace('/[^a-zA-Z0-9._-]/', '_', $name)）
• 显式指定输出格式，防止 macOS 上因 codec 差异导致无音频流：-c:v libx264 -c:a aac

示例命令（安全拼接）：

$input = escapeshellarg('/path/to/input.mov');
$output = escapeshellarg('/path/to/output.mp4');
$cmd = "ffmpeg -i {$input} -c:v libx264 -c:a aac -y {$output}";
exec($cmd, $output_lines, $return_code);

Windows 下 exec() 失败的常见原因

不是 PHP 配置问题，而是 Windows 环境限制更严格：

• exec() 默认被禁用：检查 disable_functions 是否含 exec，Apache/IIS 进程用户需有执行 ffmpeg.exe 权限
• GUI 弹窗干扰：Windows Server 默认启用“桌面交互”关闭，ffmpeg 若触发 GUI 报错会卡住 —— 必须加 -nostdin -y
• 中文路径乱码：Windows 控制台默认 GBK，而 PHP 文件系统调用是 UTF-8；最稳方案是避开中文路径，或用 mb_convert_encoding($path, 'GBK', 'UTF-8')（仅 Windows 分支）
• 杀毒软件拦截：某些国产软件会静默终止 ffmpeg.exe 进程，需加白名单

替代方案：用 Docker 统一运行时环境

如果部署可控（如云服务器、CI/CD），比适配三端更简单的是绕过本地环境差异：

• 写一个最小 Dockerfile，基于 ubuntu:22.04 + ffmpeg + php:8.2-cli
• PHP 脚本只负责生成命令、挂载输入/输出卷，docker run --rm -v $(pwd)/in:/in -v $(pwd)/out:/out ...
• 完全屏蔽 Windows/macOS 底层差异，也规避了权限、编码、路径问题

缺点是无法用于共享主机（如 cPanel）、或客户本地 XAMPP 环境 —— 这类场景只能老实用 escapeshellarg() + 显式路径探测。

真正难的不是写对一条命令，而是确保 ffmpeg 在任意机器上可执行、输入路径可读、输出路径可写、错误能被捕获并返回给前端 —— 其他都是细节补丁。