thinkphp 8.1中图片水印需区分类型:water()仅支持png格式图片水印,位置与透明度可设但不校验尺寸;文字水印须用text()或gd函数实现,旋转时需计算包围盒并校准坐标以防裁切。

ThinkPHP 8.1 中实现图片水印需区分「图片水印」与「文字水印」两种路径,water() 方法仅支持图片贴图式水印,无法设置透明度、旋转、位置偏移等动态参数;若要添加带角度、半透明、居中或右下角浮动的文字水印,必须绕过 water(),直接调用底层 GD 函数或 Imagick 绘制。
用 water() 添加固定位置图片水印
第一步:确保水印图是 PNG 格式且含 Alpha 通道,否则叠加后会出现白底遮挡。
第二步:调用 $image->water('./water.png', \think\Image::WATER_NORTHWEST, 0.5) → 第二个参数决定位置(WATER_NORTHWEST 左上、WATER_CENTER 居中、WATER_SOUTHEAST 右下),第三个参数是透明度(0~1,0.5 表示半透明)。
第三步:执行 $image->save() 输出。注意:【water() 不校验水印图尺寸,若水印宽高超过原图,会静默截断,导致只显示左上角一小块】。
用 text() 实现基础文字水印(无旋转)
方法一:直接使用 think\Image 的 text() 方法
调用 $image->text('© 2024', './font/simhei.ttf', 24, '#ffffff', \think\Image::WATER_SOUTHEAST) → 字体路径必须为绝对路径,颜色值支持十六进制或 RGB 数组。
方法二:指定坐标绘制
$image->text('TOP SECRET', './font/msyh.ttf', 32, '#ff0000', 20, 50) → 最后两个数字是 x/y 坐标,单位为像素,从左上角起算;y 值太小会导致文字被裁掉顶部,建议至少设为字体大小的 1.2 倍。
实现动态旋转文字水印(关键步骤)
① 获取 GD 资源句柄:
$gd = $image->getImg();
② 分配颜色并加载字体:
$color = imagecolorallocate($gd, 255, 255, 255);
$font = __DIR__ . '/font/simhei.ttf';
③ 计算旋转后文字包围盒以避免裁切:
$bbox = imagettfbbox(24, 30, $font, '© 2024'); // 角度 30°,返回 8 个坐标点数组
④ 校准起始坐标(关键!):
$x = $image->width() - ($bbox[2] - $bbox[0]) / 2;
$y = $image->height() - ($bbox[7] - $bbox[1]) / 2 + 12; // +12 补基线偏移
⑤ 执行绘制:
imagettftext($gd, 24, 30, $x, $y, $color, $font, '© 2024');
【跳过第③④步会导致文字一半消失,尤其在大角度(>20°)时几乎必现】
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











