gd库未启用会导致imagecreatefromjpeg报“call to undefined function”错误，需在php.ini中启用扩展并重启服务；上传图片应直接使用$_files'file'，配合getimagesize验证类型，避免伪造mime；裁剪时注意imagecopyresampled参数顺序及坐标非负；保存需按原始格式选用对应函数并合理设置质量。
GD 库没启用，imagecreatefromjpeg 直接报错
PHP 默认不开启 GD 扩展，一调用 imagecreatefromjpeg 就提示 “Call to undefined function”，不是代码写错了，是扩展根本没加载。Windows 下检查 php.ini 里有没有 extension=gd（或 extension=php_gd2.dll），Linux 下得确认是否装了 php-gd 包（如 Ubuntu 运行 sudo apt install php-gd），改完记得重启 Web 服务。漏掉这步，后面所有裁剪逻辑都跑不起来。
上传后直接裁剪，别先 move_uploaded_file 再读取
用户上传的图片在临时目录，用 $_FILES['file']['tmp_name'] 就能直接传给 imagecreatefromjpeg 等函数——省掉一次磁盘写入再读取，既快又避免并发时临时文件被覆盖或清理。但注意：只支持 JPEG/PNG/GIF 三类，其他格式（比如 WebP）会失败；上传前最好用 getimagesize 验证真实类型，别信 $_FILES['file']['type']，它只是浏览器传来的 MIME，可伪造。
常见错误现象：imagecreatefromjpeg(): Filename cannot be empty，说明 $_FILES['file']['tmp_name'] 是空，可能是表单没设 enctype="multipart/form-data"，或者上传超出了 upload_max_filesize 限制。
裁剪坐标和尺寸算不准，imagecopyresampled 参数顺序容易反
imagecopyresampled 的参数顺序是目标图、源图、目标 X/Y、源 X/Y、目标宽高、源宽高——很多人把“源 X/Y”和“目标 X/Y”搞混，结果裁出来偏移错位。实际做法是：先用 getimagesize 拿到原始宽高，再按需求确定裁剪区域（比如居中裁成 200×200）：
立即学习“PHP免费学习笔记（深入）”；
$src = imagecreatefromjpeg($_FILES['file']['tmp_name']); $orig_w = imagesx($src); $orig_h = imagesy($src); $dst_w = $dst_h = 200; $src_x = ($orig_w - $dst_w) / 2; $src_y = ($orig_h - $dst_h) / 2; $dst = imagecreatetruecolor($dst_w, $dst_h); imagecopyresampled($dst, $src, 0, 0, $src_x, $src_y, $dst_w, $dst_h, $dst_w, $dst_h);
注意：GD 不支持负数坐标，$src_x 或 $src_y 小于 0 会导致裁剪异常；如果原始图比目标还小，得先判断再处理，否则白屏或黑块。
保存时质量丢失严重，imagejpeg 第二个参数没设对
imagejpeg($img, $path) 默认用 75% 质量，但如果不传 $path（只传资源句柄），它会直接输出到浏览器，导致页面乱码。更常见的坑是：保存 PNG 用 imagejpeg，保存 JPEG 用 imagepng，结果文件损坏。正确做法是根据原始类型选函数：
- 原始是 JPEG → 用
imagejpeg($dst, $out_path, 90) - 原始是 PNG → 用
imagepng($dst, $out_path)（PNG 无质量参数） - 想统一转 JPEG → 先检测原始类型，再强制用
imagejpeg，但透明背景会变黑，得手动填底色
性能影响：质量设 100 会让文件体积翻倍，但人眼几乎看不出差别；设低于 60 后噪点明显，尤其文字截图类图片。
GD 处理大图内存吃紧，比如 5000×4000 的图，imagecreatetruecolor 可能申请几百 MB 内存，超限就崩溃。真要处理大图，得提前用 ini_set('memory_limit', '512M')，或者换 Imagick ——但那是另一个库了。
