ThinkPHP 6 上传图片后需手动用 GD 扩展生成缩略图：先保存原图，再通过 imagecreatefromjpeg() 等加载、imagecopyresampled() 缩放（注意参数顺序）、imagejpeg() 保存，并校验每步返回值，确保路径正确、权限充足、资源及时释放。
ThinkPHP 6 的 File 类上传后如何调用 GD 生成缩略图
ThinkPHP 6 默认不内置缩略图生成功能，上传后的图片需手动用 GD 处理。关键不是“能不能”，而是“在哪做、怎么传参、路径怎么配”。上传和缩略必须分两步：先保存原图，再读取原图生成缩略图并另存，不能边上传边缩放。
常见错误是直接对 $_FILES 资源流操作，或误以为 moveTo() 返回的 File 对象自带 GD 方法——它没有。你得用 PHP 原生 imagecreatefromjpeg() 等函数加载，再用 imagecopyresampled() 缩放。
- 确保 GD 扩展已启用：
php -m | grep gd，否则会报Call to undefined function imagecreatefromjpeg() - 原图路径必须是服务器本地绝对路径（如
/var/www/html/runtime/upload/20240510/test.jpg），不能是 URL 或相对路径 - 缩略图宽高建议显式指定，避免只设一边导致比例失真；推荐用“等比缩放 + 居中裁剪”逻辑，而非简单拉伸
imagecopyresampled() 缩放时宽高参数容易填反
这是最常踩的坑：GD 函数参数顺序反直觉。例如生成 200×150 缩略图，imagecopyresampled($thumb, $src, 0, 0, 0, 0, 200, 150, $src_w, $src_h) 中，第 7–8 位是目标图宽高（即你要的缩略图尺寸），第 9–10 位才是原图实际宽高。填错会导致空白图、黑图或严重变形。
更稳妥的做法是先用 getimagesize() 获取原图信息，再计算缩放比例：
立即学习“PHP免费学习笔记（深入）”；
list($src_w, $src_h, $type) = getimagesize($original_path); $scale = min(200 / $src_w, 150 / $src_h); // 等比缩放到最大边不超限 $thumb_w = (int)round($src_w * $scale); $thumb_h = (int)round($src_h * $scale);
然后创建画布、复制缩放、保存——注意 imagejpeg($thumb, $thumb_path, 90) 的第三个参数是质量，低于 75 会明显模糊，高于 95 文件体积激增。
ThinkPHP 6 中如何安全拼接缩略图保存路径
别硬拼字符串。用 ThinkPHP 自带的 think\facade\Filesystem 或直接用 root_path() + 目录名更可靠。例如：
- 原图存到
public/static/upload/，缩略图建议另建目录如public/static/thumb/ - 缩略图文件名建议加后缀（如
photo_200x150.jpg）或哈希前缀，避免覆盖原图 - 路径权限要检查：
public/static/thumb/目录需 Web 服务器有写入权限，否则imagejpeg()返回false且无提示 - Windows 下注意路径分隔符，统一用
DIRECTORY_SEPARATOR或str_replace('/', DS, $path)
缩略图生成失败但没报错？检查这几个隐藏点
GD 处理失败常常静默返回 false，页面却显示“上传成功”，用户根本不知道缩略图没生成。必须主动判断每一步返回值：
-
imagecreatefromjpeg()加载失败：原图损坏、路径错、非 JPEG 格式（用$type判断，支持IMAGETYPE_JPEG/IMAGETYPE_PNG/IMAGETYPE_GIF） -
imagecopyresampled()返回false：源图或目标图资源无效，或宽高为 0 -
imagejpeg()返回false：目录不可写、磁盘满、PHP 内存不足（大图缩放易触发Allowed memory size exhausted） - 缩略图生成后记得
imagedestroy($src)和imagedestroy($thumb)，否则内存泄漏
真正麻烦的不是代码写不对，而是 GD 报错不抛异常、不打日志、不中断流程。上线前务必用一张 5MB 的 PNG 和一张旋转过的 JPG 测试边界情况。
