PHP 8.1 中 GD 图像缩放裁剪需确保扩展启用、函数参数顺序正确及资源及时释放，否则易出现无效资源或白图；必须用 imagecopyresampled 实现高质量缩放，PNG 需启用 alpha 通道，裁剪须校验坐标范围并配对 imagedestroy() 防内存溢出。
PHP 8.1 中 GD 库缩放裁剪完全可用，但必须确认扩展已启用、函数调用参数顺序和资源释放逻辑正确——否则常见 imagecopyresampled(): supplied resource is not a valid Image resource 或白图问题。
确认 GD 扩展已启用且支持所需格式
PHP 8.1 默认不强制启用 GD，尤其 Alpine 容器或自编译环境常缺失。不能只看 phpinfo() 有 gd 条目，还要检查是否支持 JPEG/PNG：
- 运行
php -m | grep gd，有输出才表示扩展加载成功 - 执行
php -r "var_dump(gd_info());"，重点确认jpeg和png对应值为true - 若为 false，需重装 GD（如 Ubuntu：安装
libjpeg-dev libpng-dev后重新编译 PHP，或 Docker 中加docker-php-ext-install gd） - 注意：PHP 8.1+ 已移除
imagecreatefromwbmp等废弃函数，但imagecreatefromjpeg、imagecreatefrompng、imagecreatefromgif全部保留
缩放必须用 imagecopyresampled，别用 imagecopyresized
imagecopyresized 在 PHP 8.1 中仍存在，但会严重模糊图片，尤其文字或线条图；imagecopyresampled 是唯一推荐的高质量缩放方式，参数易错：
- 目标图像宽高是画布尺寸，不是“想缩成多大”——先用
imagecreatetruecolor($target_w, $target_h)创建目标资源 - 源图坐标（第 6–7 参数）通常为
0, 0；目标图坐标（第 4–5 参数）也常为0, 0，除非你要做偏移缩放 - 关键陷阱：第 8–9 参数是「源图实际要复制的宽高」，不是原图总宽高——等比缩放时需按比例计算，例如：
imagecopyresampled($dst, $src, 0, 0, 0, 0, $target_w, $target_h, $src_w, $src_h); - PNG 透明背景必须加两行：
imagealphablending($dst, false); imagesavealpha($dst, true);，否则透明变黑
裁剪起始坐标计算错误会导致黑边或越界
GD 没有“直接裁剪”函数，本质是把源图某块区域复制到新画布上，imagecopy 或 imagecopyresampled 都可，但行为不同：
立即学习“PHP免费学习笔记（深入）”；
- 用
imagecopy：纯像素搬运，不缩放，要求源区域尺寸 = 目标画布尺寸，否则留黑边或截断
示例：从原图 (1000×800) 居中裁 400×300 →$src_x = (1000 - 400) / 2; $src_y = (800 - 300) / 2; - 用
imagecopyresampled：可同时裁 + 缩，适合“先放大再居中取固定尺寸”，例如生成头像缩略图
此时源宽高传的是要裁的区域大小（如 400×300），目标宽高是输出尺寸（如 200×150），实现等比压缩 - 务必校验
$src_x、$src_y≥ 0 且$src_x + $src_w ≤ $src_w_total，否则返回空资源或警告 - 裁剪前建议用
getimagesize($path)获取真实宽高，别信文件名或用户传参
资源不销毁会内存溢出，PHP 8.1 更敏感
GD 图像资源不会自动回收，尤其在循环处理多张图或 CLI 脚本中，PHP 8.1 的内存管理更严格，未 imagedestroy() 极易触发 Allowed memory size exhausted：
- 每张打开的图（
imagecreatefromjpeg）、每张新建的图（imagecreatetruecolor）都必须配对imagedestroy() - 顺序很重要：先销毁源图，再销毁目标图；若目标图要保存后继续用（比如加水印），则延后销毁
- 异常路径容易遗漏——用
try/finally包裹，确保无论成功失败都释放：try { /* 处理逻辑 */ } finally { imagedestroy($src); imagedestroy($dst); } - CLI 下单次处理超 10 张 2MB 以上图，不销毁基本必崩
最易被忽略的是 PNG 透明通道处理和裁剪坐标的整数截断——(int) $x 比 round($x) 更安全，浮点坐标传给 imagecopy 会静默失败。
