gd库加水印前须验证图像资源有效性，检查is_resource()返回值；png需设置alpha混合，jpeg需处理exif方向；文字水印用imagettftext（坐标为左下角），图片水印用imagecopyresampled；水印操作应在move_uploaded_file前完成，并注意中文编码转换与字体路径。
GD 库加水印前必须确认图像资源是否有效
PHP 用 imagecreatefromjpeg、imagecreatefrompng 等函数加载原图时，如果文件损坏、路径错误或 MIME 类型不匹配，会返回 false，但后续调用 imagecopy 会直接报错“supplied argument is not a valid Image resource”。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 每次加载后立刻用
is_resource()检查返回值，不要只靠file_exists() - 对 PNG 图像，记得调用
imagealphablending($dst, false)和imagesavealpha($dst, true)，否则透明背景会被替换成黑色 - JPEG 要注意 EXIF 方向——用
exif_read_data()判断是否需要旋转，否则水印位置错乱
水印文字 vs 水印图片：选错方式会导致模糊或偏移
文字水印用 imagettftext，图片水印用 imagecopy 或 imagecopyresampled。两者底层处理逻辑完全不同，混用参数极易出问题。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 文字水印优先用绝对路径的 TTF 文件，相对路径在 CLI 和 Web 环境下行为不一致；传给
imagettftext的坐标是文字左下角，不是左上角 - 图片水印若要缩放适配（比如固定右下角 10% 大小），必须用
imagecopyresampled，不能用imagecopy，否则拉伸失真 - 叠加前务必用
imagesx()/imagesy()获取目标图尺寸，别硬写像素值——不同上传图宽高差异大
上传流程中插入水印的正确时机：别在 move_uploaded_file 后再处理原文件
用户上传后，PHP 临时文件（$_FILES['xxx']['tmp_name']）只存在当前请求生命周期。如果先 move_uploaded_file 再读取新路径加水印，等于多一次 I/O，且并发时可能被其他进程覆盖。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 水印操作必须在
move_uploaded_file之前完成：加载$_FILES['xxx']['tmp_name']→ 加水印 → 保存到最终路径 - 保存时用
imagejpeg($img, $final_path, 90)显式指定质量，避免默认压缩过度导致文字锯齿 - 处理完记得
imagedestroy($img)和imagedestroy($watermark)，不然大图上传频繁时内存溢出
中文水印乱码？字体和编码必须同时对得上
imagettftext 不接受 UTF-8 字符串直传。即使 TTF 支持中文，PHP 传进去的仍是字节流，GD 库按单字节解析就会崩。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 用
mb_convert_encoding($text, 'UTF-8', 'auto')统一源文本编码，再转 GBK（常见中文字体如 simsun.ttc 实际按 GBK 编码索引） - 测试时先用
imagettfbbox拿尺寸，如果返回false或全是负数，基本是字体路径错或编码不匹配 - 别依赖系统字体路径，把 .ttf 文件放在项目内，用
__DIR__ . '/fonts/simsun.ttc'这种硬路径
水印位置计算、透明度混合、异常图像兜底——这些细节不写进条件分支里，上线后第一张倾斜 JPG 就会暴露问题。
