ThinkPHP上传视频后需调用系统FFmpeg命令生成缩略图，核心是上传成功后用exec执行ffmpeg -ss 1 -i 视频路径 -vframes 1 -q:v 2 缩略图路径，并校验返回码、路径权限及MIME真实性。
ThinkPHP上传视频后怎么调用FFmpeg生成缩略图
必须自己调用系统命令，ThinkPHP本身不提供视频帧提取能力。核心是上传成功后，用exec或shell_exec跑ffmpeg命令抽关键帧，再把生成的图片路径存进数据库。
常见错误是直接在控制器里写ffmpeg -i input.mp4 -ss 1 -vframes 1 thumb.jpg却没加错误处理，结果ffmpeg没装、路径含空格、权限不足时静默失败，缩略图根本没生成。
- 确保服务器已安装
ffmpeg且在$PATH中（执行which ffmpeg能返回路径） - 视频文件路径必须是绝对路径，相对路径在CLI环境下极大概率失效
- 加
-y参数避免交互式确认，否则命令会卡住 - 用
-vframes 1而非-frames:v 1（后者在旧版FFmpeg中不兼容） - 捕获
exec的返回值和错误输出：exec($cmd, $output, $returnCode)，$returnCode !== 0就说明抽帧失败
ThinkPHP上传验证要拦住非视频文件和超大文件
仅靠前端accept="video/*"毫无意义，后端必须校验MIME和实际文件头。用户改个扩展名就能绕过，比如把evil.exe改成test.mp4。
ThinkPHP的validate(['file' => 'fileExt:mp4,mov,avi|fileMime:video/mp4,video/quicktime,video/x-msvideo'])只能挡一部分，真正可靠的是读取文件前几个字节比对魔数。
立即学习“PHP免费学习笔记（深入）”；
- MP4文件开头4字节通常是
0x00 0x00 0x00 0x18或ftyp字符串，可用fopen($file, 'rb')+fread验证 - 限制
upload_max_filesize和post_max_size（PHP配置），否则大视频直接500或超时 - ThinkPHP的
maxSize单位是字节，别写成2048以为是MB——实际是2KB - 上传临时文件可能被
opcache.restrict_api或SELinux拦截，测试时先关掉这些限制
缩略图时间点选1秒还是关键帧？FFmpeg参数怎么设才不糊
用-ss 1快但不准，FFmpeg会跳到最近的关键帧（可能是第0.8秒或1.3秒），导致画面模糊或黑屏；用-ss 1 -vframes 1顺序解码才准，但慢十倍以上。
生产环境折中方案：先用-ss粗略定位，再加-q:v 2（质量1-31，值越小越好）和-vf scale=320:-1控制尺寸，避免生成几MB的大图。
-
-ss放命令最前面（快）：ffmpeg -ss 1 -i input.mp4 -vframes 1 -q:v 2 thumb.jpg -
-ss放-i后面（准但慢）：ffmpeg -i input.mp4 -ss 1 -vframes 1 -q:v 2 thumb.jpg - 强制指定尺寸用
-vf "scale=320:-2"（-2保持宽高比，-1可能报错） - 避免透明通道问题：MP4可能带alpha，加
-pix_fmt yuv420p保证兼容性
Linux下权限和路径问题怎么排查
ThinkPHP跑在Web服务器（如Nginx+PHP-FPM）下，默认用户是www-data或nginx，它可能没权限读上传目录、写缩略图目录，更没权限执行ffmpeg。
典型现象：本地php test.php能生成缩略图，但浏览器访问就失败，error_log里只有空行或Permission denied。
- 检查上传目录和缩略图目录的属主：
chown -R www-data:www-data /path/to/upload - 确认
ffmpeg二进制可执行：chmod +x $(which ffmpeg) - 禁用
disable_functions里的exec,shell_exec,system（PHP配置） - 测试命令是否真能跑：
sudo -u www-data ffmpeg -version，不是sudo su www-data再执行 - 路径含中文或空格？一律用
escapeshellarg()包裹，例如escapeshellarg($videoPath)
最麻烦的其实是FFmpeg版本差异——CentOS 7默认的2.8不支持libvpx-vp9，而某些WebP缩略图需求会卡在这里；还有Windows下反斜杠路径、杀毒软件拦截ffmpeg.exe进程的问题。这些没法靠框架解决，得一层层敲命令验证。
