ThinkPHP 6 的 think\Image 类不支持直接添加文字水印，因官方移除了封装，需手动调用 GD 函数（如 imagettftext）或预生成文字 PNG；添加 PNG 水印时须启用 alpha 通道并使用 imagecopyresampled；中文水印需转 GBK 编码且指定中文字体；大图处理需缩放、及时释放资源。
ThinkPHP 6 的 think\Image 类不支持直接添加文字水印
很多人在 TP6 中调用 water() 方法失败，是因为默认的 think\Image（基于 GD）只支持图片水印，不处理文字水印。错误现象通常是：Call to undefined method think\Image::text() 或水印位置错乱、字体不显示、中文乱码。
原因在于 TP6 官方移除了对文字水印的封装，但底层 GD 扩展本身是支持的。你需要手动调用 GD 函数或换用更可控的方式。
- 若坚持用
think\Image，只能传入一张已生成好的文字 PNG 图片作为水印源（需提前用imagefttext()绘制好） - 更推荐直接使用原生 GD：加载图片 → 分配颜色 → 设置字体路径 → 调用
imagettftext() - 务必确认 PHP 已启用
gd扩展且支持 FreeType（phpinfo()查看FreeType Support => enabled）
TP6 中添加 PNG 水印图时透明通道丢失
常见表现是 PNG 水印的背景变成黑色或白色，边缘生硬。这是因为 GD 默认不保留 alpha 通道，也未设置混合模式。
解决的关键不是改 water() 参数，而是手动控制图像资源：
立即学习“PHP免费学习笔记（深入）”；
- 加载原图和水印图后，都必须调用
imagealphablending($img, false)和imagesavealpha($img, true) - 合成前用
imagecopyresampled()替代imagecopy()，避免缩放失真 - 水印坐标建议用相对计算，例如：
$x = $w - $logo_w - 10（右下角留 10px 边距） - 字体路径不能用相对 URL，要写绝对路径，如：
__DIR__ . '/font/simhei.ttf'
文字水印中文不显示或方块乱码
根本原因是 GD 的 imagettftext() 不识别 UTF-8 字符串，且默认字体不包含中文字符集。
这不是 ThinkPHP 的问题，是 GD 层级限制，必须从输入和字体两方面处理：
- 文字内容需转为 GB2312 或 GBK 编码，例如：
iconv('UTF-8', 'GB2312//IGNORE', $text) - 字体文件必须是支持中文的 TrueType 字体（如
simhei.ttf、msyh.ttc），不能用系统自带的 Arial 或 Helvetica - 字号不宜过小（
12是底线），否则中文笔画粘连；角度建议设为0，避免旋转后偏移不可控 - 颜色要用
imagecolorallocate()显式分配，别用十六进制字符串
在控制器中安全调用并避免内存溢出
TP6 的 think\Image 是惰性加载，但大图 + 水印容易触发 Allowed memory size exhausted。不要在循环里反复 new Image。
实操要点：
- 先用
getimagesize()判断原始尺寸，超 3000px 宽高的图建议先缩放再加水印 - 操作完立即
imagedestroy($img)释放资源，尤其在批量处理时 - 水印逻辑建议封装成独立方法，接收
$path（原图路径）、$output（输出路径）、$type（'text' / 'image'）三个参数 - 生产环境禁用
error_reporting(E_ALL)，GD 报错会中断输出，导致返回空白图片
复杂点在于水印的坐标适配、字体大小随图宽动态调整、以及多语言环境下的编码切换——这些没法靠一个配置项解决，得在业务层判断。
