ThinkPHP6.x中需安装think-image扩展并使用\think\image\Image命名空间，通过open()校验原图尺寸，再用thumb()三种模式生成缩略图，叠加PNG水印并裁剪保存。
在ThinkPHP6.x项目中为上传图片自动生成指定尺寸缩略图并叠加透明水印，必须先解决扩展缺失和类路径错误问题，否则调用\Think\Image会直接报Class not found。
安装think-image扩展并确认类路径
执行命令安装扩展：composer require topthink/think-image
安装后类的完整命名空间是\think\image\Image，不是旧版的\Think\Image；若代码里还写new \Think\Image()，运行时必然抛出Class "Think\Image" not found错误。
装完建议立即执行composer dump-autoload刷新自动加载缓存，避免因缓存未更新导致类找不到。
立即学习“PHP免费学习笔记（深入）”；
创建图片对象并校验原始尺寸
使用\think\image\Image::open($path)打开本地图片文件，路径必须真实存在且可读。
调用$image->width()和$image->height()获取原始宽高——这步不能跳过，后续裁剪、缩放都依赖它。例如原图只有300×200，却传入thumb(800, 600)，结果会严重失真但不报错。
若处理的是前端cropper.js传来的base64图片，【绝不能用$request->file()】，必须用$request->param('image_data')取值，再手动剥离data:前缀、解码、喂给imagecreatefromstring()。
生成固定尺寸缩略图（三种模式详解）
方法一：强制拉伸填满（变形）
调用$image->thumb(200, 150, \think\image\Image::THUMB_FIXED)→直接拉伸到目标宽高，不管原图比例。
方法二：等比缩放+居中裁剪（推荐用于头像/列表图）$image->thumb(200, 150, \think\image\Image::THUMB_CENTER)→先等比缩放到最小边≥目标边，再从中心切出200×150区域。
方法三：等比缩放+背景填充（防白边/黑边）$image->thumb(200, 150, \think\image\Image::THUMB_FILLED)->background([255, 255, 255])→等比缩放后，用纯白填充剩余区域，避免默认黑底。
添加PNG水印并控制位置与透明度
第一步：确保水印图是32位PNG，带完整Alpha通道；用Photoshop导出时务必勾选“透明度”，否则GD会渲染出黑底或白边。
第二步：调用$image->water($waterPath, \think\image\Image::WATER_SOUTHEAST)->alpha(80)，其中WATER_SOUTHEAST对应右下角，alpha(80)设为80%不透明度（值越小越透明）。
水印图尺寸不宜超过原图的1/4，否则imagecopymerge()可能因内存不足失败，尤其在共享主机上容易卡死。
裁剪指定区域图像
第一步：确认裁剪参数顺序——crop($width, $height, $x, $y)，不是crop($x, $y, $width, $height)。
第二步：校验边界，确保$x + $width width()且$y + $height height()，否则返回空白图或报Invalid dimensions。
第三步：例如从左上角裁200×150，写$image->crop(200, 150, 0, 0)；想从(80, 60)开始裁，就写$image->crop(200, 150, 80, 60)，千万别把宽高和坐标传反。
第四步：裁剪后必须显式调用->save('./output.jpg')才真正写入磁盘，不调用就不会生成文件。
