直接用 hinkImage::open()+thumb()+save()三步可生成缩略图，但90%失败源于路径错、权限错及Linux临时文件消失；须用move()后的绝对路径，禁用tmp_name，注意thumb()裁剪模式、目录可写性及路径斜杠统一。
直接用 hinkImage::open() + thumb() + save() 三步就能生成缩略图，但路径错、权限错、Linux 下临时文件消失这三类问题占了 90% 的失败原因。
缩略图代码必须用移动后的绝对路径
上传后 $file->move() 会把文件从临时目录移到你指定的位置，此时临时文件已被清空。很多新手还在用 $file->getInfo()['tmp_name'] 去 open()，必然报错 file not found。
- 正确做法：用
$info->getSaveName()拼出完整绝对路径，例如public_path() . '/uploads/' . $info->getSaveName() - Windows 下可能“侥幸”成功，因为临时文件没立刻删；Linux 下必挂
- 别信示例里写
./uploads/xxx.jpg—— 这是相对路径，open()在 CLI 或不同入口下工作目录不一致，极易失效
thumb() 的三个常用模式参数要分清
thumb() 第三个参数控制裁剪逻辑，默认是 hinkImage::THUMB_SCALE（等比缩放，留白），但多数业务需要的是固定宽高。
-
hinkImage::THUMB_FIXED：强制拉伸到指定尺寸，图像不变形但可能被压扁 -
hinkImage::THUMB_CENTER：等比缩放后居中裁剪，适合头像、封面图 -
hinkImage::THUMB_SCALING（默认）：等比缩放，不裁剪，图片四周可能有空白 - 注意：TP5.0 中这些常量定义在
hinkImage类里，别手写数字或字符串
Linux 服务器上 save 失败的常见硬伤
不是权限不够，而是 save() 要求目标目录存在且可写，且 PHP 进程用户（如 www-data 或 nginx）对父目录有执行（x）权限才能进入子目录。
- 先确保目录存在：
mkdir -p /path/to/public/uploads/thumb - 设权限：
chmod -R 755 /path/to/public/uploads（不推荐 777） - 检查 SELinux 是否启用：
getenforce，若是Enforcing，需加 context：chcon -R -t httpd_sys_rw_content_t /path/to/public/uploads - 用
is_writable()显式判断再操作，避免静默失败
生成多个尺寸缩略图时别重复 open
一个原始图生成 150×150、400×400、800×600 三张缩略图，不要每次 open() 原图三次 —— 文件读取开销大，尤其在 SSD 性能受限或并发高时明显拖慢。
- 正确做法：一次
open()后链式调用多次save()，例如：$image->thumb(150,150)->save($path1)->thumb(400,400)->save($path2) - 注意：
thumb()是“原图基础上操作”，不是“在上一个 thumb 结果上继续”，所以顺序不影响结果 - 如果尺寸逻辑复杂（比如要先裁再缩），建议用
crop()分开处理，避免链式误判
真正容易被忽略的点：缩略图路径拼接时，DS 和斜杠混用在 Windows 下不报错，但部署到 Linux 就变成 /uploads\202608/xxx.jpg 这种非法路径；务必统一用 / 或 DIRECTORY_SEPARATOR，且只在拼接系统路径（如 ROOT_PATH）时才用后者。
