CodeIgniter4 多文件上传时内容被覆盖的问题解析

问题现象

在使用CodeIgniter4框架进行多文件上传时，开发者发现当通过HTML表单的<input type="file" name="files" multiple>选择多个文件并提交后，服务器端只能获取到最后上传的那个文件，其他文件内容被覆盖丢失。

问题根源

这个问题源于HTML表单设计和PHP文件上传机制的交互方式。当使用multiple属性允许选择多个文件时，表单字段名称需要特殊处理：

1. 如果使用简单的字段名如name="files"，每个文件部分在HTTP请求中都会使用相同的字段名
2. PHP和CodeIgniter4在处理时会将这些同名字段视为覆盖关系，只保留最后一个
3. 正确的做法是使用数组形式的字段名name="files[]"，这样PHP会自动将所有文件收集到一个数组中

解决方案

要解决这个问题，只需修改HTML表单中的文件输入字段名称，添加数组标识符[]：

<input type="file" name="files[]" multiple>

这样修改后，CodeIgniter4的$this->request->getFiles()方法将正确返回包含所有上传文件的数组，每个文件都会作为一个独立的UploadedFile对象存在。

技术原理

在底层实现上，当使用files[]作为字段名时：

1. 浏览器会将多个文件分别作为独立的表单字段发送，但使用相同的数组键名
2. PHP的全局$_FILES变量会自动将这些同名字段组织成一个多维数组结构
3. CodeIgniter4的FileCollection类会正确解析这个结构，为每个文件创建独立的UploadedFile实例

相比之下，使用简单字段名时，PHP会将这些同名字段视为覆盖关系，最终只保留最后一个接收到的文件数据。

最佳实践

除了修正字段名称外，处理多文件上传时还应注意：

1. 在控制器中验证文件数量和类型
2. 设置合理的上传大小限制
3. 考虑使用move()方法将上传文件移动到永久存储位置
4. 处理可能的上传错误情况

示例控制器代码：

public function upload()
{
    $files = $this->request->getFiles();
    
    if (!empty($files['files'])) {
        foreach ($files['files'] as $file) {
            if ($file->isValid() && !$file->hasMoved()) {
                $newName = $file->getRandomName();
                $file->move(WRITEPATH.'uploads', $newName);
            }
        }
    }
}

通过理解这些原理和实践，开发者可以避免多文件上传时的常见陷阱，确保应用能够正确处理用户提交的多个文件。