thinkphp5 thumb() 默认等比缩放不裁剪，输出尺寸非指定值；需显式传第三参数选择模式，如thumb_center实现居中裁剪。
thumb() 默认不生成固定尺寸，而是等比缩放 —— 这是绝大多数人踩坑的起点。
ThinkPHP5 thumb() 为什么输出不是你指定的宽高？
调用 $image->thumb(150, 150)->save() 后，结果图宽高往往不是 150×150，而是比如 150×84 或 102×150。这是因为默认模式是 \think\Image::THUMB_SCALING（等比例缩放），只保证「长边 ≤ 150」，不裁剪、不拉伸。
常见误解：
- 以为参数就是目标宽高 → 实际只是“上限”
- 没传第三个参数，就默认走缩放，不是居中裁剪
- 在头像/卡片等强尺寸约束场景下，直接用默认模式会导致前端布局错乱
thumb() 的五种常用模式怎么选？
必须显式传入第三个参数才能切换行为。关键常量和效果如下：
-
\think\Image::THUMB_SCALING（值为 1）：等比缩放，最大边 ≤ 指定值 → 适合列表页小图预览 -
\think\Image::THUMB_CENTER（值为 3）：先等比缩放，再居中裁剪到目标尺寸 → 头像、商品主图最常用 -
\think\Image::THUMB_FIXED（值为 6）：强制拉伸到指定宽高 → 会变形，慎用 -
\think\Image::THUMB_NORTHWEST（值为 4）：不缩放，直接从左上角切固定区域 → 要求原图 ≥ 目标尺寸 -
\think\Image::THUMB_FILLED（值为 2）：等比缩放后，用背景色（默认黑）填充至目标尺寸 → 适合 banner 占位
示例：生成严格 150×150 的头像缩略图：
$image = \think\Image::open('./avatar.jpg');
$image->thumb(150, 150, \think\Image::THUMB_CENTER)->save('./avatar_150.jpg');
裁剪前必须校验坐标和尺寸边界
crop() 方法签名是 crop($width, $height, $x, $y)，不是 crop($x, $y, $width, $height)。传反会导致空白图或 Invalid dimensions 错误。
务必在裁剪前做两件事：
- 用
$image->width()和$image->height()获取原始图尺寸 - 确认
$x + $width width()且$y + $height height()
错误写法：$image->crop(80, 60, 200, 150) → 实际裁的是宽 80、高 60、起点 (200, 150)，极大概率越界
正确写法：$image->crop(200, 150, 80, 60) → 从 (80, 60) 开始裁 200×150 区域
前端传 base64 图片时别用 $request->file()
如果前端用 cropper.js 调 getCroppedCanvas().toDataURL() 发送图片，字段名通常是 image_data，不是文件上传字段。此时 $request->file('image_data') 一定为 null。
正确路径是：
- 用
$request->param('image_data')拿到 base64 字符串 - 去掉前缀：
str_replace('data:image/', '', $base64)，再按分号拆出 MIME 类型和数据体 - 用
base64_decode()解码，再喂给 GD：imagecreatefromstring($binary) - 若前端未合并旋转（即 canvas 仍是原始方向），需手动调
imagerotate()校正，否则裁出来是歪的
绕过 \think\Image 直接用 GD 处理 base64 图片，在旋转+裁剪组合操作中更可控，尤其在 Linux 环境下兼容性更稳。
THUMB_CENTER 看似多一步，但省去了前端二次计算裁剪框的麻烦；而 crop() 的参数顺序错误，往往只在上线后某个特定尺寸的图上才暴露 —— 因为小图刚好没越界，大图一裁就空。php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
