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 在任意机器上可执行、输入路径可读、输出路径可写、错误能被捕获并返回给前端 —— 其他都是细节补丁。
