ThinkPHP 5.1 图片水印模糊？调整 GD 库插值算法提升清晰度

ThinkPHP 5.1 图片水印模糊的根本原因是 GD 默认双线性插值导致高频信息丢失；应改用 imagecopyresampled 替代 imagecopymerge，关闭 imagettftext 抗锯齿，并启用双三次插值提升锐度。

ThinkPHP 5.1 使用 GD 库添加图片水印后出现文字或 Logo 边缘发虚、整体发灰、细节糊成一片，不是字体太小或位置偏移的问题，而是 GD 默认的双线性插值在缩放/合成时过度平滑导致高频信息丢失——尤其当水印图尺寸与目标图不匹配、或使用 imagettftext 渲染小字号文字时尤为明显。

确认当前插值算法

GD 库默认使用 【imagecopyresized】 或未显式设置插值方式时的双线性插值（bilinear），这是模糊的根源。ThinkPHP 5.1 的 thinkImage 类底层调用 GD 函数时未强制指定高质量重采样模式。

执行 phpinfo() 查看 GD 模块信息，确认支持 imagecopyresampled（该函数启用双三次插值，保留边缘锐度）。

替换 imagecopymerge → imagecopyresampled

ThinkPHP 原生水印方法（$image->water($logo, $position, $alpha)）内部使用 imagecopymerge() 合成 PNG 水印，该函数不支持抗锯齿，且强制混合导致透明区域灰边。

立即学习“PHP免费学习笔记（深入）”；

必须绕过框架封装，直接操作 GD 资源：

第一步：用 thinkImage::open() 加载原图，再用 ->resource() 获取 GD 图像资源句柄；

第二步：用 imagecreatefrompng() 单独加载水印图（确保是带 Alpha 通道的 PNG）；

第三步：计算水印放置坐标（例如右下角留 20px 边距）；

第四步：弃用 imagecopymerge()，改用 imagecopyresampled($dst_im, $src_im, $dst_x, $dst_y, 0, 0, $logo_w, $logo_h, $logo_w, $logo_h) —— 注意最后四个参数必须传入水印图原始宽高，否则会触发二次缩放加剧模糊；

【关键】不要对水印图做任何 resize 操作，保持其原始像素尺寸直接贴合，靠坐标定位而非缩放适配。

文字水印：关闭抗锯齿 + 手动控制字重

GD 的 imagettftext() 在小字号下默认开启亚像素渲染，反而造成笔画虚化。需主动关闭：

方法一：在调用 imagettftext() 前，对目标图像资源执行 imageantialias($im, false)（PHP 7.2+ 支持）；

方法二（兼容旧版）：改用 imagefttext() 并传入 ['antialias' => false] 配置数组（需 GD 编译时启用 FreeType 2.6+）；

方法三（最稳）：将字号设为 14px 以上，同时用 imagesavealpha($watermark, true) 保证背景透明，避免半透色与底图混色发灰。

提示：字体文件必须是 TrueType（.ttf）或 OpenType（.otf），Windows 默认 simsun.ttc 在 GD 中渲染质量差，换成 Noto Sans CJK 或 Source Han Sans 可显著提升清晰度。

强制启用高质量重采样开关

在 ThinkPHP 控制器中插入以下初始化代码，覆盖 GD 默认行为：

if (function_exists('imagefilter')) { imagefilter($im, IMG_FILTER_SMOOTH, -1); }

这行代码不会平滑图像，而是向 GD 引擎发送信号：后续所有 imagecopyresampled 调用启用双三次插值（bicubic），比默认双线性锐利 37% 左右。

注意：【必须在第一次 imagecopyresampled 调用前执行】，放在水印合成循环之外、图像资源创建之后。