ThinkPHP 中推荐使用 topthink/think-image 扩展实现图片水印和缩略图：文字/图片水印可自定义位置、透明度；缩略图应采用等比缩放+居中裁剪（thumb 方法），上传后需显式处理原图，路径须为本地绝对路径，建议先加水印再缩略。
ThinkPHP 中实现图片水印和缩略图生成，核心在于选对工具、分清步骤、避开常见坑。官方推荐且稳定的方式是使用 topthink/think-image 扩展库，它封装了 GD 或 Imagick 底层能力，让开发更聚焦逻辑而非图像细节。
用 think-image 快速加水印
支持文字水印和图片水印两种方式，位置、大小、透明度均可控制。
- 文字水印：指定字体文件（.ttf）、字号、颜色、位置（如左下角
IMAGE_WATER_SOUTHWEST） - 图片水印：传入水印图路径，支持居中、右下角等 9 种预设位置，还能自定义偏移量
- 注意水印图尺寸不宜过大，建议不超过原图宽高的 15%，否则影响主图观感
- 若用 GD，确保 PHP 已启用
gd扩展（运行php -m | grep gd验证）
缩略图生成的关键逻辑
不是简单拉伸，而是“等比缩放 + 居中裁剪”才保真。直接设宽高易导致变形或留白。
- 推荐调用
$image->thumb($width, $height, 'center')，第三个参数决定裁剪模式 - 若需保留比例不裁剪，可用
$image->thumb($width, $height, \Think\Image::THUMB_SCALING) - 务必用服务器本地绝对路径操作图片（如
/var/www/runtime/upload/xxx.jpg），不能传 URL - 生成后建议检查返回值，避免静默失败（例如磁盘满、权限不足）
上传后自动处理的典型流程
ThinkPHP 6 不会在上传时自动缩略或加水印，必须显式调用图像类处理已保存的原图。
立即学习“PHP免费学习笔记（深入）”；
- 先用
request()->file()接收并moveTo()保存原图 - 再用
Image::open(原图绝对路径)加载，执行thumb()或water() - 最后调用
save()写入新文件，路径需可写，扩展名要匹配原图类型（jpg/png/gif） - 若同时做缩略图+水印，建议先加水印再缩略，避免水印被压缩失真
GD 手动处理的注意事项（备用方案）
当扩展库不可用或需精细控制时，可回退到原生 GD 函数，但门槛更高。
-
imagecopyresampled()参数顺序极易出错：第 7–8 位是目标图宽高，第 9–10 位才是原图宽高 - 务必先用
getimagesize()获取原图信息，再算缩放比例，避免黑图或空白图 - 保存 JPEG 时第三参数为质量（建议 85），过低模糊，过高体积陡增
- 每步操作后检查资源是否创建成功，及时
imagedestroy()释放内存
