CodeIgniter 4 多文件上传的健壮性验证与处理指南

// 当未选择文件时，print_r($this->request->getFileMultiple('car_gallery')) 的示例输出：
Array
(
    [0] => CodeIgniter\HTTP\Files\UploadedFile Object
        (
            [path:protected] => 
            [originalName:protected] => 
            [name:protected] => 
            [originalMimeType:protected] => 
            [error:protected] => 4
            [hasMoved:protected] => 
            [size:protected] => 0
            [pathName:SplFileInfo:private] => 
            [fileName:SplFileInfo:private] => 
        )
)

<form action="/upload/do_upload" method="post" enctype="multipart/form-data">
    <label for="car_gallery">选择车辆图片 (可多选):</label>
    <input type="file" name="car_gallery[]" id="car_gallery" multiple />
    <button type="submit">上传</button>
</form>

<?php namespace App\Controllers;

use CodeIgniter\Controller;
use CodeIgniter\HTTP\Files\UploadedFile;

class Upload extends Controller
{
    public function do_upload()
    {
        $files = $this->request->getFileMultiple('car_gallery');
        $actualUploadedFiles = [];

        // 步骤1：过滤掉未上传的文件
        if (!empty($files)) {
            foreach ($files as $file) {
                // 只有当 error 属性不等于 UPLOAD_ERR_NO_FILE (即4) 时，才认为是实际尝试上传的文件
                if ($file->getError() !== UPLOAD_ERR_NO_FILE) {
                    $actualUploadedFiles[] = $file;
                }
            }
        }

        // 步骤2：检查是否有实际文件被选择
        if (empty($actualUploadedFiles)) {
            // 如果 actualUploadedFiles 为空，表示用户未选择任何文件
            return redirect()->back()->withInput()->with('error', '请至少选择一张图片进行上传。');
        }

        // 步骤3：对每个实际上传的文件进行进一步验证和处理
        $uploadedNames = [];
        $errors = [];

        foreach ($actualUploadedFiles as $file) {
            /** @var UploadedFile $file */

            // 使用 CodeIgniter 的验证规则进行文件验证
            // 例如：检查文件是否有效、MIME 类型、大小等
            if (!$file->isValid()) {
                $errors[] = $file->getErrorString() . " (" . $file->getName() . ")";
                continue;
            }

            // 示例：检查文件类型和大小
            $validationRule = [
                'mime_in[car_gallery.*,image/jpg,image/jpeg,image/gif,image/png]',
                'max_size[car_gallery.*,2048]', // 2MB
            ];

            // 也可以使用 $this->validate() 方法进行更集中的验证
            // 对于多文件，需要为每个文件单独验证或构造复杂的规则
            // 简单起见，这里直接检查文件对象属性
            if (!in_array($file->getMimeType(), ['image/jpg', 'image/jpeg', 'image/gif', 'image/png'])) {
                $errors[] = "文件 " . $file->getName() . " 类型不被允许。";
                continue;
            }
            if ($file->getSize() > 2 * 1024 * 1024) { // 2MB
                $errors[] = "文件 " . $file->getName() . " 大小超过限制 (2MB)。";
                continue;
            }

            // 检查文件是否已移动，防止重复移动
            if (!$file->hasMoved()) {
                $newName = $file->getRandomName(); // 生成随机文件名
                $uploadPath = WRITEPATH . 'uploads/'; // 设置上传目录

                // 确保上传目录存在
                if (!is_dir($uploadPath)) {
                    mkdir($uploadPath, 0777, true);
                }

                $file->move($uploadPath, $newName);
                $uploadedNames[] = $newName;
            } else {
                $errors[] = "文件 " . $file->getName() . " 已经移动。";
            }
        }

        if (!empty($errors)) {
            // 处理文件上传过程中的错误
            return redirect()->back()->withInput()->with('errors', $errors);
        }

        // 所有文件上传成功
        return redirect()->back()->with('success', '文件上传成功！上传文件名：' . implode(', ', $uploadedNames));
    }
}

<?php namespace App\Controllers;

use CodeIgniter\Controller;
use Config\Services;

class Upload extends Controller
{
    public function do_upload_with_validation_service()
    {
        // 获取所有文件，包括未上传的占位符
        $files = $this->request->getFileMultiple('car_gallery');
        $actualUploadedFiles = [];

        // 过滤掉 UPLOAD_ERR_NO_FILE 的文件
        if (!empty($files)) {
            foreach ($files as $file) {
                if ($file->getError() !== UPLOAD_ERR_NO_FILE) {
                    $actualUploadedFiles[] = $file;
                }
            }
        }

        // 如果没有实际文件被选择，直接返回错误
        if (empty($actualUploadedFiles)) {
            return redirect()->back()->withInput()->with('error', '请至少选择一张图片进行上传。');
        }

        // 准备验证规则
        $rules = [
            'car_gallery.*' => [ // 注意这里使用 .* 来匹配所有上传的文件
                'rules' => 'uploaded[car_gallery]|max_size[car_gallery,2048]|mime_in[car_gallery,image/jpg,image/jpeg,image/png,image/gif]',
                'errors' => [
                    'uploaded' => '请选择要上传的图片。',
                    'max_size' => '图片文件大小不能超过 2MB。',
                    'mime_in'  => '只允许上传 JPG, JPEG, PNG, GIF 格式的图片。',
                ],
            ],
        ];

        // 运行验证
        if (!$this->validate($rules)) {
            return redirect()->back()->withInput()->with('errors', $this->validator->getErrors());
        }

        // 验证通过，开始移动文件
        $uploadedNames = [];
        foreach ($actualUploadedFiles as $file) {
            if ($file->isValid() && !$file->hasMoved()) {
                $newName = $file->getRandomName();
                $uploadPath = WRITEPATH . 'uploads/';
                if (!is_dir($uploadPath)) {
                    mkdir($uploadPath, 0777, true);
                }
                $file->move($uploadPath, $newName);
                $uploadedNames[] = $newName;
            }
        }

        return redirect()->back()->with('success', '文件上传成功！上传文件名：' . implode(', ', $uploadedNames));
    }
}