imagecrop 返回 null 的根本原因是输入图像非真彩色模式，需用 imageistruecolor 检查并转为 truecolor；且裁剪区域必须完全在原图内，否则静默失败。
imagecrop 能精准裁剪图片，但前提是图像资源必须是真彩色（truecolor），否则会返回 null 且不报错——这是最常踩的坑。
为什么 imagecrop 总是返回 null
根本原因不是坐标写错了，而是输入图像资源没开启 truecolor 模式。GD 默认创建的图像（比如 imagecreate）是调色板模式（palette），而 imagecrop 只接受 imagecreatetruecolor 创建的资源。
常见错误现象：var_dump(imagecrop($im, ['x'=>0,'y'=>0,'width'=>100,'height'=>100'])); 输出 null，没警告、没错误、也没提示。
- 检查图像来源：如果是
imagecreatefromjpeg等加载的，它通常自带 truecolor，但某些老旧 PNG 或 GIF 可能不是 - 保险做法：用
imageistruecolor($im)先判断，返回false就立刻转成 truecolor：$im = imagecreatetruecolor(imagesx($im), imagesy($im)); imagecopy($im, $src, 0, 0, 0, 0, imagesx($src), imagesy($src)); - 别依赖
imagecolortransparent后直接裁剪——透明处理和色彩模式无关，该挂还是挂
imagecrop 的矩形参数必须完全落在原图内
不像 CSS 的 object-fit，imagecrop 不做任何边界修正。哪怕 x 是 -1，或 width 超出右边界，函数就静默失败，返回 null。
- 务必手动校验：用
imagesx($im)和imagesy($im)获取宽高，再确认x >= 0、y >= 0、x + width 、y + height - 如果需要“安全裁剪”，得自己封装逻辑，比如把超出部分截断，或居中 fallback
- 注意浮点数：传入
int，别传float，GD 内部不自动(int)转换，小数会导致行为不可预测
裁剪后保存时要注意输出格式与质量控制
裁剪只是生成新资源，保存环节仍要单独处理。尤其 JPEG 的质量参数、PNG 的压缩级别，不显式设置就用 GD 默认值（JPEG 是 75，PNG 是 -1 即默认压缩），容易导致画质骤降或体积失控。
- 保存 JPEG：
imagejpeg($cropped, $path, 95)—— 第三个参数别漏，否则按默认 75 压缩 - 保存 PNG：
imagepng($cropped, $path, 9)—— 第二个参数为null表示输出到浏览器，此时必须先header('Content-Type: image/png') - 别用
imagegif直接存裁剪结果：GIF 不支持 truecolor，必须先imagetruecolortopalette($im, true)，否则颜色严重失真
真正麻烦的从来不是怎么调 imagecrop，而是它不告诉你哪里错了。只要记住两点：资源必须是 truecolor，坐标必须严丝合缝在图内——其余都是周边问题。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
