CI4.5.8 中 Image 类和 Files 类已被彻底移除，图像处理需集成 intervention/image，文件上传需通过 $this->request->getFile() 获取 File 实例并手动 move()。
Image 类和 Files 类在 CodeIgniter 4.5.8 中已不再内置提供——这是升级后最常被忽略的断层点。CI4 从 4.0 开始就移除了原生的 image_lib 和 upload 类，4.5.8 更是彻底清除了所有遗留封装。你不能直接用 $this->image->resize() 或 $this->upload->do_upload()。
为什么 CI4.5.8 没有 Image 和 Files 类
CI4 的设计哲学是“不打包、不强耦合”。图像缩放、水印、格式转换等属于领域功能，应交由成熟第三方库（如 intervention/image）处理；文件上传与验证则被拆解为 File 实体 + Validation 规则 + 手动移动逻辑。这意味着：
- Image 类不是“被隐藏了”，而是根本没实现
- Files 类也不存在；你拿到的是 CodeIgniter\HTTP\File 实例（注意命名空间）
- 所有旧版 CI3 的 $this->load->library('image_lib') 会直接报错 Class 'Image_lib' not found
上传文件：用 File 实体 + move() 手动处理
表单提交后，通过 $this->request->getFile() 获取上传项，它返回一个 File 对象，不是数组也不是字符串：
$file = $this->request->getFile('avatar');
if ($file && $file->isValid() && !$file->hasMoved()) {
$newName = $file->getRandomName();
$file->move(WRITEPATH . 'uploads/', $newName);
}关键点：
- 必须显式调用 isValid() 判断是否上传成功（比如超限、中断）
- 必须检查 hasMoved()，否则重复 move() 会抛出异常
- WRITEPATH . 'uploads/' 是推荐存放路径，别硬写 ./uploads/ —— 后者可能在 webroot 外不可写，也可能被直接 HTTP 访问
- getRandomName() 自动带扩展名，无需拼接
图像处理：集成 intervention/image 是事实标准
CI4.5.8 官方不提供图像操作能力，但社区统一采用 intervention/image（支持 GD 和 Imagick）。安装后，在控制器中这样用：
use Intervention\Image\ImageManager;
use Intervention\Image\Drivers\Gd\Driver;
<p>$manager = new ImageManager(new Driver());
$image = $manager->read(WRITEPATH . 'uploads/' . $newName);
$image->scale(300, null, function ($constraint) {
$constraint->aspectRatio();
});
$image->save(WRITEPATH . 'uploads/thumb_' . $newName);注意事项：
- 不要试图把 ImageManager 做成全局服务注入，CI4 的 Services 不预置它，每次按需实例化更轻量
- scale() 第二个参数为 null 表示等比缩放，第三个闭包控制裁剪/拉伸行为
- 如果服务器没装 gd 扩展，会报 Driver not supported，改用 Imagick\Driver 前需确认扩展已启用
- WRITEPATH 是唯一安全的可写目录，别往 public/ 下直接写图——除非你手动配置了 Web 服务器禁止执行 PHP
常见错误与绕过陷阱
实际开发中最容易卡住的地方：
- 表单漏写 enctype="multipart/form-data" → $this->request->getFile() 返回 null，且无提示
- 上传后没检查 $file->getError()，导致“上传失败”却显示“成功”
- 把 $file->store() 当作自动重命名并保存（它只存到 WRITEPATH . 'uploads/'，不支持自定义子目录）
- 图像处理时传入相对路径（如 'uploads/xxx.jpg'），必须用绝对路径（WRITEPATH . 'uploads/xxx.jpg'）
- 在 CLI 环境（如 spark 命令）中调用图像处理，但未设置 $_SERVER['DOCUMENT_ROOT'] → WRITEPATH 可能为空
