CakePHP 4多文件上传异常：仅获取单个文件而非数组求助

嗨Gonzalo，咱们来一步步解决你的CakePHP多文件上传问题——核心问题其实出在表单控件命名和控制器里的文件对象处理上，下面给你详细拆解：

在CakePHP中，要实现多文件上传，表单的文件控件必须以数组形式命名（也就是控件名末尾加[]），否则浏览器只会提交第一个文件。你当前的代码里：

echo $this->Form->control('documents', ['type' => 'file', 'label' => __('Choose PDF Files'), 'accept' => 'application/pdf', 'multiple' => 'multiple']);

需要修改为：

echo $this->Form->control('documents[]', ['type' => 'file', 'label' => __('Choose PDF Files'), 'accept' => 'application/pdf', 'multiple' => 'multiple']);

这样浏览器才会把选中的多个文件打包成数组提交给后端。

你的控制器代码里有好几处逻辑错误，导致无法正确遍历文件数组：

错误点1：直接用file_get_contents读取上传对象 #

CakePHP的上传文件是\Psr\Http\Message\UploadedFileInterface对象，不能直接用file_get_contents($document_to_save)读取内容，需要先获取文件的真实路径：

// 错误写法
$contents = file_get_contents($document_to_save);

// 正确写法
$fileRealPath = $document_to_save->getStream()->getMetadata('uri');
$contents = file_get_contents($fileRealPath);

错误点2：循环中引用了不存在的文件对象 #

你在保存文档时写了$fileobject = $this->request->getData('document');，但你的表单里根本没有document这个字段，应该用循环当前迭代的$document_to_save对象：

// 错误写法
$fileobject = $this->request->getData('document');
$fileobject->moveTo($destination);

// 正确写法
$document_to_save->moveTo($destination);

错误点3：未定义的$pattern变量 #

你代码里$pattern = str_replace('-', '', $pattern);这一行的$pattern之前完全没定义，会直接报错，需要先基于docket->cuit初始化这个变量：

// 先处理cuit格式，再生成正则
$cleanCuit = str_replace('-', '', $docket->cuit);
$pattern = "/^.*" . preg_quote($cleanCuit, '/') . ".*$/m";

错误点4：冗余的目录创建逻辑 #

你在两个地方重复写了判断目录是否存在的代码，可以提前把目录路径存成变量，避免重复查询数据库：

// 提前获取文档目录，只判断一次
$docDir = $this->Parameters->findByName('document_directory')->first()->value;
if (!is_dir($docDir)) {
    mkdir($docDir, 0776, true);
}

public function add() {
    $upload = $this->Uploads->newEmptyEntity();
    if ($this->request->is('post')) {
        $upload = $this->Uploads->patchEntity($upload, $this->request->getData());
        
        // 提前获取并创建文档目录
        $docDir = $this->Parameters->findByName('document_directory')->first()->value;
        if (!is_dir($docDir)) {
            mkdir($docDir, 0776, true);
        }
        
        if ($this->Uploads->save($upload)) {
            $documents = $this->request->getData('documents');
            $this->loadModel('Dockets');
            $dockets = $this->Dockets->findByDocketStateId(1)->toArray(); // 转为数组方便操作
            $documents_ok = 0;
            $documents_nok = 0;
            
            foreach($documents as $document_to_save) {
                // 跳过无效的上传对象
                if (!$document_to_save instanceof \Psr\Http\Message\UploadedFileInterface) {
                    $documents_nok++;
                    continue;
                }
                
                $matched = false;
                // 获取文件真实路径并读取内容
                $fileRealPath = $document_to_save->getStream()->getMetadata('uri');
                $contents = file_get_contents($fileRealPath);
                
                foreach($dockets as $dockets_key => $docket) {
                    $cleanCuit = str_replace('-', '', $docket->cuit);
                    $pattern = "/^.*" . preg_quote($cleanCuit, '/') . ".*$/m";
                    
                    if(preg_match_all($pattern, $contents, $matches)){
                        $documentsTable = $this->getTableLocator()->get('Documents');
                        $document = $documentsTable->newEmptyEntity();
                        $document->upload_id = $upload->id;
                        $document->document_type_id = $upload->document_type_id;
                        $document->period_id = $upload->period_id;
                        $document->docket_id = $docket->id;
                        $document->user_id = $this->getRequest()->getAttribute('identity')['id'];
                        
                        if ($documentsTable->save($document)) {
                            $destination = $docDir . 'document_' . $document->id . '.pdf';
                            $document_to_save->moveTo($destination);
                            $documents_ok++;
                            $matched = true;
                            unset($dockets[$dockets_key]);
                            break;
                        } else {
                            $this->Flash->error(__('The document could not be saved. Please, try again.'));
                        }
                    }
                }
                
                if (!$matched) {
                    $documents_nok++;
                }
            }
            
            $dockets_without_document = count($dockets);
            $message = __('There were processed ') . $documents_ok . __(' documents successfully. ') . $documents_nok . __(' documents did not match with a docket. And ') . $dockets_without_document . __(' active dockets did not have a document.');
            $this->Flash->success(__('The upload has been saved. ') . $message);
            return $this->redirect(['action' => 'view', $upload->id]);
        }
        $this->Flash->error(__('The upload could not be saved. Please, try again.'));
    }
    // 以下原有代码保持不变
    $documentTypes = $this->Uploads->DocumentTypes->find('list', ['keyField' => 'id', 'valueField' => 'document_type', 'limit' => 200]);
    $periods = $this->Uploads->Periods->find('list', ['keyField' => 'id', 'valueField' => 'period', 'limit' => 200]);
    $users = $this->Uploads->Users->find('list', ['keyField' => 'id', 'valueField' => 'full_name', 'conditions' => ['id' => $this->getRequest()->getAttribute('identity')['id']], 'limit' => 200]);
    $this->set(compact('upload', 'documentTypes', 'periods', 'users'));
}

• 视图层文件控件命名改为documents[]，确保多文件以数组提交
• 控制器中正确处理上传文件对象，使用getStream()获取真实路径
• 修复循环中错误的文件对象引用
• 补全未定义的正则$pattern变量
• 优化目录创建逻辑，避免重复数据库查询和代码冗余

内容的提问来源于stack exchange，提问作者Gonzalo