ThinkPHP 6 接口加水印需上传后重载图像路径创建 Image 实例再操作；文字水印须用原生 GD（含 GBK 编码、alpha 控制）；PNG 水印需启用 alpha 通道并用 imagecopyresampled 合成；WebP 格式需 GD 支持或预转换。
ThinkPHP 6 中接口添加水印，核心在于“上传后处理”而非“上传时处理”。不能直接对 UploadFile 对象调用 water() 方法，因为该对象只负责文件移动，不提供图像操作能力；必须用新生成的图片路径重新创建 \think\Image 实例，再执行水印逻辑。
正确调用链：上传 → 移动 → 重载图像 → 加水印 → 保存
常见错误是拿到 $file->move() 返回的 SplFileInfo 对象后，误用原 $file 调 water()，结果报错 Call to a member function water() on null 或静默失败。
- 移动成功后，使用
$result->getPathname()获取真实路径（$file->getRealPath()是临时路径，move 后已失效） - 用该路径 new 一个
\think\Image实例：$image = \think\Image::open($result->getPathname()); - 调用
$image->water(...)添加图片水印，或手动调 GD 函数加文字水印 -
save()时建议显式指定格式，如save($newPath, ['type' => 'png'])，避免 JPG 被强转 PNG 导致体积暴涨
文字水印需绕过 think\Image 封装
TP6 的 \think\Image 类已移除 text() 方法封装，直接调会报 Call to undefined method think\Image::text()。中文水印尤其容易乱码、位置偏移、字体不显示。
- 推荐方案：放弃
water()，改用原生 GD 流程 ——imagecreatefromxxx()→imagettftext()→imagepng()/imagejpeg() - 关键准备：确认 PHP 启用 GD 且
FreeType Support => enabled（查phpinfo()） - 中文支持：字体文件路径要真实存在；文字内容需转 GBK 编码（
iconv('UTF-8', 'GBK', $text)） - 透明度控制：用
imagecolorallocatealpha()分配颜色，alpha 值 0–127（0=不透明，127=全透明）
PNG 水印图透明通道保留要点
若水印是 PNG（如带透明背景的 Logo），默认合成后常出现黑边、白底或边缘生硬——这是 alpha 通道未启用导致的。
- 加载原图和水印图后，都必须执行：
imagealphablending($img, false)和imagesavealpha($img, true) - 合成时务必用
imagecopyresampled()替代imagecopy()，否则缩放失真、边缘锯齿 - 计算坐标时注意：右下角常用
$dst_x = $src_w - $logo_w - 10，$dst_y = $src_h - $logo_h - 10
WebP 等非常规格式兼容提醒
若用户上传 WebP 图片，\think\Image::open() 默认可能报错或读取失败。
- 需确认 GD 扩展已开启 WebP 支持（
phpinfo()查webp是否 listed） - 不支持时可先用
imagecreatefromwebp()+imagejpeg()转为 JPG 再处理，或统一前端限制上传格式 - 避免在 save 时不指定 type，让框架自动推断，易出错；明确传
['type' => 'webp']更稳妥
