video_get_thumb() 抽帧失败主因是 FFmpeg 未正确安装或配置，需用 exec 检查返回码，安装对应系统包，授权 Web 用户执行权限，路径需 escapeshellarg() 转义，并用 -ss（置于 -i 前）跳转中段再抽帧以避免黑图。
video_get_thumb() 提取帧失败，先确认 FFmpeg 是否真可用
PHP 本身不支持直接从视频抽帧，video_get_thumb() 是伪函数——实际依赖外部命令行工具 FFmpeg。很多开发者写了逻辑却卡在“黑图”或空输出，根源常是 FFmpeg 没装、没配 PATH 或权限被禁。
实操建议：
- 用
exec('ffmpeg -version', $output, $return)检查返回码：$return !== 0 表示不可用 - Ubuntu/Debian 装
sudo apt install ffmpeg；CentOS/RHEL 用yum install ffmpeg或 EPEL 源 - Web 服务用户（如 www-data）可能无权执行系统命令，需在
/etc/sudoers中加www-data ALL=(ALL) NOPASSWD: /usr/bin/ffmpeg（慎用，仅限可信环境） - 别依赖
shell_exec()直接拼接路径——视频路径含空格或中文时会崩，改用escapeshellarg()包裹
用 ffmpeg -ss 提前定位再 -vframes 1，否则首帧常是黑场
很多视频封装格式（如 MP4 的 H.264）首帧是 I 帧，但有些编码或剪辑软件导出的文件，前几秒全是 B/P 帧，直接 -vframes 1 抽第 0 秒得到的是黑图或花屏。
正确做法是跳到视频中段再抽帧：
立即学习“PHP免费学习笔记（深入）”；
- 命令必须带
-ss且放在-i之前（快进靠解复用，速度快），例如：ffmpeg -ss 00:00:03 -i input.mp4 -vframes 1 -y thumb.jpg - 避免用
-ss精确到毫秒（如00:00:03.5），某些版本 FFmpeg 不稳定；统一用秒级 - 抽帧后立即检查输出文件尺寸：
if (filesize($thumbPath)
GD 库转 WebP 时 quality=80 不等于 JPEG 的 80，得重测
imagewebp() 的 quality 参数行为和 imagejpeg() 不同：它对细节保留更敏感，同一数值下 WebP 体积通常比 JPEG 小 25%~35%，但若盲目沿用 JPEG 的 80，可能过度压缩导致文字标题边缘发虚、渐变色 banding 加重。
实操建议：
- 对封面图这类含文字/图标的内容，优先试
quality = 90；纯摄影类可降为 75–80 - 别省略
header('Content-Type: image/webp')—— 缺这个头，浏览器当二进制下载或乱码 - WebP 不支持 CMYK，抽帧生成的 JPG 若含 ICC 配置文件，
imagecreatefromjpeg()会丢色域，建议加imagecolorallocate()初始化画布再 copy，或改用 Imagick 保留色彩空间 - GD 对 WebP 的 alpha 通道支持有限，若原视频帧有半透明区域，
imagesavealpha($webpImg, true)必须配imagealphablending($webpImg, false)才生效
前端 <picture> fallback 写错，老浏览器照样挂
只写 <source srcset="cover.webp" type="image/webp"> 不够。iOS Safari 13 以下、Android UC 等仍占一定份额，它们不识别 WebP 但会加载 <img> 标签——如果 <img> 的 src 指向 .webp 地址，就 404 或乱码。
安全写法：
-
<picture>内必须嵌套一个<img src="cover.jpg" ...>，且src指向 JPEG/PNG 备份图 - 备份图不能是“随便生成的”，得和服务端生成 WebP 的同一帧、同尺寸、同 quality（比如都用 80），否则视觉割裂
- 别把 WebP 和 JPEG 存同名不同扩展（
cover.jpg+cover.webp），CDN 缓存易混淆；建议用独立路径：/thumbs/cover@webp.jpg和/thumbs/cover@jpg.jpg - 服务端生成 WebP 后，立刻用
file_exists()检查 JPEG 备份是否存在，不存在则同步生成，避免前端 fallback 失效
header() 漏写、fallback 路径错位这三处——它们不报错，只静默失败。 
