PHP图像处理四大坑：加载需校验上传状态与真实类型；缩放须按比例计算尺寸防模糊变形；中文水印要指定绝对路径.ttf字体并启用alpha混合；输出前清空缓冲区且及时销毁资源。
imagecreatetruecolor 是 PHP 图像处理的起点，但光会创建画布远远不够——真正卡住新手的，是加载、缩放、水印、输出这四步里藏的坑。GD 库默认就带，不用装扩展，但函数名相似、参数顺序反直觉、资源不释放就内存溢出，这些才是实操中天天撞墙的地方。
用 imagecreatefromjpeg 加载图片时，为什么总报“failed to open stream”？
这不是路径写错那么简单。PHP 的 GD 函数只认文件内容，不信任文件后缀或 MIME 类型。常见错误有三类：
-
$_FILES['image']['tmp_name']被直接传给imagecreatefromjpeg()，但上传失败时它可能是空字符串或非法路径；必须先检查$_FILES['image']['error'] === UPLOAD_ERR_OK - 文件实际是 PNG 或 WebP，却硬用
imagecreatefromjpeg()—— 会静默失败返回false，后续调用imagesx()就报“expects parameter 1 to be GdImage” - 路径含中文或特殊字符（如空格、括号），
fopen层直接拒绝。建议用urlencode()编码后再拼接，或统一转为英文路径
稳妥做法：先用 getimagesize($path) 拿到真实类型，再分发调用：imagecreatefromjpeg / imagecreatefrompng / imagecreatefromgif。
imagecopyresampled 缩放后图像模糊或变形，怎么算尺寸才对？
这个函数本身不负责“保持比例”，它只是按你给的宽高硬拉伸。模糊源于源图像素被粗暴重采样，变形则是因为目标宽高没按原始比例推导。
立即学习“PHP免费学习笔记（深入）”；
- 要等比缩放（contain）：目标宽高按比例缩放，留黑边。计算方式：
$scale = min($dst_w / $src_w, $dst_h / $src_h); $new_w = (int)round($src_w * $scale); $new_h = (int)round($src_h * $scale); - 要裁剪填充（cover）：目标区域必须填满，多余部分裁掉。计算方式：
$scale = max($dst_w / $src_w, $dst_h / $src_h); $crop_w = (int)round($dst_w / $scale); $crop_h = (int)round($dst_h / $scale); $src_x = (int)(($src_w - $crop_w) / 2); $src_y = (int)(($src_h - $crop_h) / 2); - 别漏掉
imagealphablending($dst, false)和imagesavealpha($dst, true)—— 否则 PNG 透明背景会被替换成黑色
加文字水印用 imagettftext，为什么中文全是方块？
GD 不内置中文字体支持。imagettftext 的第 7 个参数是字体文件路径，不是系统字体名。Windows 的 simhei.ttf、Linux 的 /usr/share/fonts/dejavu/DejaVuSans.ttf 都可能不存在，或权限不足读取。
- 字体文件必须是 TrueType（.ttf）或 OpenType（.otf），不能是 .fon 或系统缓存字体
- 路径必须是绝对路径，相对路径在 CLI 和 Web 环境下行为不一致；推荐用
__DIR__ . '/fonts/msyh.ttc' - 中文需确保字体本身包含对应字形；很多免费字体缺生僻字，可先用
imagettfbbox测一个字宽高验证是否加载成功 - 别忘了
imagecolorallocate分配颜色前，先调用imagealphablending($im, true)，否则半透明文字会叠加出奇怪色块
输出图片前 header 已发送，或者浏览器显示乱码，怎么办？
GD 输出的是二进制图像流，任何前置的 echo、var_dump、空白符、BOM 头都会破坏 HTTP 响应体，导致浏览器解析失败。
- 务必在
header('Content-Type: image/png')前，确认没有输出缓冲区残留：加一句ob_end_clean()最保险 - 保存文件时，
imagepng($im, $file)的$file路径需有写入权限；若用imagepng($im)直接输出，必须确保脚本无其他输出 - 调试阶段可用
error_log(bin2hex(substr($output, 0, 16)))查看前几个字节是不是 PNG 签名（89 50 4E 47），快速判断是否真输出了图像 -
imagedestroy($im)不是可选项——大图处理时，不销毁资源会导致 PHP 进程内存持续增长，尤其在循环批量处理时极易超限
最易被忽略的一点：GD 在 PHP 8.0+ 返回 GdImage 对象，但旧代码里仍用 resource 类型判断（如 is_resource($im)）会失效，应改用 $im instanceof GdImage。
