GD库启用决定验证码生成成败；需检查phpinfo()或extension_loaded('gd')，未启用则取消php.ini中;extension=gd注释并重启服务。
GD库是否启用决定能否生成验证码
PHP默认不开启GD扩展，imagecreate()、imagestring()等函数会直接报错：Call to undefined function imagecreate()。检查方法是运行 phpinfo() 或执行 extension_loaded('gd')；未启用时需在 php.ini 中取消 ;extension=gd 的注释，并重启Web服务。
验证码文字扭曲要避开imageaffine()兼容性陷阱
PHP 7.4+ 才原生支持 imageaffine()，低版本用它会导致白屏或警告。更稳妥的做法是分步操作：先用 imagecreatetruecolor() 创建画布，再用 imagettftext() 写入单个字符，对每个字符单独调用 imagerotate()（注意旋转后需裁剪偏移），最后拼合。关键点：
-
imagerotate()默认填充背景色，设为0可透明（第5参数） - 旋转后的图像尺寸会变大，需用
imagesx()/imagesy()动态计算位置 - 避免使用中文路径字体，推荐绝对路径如
/var/www/font/arial.ttf
添加文字水印时imagettftext()的坐标容易算反
GD 的 Y 坐标是从图像顶部开始向下增长，但 imagettftext() 的第4个参数（Y）实际指“基线位置”，不是文字底部。若直接用 imagesy($img) - 10 会把文字切掉一半。正确做法是先调用 imagettfbbox() 获取文字包围盒，再推算基线：
$bbox = imagettfbbox(12, 0, '/font.ttf', '©2024'); $y = imagesy($img) - ($bbox[7] - $bbox[1]) / 2; // $bbox[1] 是顶点，$bbox[7] 是底点 imagettftext($img, 12, 0, 20, $y, $color, '/font.ttf', '©2024');
另外，如果水印要半透明，必须用 imagecolorallocatealpha() 创建带 alpha 的颜色，再调用 imagealphablending($img, true) 启用混合。
立即学习“PHP免费学习笔记（深入）”；
生成PNG水印图时imagepng()输出前必须关掉缓存
浏览器常因缓存显示旧水印图，尤其开发阶段反复修改后没变化。除了在 header() 中加 Cache-Control: no-store，更关键是调用 ob_end_clean() 清除可能存在的输出缓冲——GD 函数对已输出的内容极其敏感，哪怕多一个空格都会导致 Cannot modify header information 或 PNG 解析失败。
真正难处理的是多层水印叠加时的抗锯齿和透明通道叠加顺序：GD 不自动处理 alpha 混合，imagecopymerge() 对 PNG 透明区域效果差，此时应改用 imagecopy() + imagealphablending() 组合，并确保源图也调用过 imagealphablending($src, false) 关闭其混合模式。
