ThinkPHP如何实现图片动态添加文字水印【扩展】-ThinkPHP-PHP中文网

thinkphp 实现图片动态文字水印需借助 gd 库或 think-image 扩展，核心是控制字体、位置、透明度及适配尺寸；推荐使用 think-image（基于 intervention image），支持链式调用与中文 ttf 字体，配合动态坐标计算、缓存机制和异常处理确保稳定高效。

thinkphp如何实现图片动态添加文字水印【扩展】

ThinkPHP 实现图片动态添加文字水印，核心在于利用 PHP 的 GD 库或 Imagick 扩展对图像进行实时处理。官方未内置水印功能，但可通过 think-image 扩展（基于 Intervention Image）或原生 GD 快速实现，关键在于控制字体、位置、透明度、旋转和适配不同图片尺寸。

使用 think-image 扩展（推荐）

该扩展封装了 Intervention Image，支持链式调用，兼容 GD 和 Imagick，适合 ThinkPHP 6/7。

安装：composer require topthink/think-image
基础用法：读取原图 → 添加文字水印 → 保存或输出
示例代码（TP6 控制器中）：

$image = \think\Image::open('./uploads/photo.jpg');
$image->text('© MySite', './fonts/msyh.ttf', 24, '#ffffff', \think\Image::WATER_SOUTHEAST, 10)
     ->save('./uploads/photo_watermarked.jpg');

其中：WATER_SOUTHEAST 表示右下角；10 是透明度（0–100，数值越小越透明）；字体路径需为绝对路径且确保 Web 可读。

自定义位置与动态参数

避免固定写死坐标，可结合图片宽高动态计算水印位置，比如居中偏右下、留边 20px：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

先获取图片尺寸：$info = $image->info(); $width = $info['width']; $height = $info['height'];
用 text() 的第 5 个参数传入坐标数组：[ $width - 150, $height - 40 ]（假设文字宽约 150px、高约 40px）
支持 UTF-8 中文，但务必使用支持中文的 TTF 字体（如微软雅黑、思源黑体），否则显示方块

防批量覆盖与性能优化

频繁生成水印图会消耗资源，建议按需生成并缓存：

生成唯一水印文件名，如：md5($original . $text . $size . $position) . '.jpg'
检查缓存目录是否存在对应文件，存在则直接返回，否则生成并保存
对大图可先缩放再加水印，减少内存占用：$image->thumb(800, 600, \think\Image::THUMB_SCALE)->text(...)

异常处理与字体 fallback

线上环境常因字体缺失或权限问题导致水印失败：

加 try-catch 捕获 Intervention\Image\Exception\NotReadableException 等异常
设置默认字体 fallback：先尝试系统字体路径（/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf），再退回到内置字体
开发时开启 GD 支持检测：extension_loaded('gd')，并确认 imagettftext() 可用

不复杂但容易忽略细节，重点是字体路径、编码、坐标计算和缓存策略。只要配置得当，文字水印就能稳定嵌入各类上传图片中。