GD库比例裁剪需先按max(目标宽/原宽,目标高/原高)等比缩放，再计算截取坐标；焦点裁剪须传入自定义坐标并做越界检查，Imagick更优但需注意格式支持与资源限制。
GD 库 resize + crop 实现比例裁剪时，宽高比不对怎么办
PHP 自带 GD 库不直接提供“按焦点裁剪”功能，所谓“自动缩略图裁剪”，本质是先等比缩放至目标区域最小覆盖，再从中心（或指定坐标）截取固定尺寸。常见错误是直接 imagecopyresampled 到目标宽高，导致拉伸变形。
正确做法分两步：先算缩放后的真实尺寸，再算截取起点。比如原图 1200×800，要裁成 300×300 正方形：
- 计算等比缩放后的尺寸：
max(300 / 1200, 300 / 800) = 0.375→ 缩放后为 450×300 - 截取起点 x = (450 − 300) / 2 = 75，y = 0（因为高度已达标，只需水平居中切）
关键点：缩放比例必须基于 max($targetW / $srcW, $targetH / $srcH)，不是随便除一个。
用 imagecopyresampled 截取焦点区域前，必须手动算坐标
GD 没有类似 CSS object-fit: cover 的自动对齐逻辑，所有坐标都要自己算。如果想让人脸/主体不被切掉，就得传入自定义焦点坐标（比如 x=0.7, y=0.4 表示右上区域），而不是硬写死居中。
立即学习“PHP免费学习笔记（深入）”；
实操建议：
- 把焦点坐标转为像素值：
$focusX = (int)round($srcW * $focusRatioX) - 确保截取框不越界：x 要在
0 ~ $scaledW - $targetW范围内，用max(0, min($scaledW - $targetW, $x))限幅 - 缩放和截取必须用同一套缩放比例，否则会错位
漏掉边界检查，很容易出现 Warning: imagecopyresampled(): supplied argument is not a valid Image resource —— 实际是坐标超出了临时图像尺寸。
Imagick 比 GD 更适合焦点裁剪，但要注意内存和配置
Imagick 的 cropThumbnailImage 支持直接传入宽高并自动居中裁剪；resizeImage + cropImage 组合还能配合 setGravity 实现智能焦点（如 imagick::GRAVITY_SOUTHEAST）。
但要注意：
- 默认编译可能没开启
OpenMP，大图处理慢且吃单核 -
setResourceLimit必须提前调，否则 >10MB 图可能报MagickWandException: memory allocation failed - 某些共享主机禁用 Imagick，得 fallback 到 GD
示例关键行：$imagick->setGravity(\Imagick::GRAVITY_CENTER); $imagick->cropThumbnailImage(300, 300);
WebP / AVIF 等新格式缩略图生成失败的常见原因
GD 库默认不支持 WebP 写入（PHP 7.4+ 才内置，且需编译时加 --with-webp-dir），AVIF 完全不支持。Imagick 虽支持，但需要系统级 libavif 库，CentOS 7 默认没有。
排查步骤：
- 运行
gd_info()查webp support是否为 true - 用
Imagick::queryFormats('WEBP')看返回是否包含WEBP - 生成失败时，
error_get_last()常返回Cannot allocate memory或空错误 —— 其实是格式不支持，不是真内存不足
最稳妥的做法：统一用 JPEG/PNG 生成缩略图，再由 Nginx 或 CDN 动态转 WebP，别在 PHP 层硬扛。
焦点裁剪真正的复杂点不在算法，而在怎么拿到靠谱的焦点坐标——靠人工标定不现实，靠 CV 模型又太重。多数项目最后都退回到“居中裁剪 + 宽高比白名单”这种折中方案，反而更可控。
