php调用ffmpeg生成gif必须用-exec或shell_exec执行命令，-ss须在-i前、-t控制时长≤3s、-vf设fps和scale、强制输出gif并加-y覆盖；需escapeshellarg()防注入，捕获错误输出并验证ffmpeg可用性、权限及路径；优化参数如-gifflags+transdiff、-dither bayer可减体积保清晰；windows下注意路径空格、编码及函数禁用问题。
PHP调用FFmpeg生成GIF预览片段必须知道的命令结构
PHP本身不处理视频帧，必须依赖外部工具，ffmpeg是唯一可靠选择。直接用exec()或shell_exec()调用，但参数顺序和精度控制极易出错。
-
-ss必须放在-i之前（否则跳转不准，耗时暴涨） -
-t控制截取时长（建议 ≤3s，否则GIF体积爆炸） -
-vf中的fps=10,scale=320:-1:flags=lanczos是平衡清晰度与体积的关键组合 - 输出格式强制用
gif，别漏掉-y覆盖已有文件，否则失败静默
典型命令：ffmpeg -ss 5.5 -i input.mp4 -t 2.0 -vf "fps=10,scale=320:-1:flags=lanczos" -y preview.gif
PHP中执行FFmpeg命令的容错写法
直接拼接字符串调用exec()极不安全，路径含空格、特殊字符会崩；且错误信息被吞掉，调试困难。
- 用
escapeshellarg()包裹所有路径和参数值（包括$input_path、$output_path） - 捕获完整输出：
exec($cmd . ' 2>&1', $output, $return_code)，检查$return_code !== 0才算失败 - 提前验证
ffmpeg是否可用：exec('which ffmpeg', $which, $code)，$code !== 0就别往下走了 - 临时目录权限必须可写，且注意PHP运行用户（如
www-data）能否访问源视频文件
GIF体积过大或模糊的常见原因和对策
生成的GIF动不动几MB，网页加载卡死，或文字/边角糊成一片——基本不是PHP问题，而是FFmpeg参数没压住。
- 默认色彩映射质量差，加
-gifflags +transdiff和-dither bayer提升动效过渡 - 尺寸超宽导致像素过多，
scale=320:-1比scale=-1:240更稳（避免高度非整数引发重采样失真） - 不要用
-r设帧率，它影响输入采样；用-vf fps=8才真正控制输出帧率 - 若仍过大，加
-lavfi palettegen+paletteuse两步法（但PHP里需两次exec，慎用）
简版优化命令：ffmpeg -ss 3 -i input.mp4 -t 1.5 -vf "fps=8,scale=320:-1:flags=lanczos" -gifflags +transdiff -dither bayer -y preview.gif
Windows下PHP调用FFmpeg的坑
本地开发用Windows？ffmpeg.exe路径带空格（比如C:Program Files fmpegin fmpeg.exe）是最大雷区，escapeshellarg()能救但容易漏。
- 绝对路径必须用正斜杠或双反斜杠：
C:/ffmpeg/bin/ffmpeg.exe或C:\ffmpeg\bin\ffmpeg.exe - 确保PHP的
disable_functions没禁掉exec、shell_exec（查看phpinfo()） - Windows终端默认编码是GBK，而FFmpeg输出日志可能是UTF-8，
iconv('UTF-8', 'GB2312//IGNORE', $output)再显示，否则中文报错变乱码 - 别用
system()——它会阻塞PHP进程直到FFmpeg结束，大视频可能超时
实际部署强烈建议切到Linux环境，FFmpeg行为更一致，权限和路径问题少一半。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
