ThinkPHP 6 的 think\Image 类不支持自动水印，必须在文件移动成功后用新路径重新加载图像对象，再调用 water() 方法手动添加；water() 不接受文字水印，仅支持图片，且需注意路径、权限、坐标、透明度（0–100整数）及格式参数。
ThinkPHP 6 的 think\Image 类不支持自动水印，必须手动调用
ThinkPHP 6 官方的 think\Image 类本身没有「上传时自动加水印」的钩子或配置项。所谓“系统级水印”，其实是自己在上传逻辑里插入水印操作，不是靠配置开关就能开的。
常见错误是翻文档看到 water() 方法就以为能全局启用——它只是个图像处理方法，不绑定任何生命周期事件。
- 水印必须在图片保存到磁盘后、返回给前端前执行
- 不能对临时文件流直接加水印（
$_FILES中的tmp_name不可被think\Image正确加载） - 如果用了
UploadFile::move()，得先 move 成功，再用新路径去 load 图像
水印位置和透明度要靠 water() 的参数精确控制
water() 方法默认行为容易误导：不传坐标时按右下角 + 自动缩放水印图，但缩放逻辑会破坏文字水印清晰度，且透明度固定为 80（0–100），不是 0–1 范围。
典型误用：$image->water('water.png') —— 这会把水印图等比缩放到目标图宽高的 10%，位置在右下，但如果你的水印是小 logo，可能糊成一团；如果是文字水印，根本不会生效（water() 不接受字符串文字）。
立即学习“PHP免费学习笔记（深入）”；
- 加图片水印：用
$image->water('path/to/water.png', \think\Image::WATER_SOUTHEAST, 80) - 左上角加水印：改用
\think\Image::WATER_NORTHWEST - 自定义坐标：第三个参数换成数组，如
[50, 50]表示距左、上各 50px - 透明度别写错：值是整数 0–100，写
0.8会当成 0，水印完全不显示
TP6 使用 UploadFile 后必须显式 reload 图像对象
很多人在 $file->move() 后直接拿原 $file 对象调 water()，结果报错 Call to a member function water() on null 或静默失败。因为 UploadFile 实例不提供图像操作能力，它只管移动文件。
正确链路是：移动 → 用新路径 new 一个 \think\Image 实例 → 加水印 → save 覆盖或另存。
- 别用
$file->getRealPath()，它返回的是临时路径，move 后已失效 - 要用
$result->getPathname()（move()返回的SplFileInfo对象） - save 时建议加
['type' => 'png']显式指定格式，避免 JPG 图片被强制转成无损 PNG 导致体积暴增 - 如果原图是 WebP，
think\Image默认不支持，需确认 GD 扩展已开启 WebP 支持
生产环境要注意水印图路径和权限，别让 water.png 404
本地开发时把水印图放在 public/static/ 下，用相对路径 water.png 可能跑通；但部署到 Nginx 或 Docker 后，think\Image 是以 CLI 或 PHP-FPM 工作进程身份读文件，当前工作目录通常是入口脚本所在目录（public/index.php），所以相对路径极易解析失败。
- 务必用绝对路径：
__DIR__ . '/../public/static/water.png'或app()->getRootPath() . 'public/static/water.png' - 检查水印图文件权限，PHP 进程得有读权限，Docker 容器里尤其容易漏掉
chown -R www-data:www-data - 加水印前先
is_file()判断，否则water()静默失败，连 warning 都不抛 - GD 库缺失时
think\Image会 fallback 到 imagick，但 imagick 默认不带水印功能，得额外装扩展并配置驱动
水印不是配置开关，是每个上传路径上你亲手补的一行 water() 调用；漏掉判断、路径写错、没 reload 图像对象，三者任一都会让水印彻底消失，而且没有任何提示。
