为何PHP 8.5.5的图像水印不显示【GD】-php教程-PHP中文网

php 8.5.5图像水印不显示的根本原因不是版本问题，而是gd未真正启用、字体路径/编码/坐标错误、png透明处理缺失或输出前存在bom/空格等污染。

为何php 8.5.5的图像水印不显示【gd】

PHP 8.5.5 的图像水印不显示，根本原因几乎从来不是 PHP 版本本身的问题——因为 GD 扩展在 8.5.5 中完全兼容，且该版本未引入任何 GD 相关的破坏性变更。真正卡住你的，是环境、路径或输出链路上某个看似微小却致命的断点。

imagecreatefromjpeg() 或 imagettftext() 返回 false、脚本静默中断、浏览器显示“损坏的图像”，大概率是 GD 没真正干活。

php -r "var_dump(extension_loaded('gd'));" 必须输出 bool(true)，仅靠 phpinfo() 页面里扫一眼“GD Support: enabled”不可靠（可能只是编译时支持，运行时未加载）
Linux 下检查 extension=gd.so 是否在生效的 php.ini 中（用 php --ini 确认路径），且文件真实存在
Windows 下确认 extension=php_gd2.dll 未被注释，且 DLL 文件在 ext/ 目录下
重启 Web 服务（Apache/Nginx + PHP-FPM）或 CLI 环境后才生效，改完 ini 不重启等于白改

中文水印空白、方块、偏移、报错 Could not find/open font，全是这三类问题叠加。

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

下载

字体路径必须是服务器可读的绝对路径，不要用相对路径：<strong>DIR</strong> . '/fonts/simhei.ttf'，而不是 'fonts/simhei.ttf'
字符串必须是 UTF-8 编码字节流——PHP 不做自动转码，若源文件是 GBK 保存，imagettftext() 就会传入乱码字节
Y 坐标不是“文字顶部”，而是左下角基准点：$y = imagesy($im) - 20 是常见安全值，但更准的做法是先调 imagettfbbox() 算出实际高度再减

PNG 水印贴上去变成黑底、边缘锯齿、整张图变灰，说明 alpha 通道被暴力丢弃。

加载水印图前必须加：imagealphablending($watermark, false); imagesavealpha($watermark, true);
imagecopymerge() 最后一个参数是透明度（0–100），但它不自动处理 alpha 混合；若水印本身含透明，仍需上述两行配合
坐标和尺寸顺序极易写反：imagecopymerge($dst, $src, $dst_x, $dst_y, $src_x, $src_y, $width, $height, $pct)，其中 $width 和 $height 是源图（水印）的宽高，不是目标图的

水印逻辑全对，imagejpeg($img) 也执行了，但浏览器只显示叉或空白——八成是输出污染。

用十六进制编辑器或命令行检查文件开头：head -c 10 your_script.php | xxd，若有 ef bb bf 就是 UTF-8 BOM
所有 PHP 文件必须存为 UTF-8 without BOM
在 header() 前加一句：if (headers_sent($f, $l)) { die("Headers sent at $f:$l"); }，立刻暴露哪行偷偷输出了
ob_clean() 是临时止血，不是根治方案；源头清理（删空格、删 BOM、删调试语句）才能稳定输出

最常被忽略的，是以为“代码跑通了=功能就对了”。GD 图像流程是一条脆弱的流水线：资源加载→内存绘图→头信息→二进制输出，任一环节混入非图像字节，整条链就报废。