imagecrop是PHP 8.0+中专用于矩形截取的裁剪函数，仅提取原图指定区域且不缩放，使用前须确保图像资源加载成功、版本≥8.0、裁剪坐标不越界；失败时静默返回false，需显式校验。
imagecrop 是 PHP 8.0+ 中最直接、最安全的裁剪函数，但它不是“文生图”工具，也不生成图片——它只对已加载的图像资源做矩形区域截取。如果你看到“PHP文生图”这种说法，大概率是混淆了概念：PHP 本身不支持从文本生成图像（那是 Stable Diffusion、DALL·E 或 imagick + 文本渲染等组合的事），裁剪只是后期处理环节。
下面直奔实操重点：
用 imagecrop 裁剪前必须确认三件事
这个函数看着简单，但失败常发生在加载阶段或参数越界，而不是裁剪逻辑本身：
-
imagecreatefromjpeg/imagecreatefrompng等函数必须成功返回GdImage对象；若原图路径错、权限不足、格式损坏，会返回false，后续调用imagecrop就直接报“Parameter #1 $image is not a GdImage” - PHP 版本必须 ≥ 8.0 —— 7.x 系统里没有
imagecrop，强行调用会报Call to undefined function imagecrop() -
rectangle数组中的x、y、width、height必须全部为非负整数，且x + width ≤ imagesx($image)，y + height ≤ imagesy($image)；超限时函数返回false，不报错也不警告
imagecrop 和 imagecopyresampled 的本质区别
很多人用 imagecopyresampled 实现“裁剪+缩放”，但这是两个不同动作：imagecrop 只截取，不缩放；imagecopyresampled 是复制+重采样（即缩放），常被误当作裁剪用。
立即学习“PHP免费学习笔记（深入）”；
-
imagecrop($im, ['x'=>100,'y'=>50,'width'=>300,'height'=>200])→ 输出就是原图上那个 300×200 的像素块，分辨率完全不变 -
imagecopyresampled($dst, $src, 0,0, 100,50, 300,200, 300,200)→ 把源图 (100,50) 开始的 300×200 区域，拉伸/压缩到目标画布的 0,0→300×200 位置；如果目标画布尺寸不同，就会发生缩放失真 - 真正需要“居中裁剪成固定尺寸”（比如统一输出 300×300 正方形），得先算坐标：
$x = ($srcW - $dstW) / 2，再传给imagecrop；不能靠imagecopyresampled“蒙混过关”
GD 裁剪后透明通道和颜色丢失怎么办
裁剪 PNG 时常见背景变黑、Alpha 通道消失，这不是 imagecrop 的锅，而是后续保存没配对处理：
- 加载 PNG 必须用
imagecreatefrompng，不能用imagecreatefromjpeg（即使文件名是 .jpg） - 裁剪后保存 PNG 前，要补两行：
imagealphablending($im2, false)+imagesavealpha($im2, true)，否则透明区域会被强制填充为黑色 - JPEG 不支持透明，所以裁剪带 Alpha 的 PNG 后硬存为 JPEG，必然丢透明信息——这不是 bug，是格式限制
为什么 imagecrop 返回 false 却没报错
这是最容易卡住的地方：函数失败静默返回 false，不像 imagecreatefromxxx 那样抛 Warning。调试时务必显式判断：
if ($cropped === false) {
error_log('imagecrop failed: x=' . $rect['x'] . ', y=' . $rect['y'] . ', w=' . $rect['width'] . ', h=' . $rect['height']);
exit('Invalid crop rectangle');
}尤其注意：当原图宽高是 0（比如 getimagesize 失败后未校验就直接用），imagesx($im) 返回 0，任何正数 width 都会导致越界失败。
真正的难点不在函数怎么写，而在于每一步的输入是否可信——图像资源是否加载成功、尺寸是否读准、坐标是否在合法范围内。这些检查漏掉一个，imagecrop 就只会默默返回 false，然后你花半小时找不出哪错了。
