如何在CakePHP 5中避免文件上传时覆盖已有文件？

你可以直接使用PHP原生的文件系统函数来检查目标路径下的文件是否存在，因为\Psr\Http\Message\UploadedFileInterface本身只负责上传文件的基础操作，文件存在性检查属于文件系统层面的逻辑，不在该接口的职责范围内。

方案1：检测到同名文件时返回错误提示 #

修改你的upload方法，在调用moveTo之前用file_exists()检查文件是否存在，若存在则给出提示并终止上传：

public function upload() {
    $data = $this->request->getData();
    $fileobject = $data['filename'];
    $clientFilename = $fileobject->getClientFilename();
    $destination = UPLOAD_PATH . $clientFilename;

    // 检查目标路径是否已存在同名文件
    if (file_exists($destination)) {
        $this->Flash->error('同名文件已存在，请更换文件名后重新上传');
        return $this->redirect($this->referer());
    }

    $fileobject->moveTo($destination);
    $this->Flash->success('文件上传成功');
    return $this->redirect($this->referer());
}

方案2：自动生成唯一文件名（避免覆盖） #

如果希望自动处理同名文件，无需用户更换文件名，可以通过生成唯一文件名的方式解决，比如在原文件名后添加随机字符串或时间戳：

public function upload() {
    $data = $this->request->getData();
    $fileobject = $data['filename'];
    $clientFilename = $fileobject->getClientFilename();
    $uploadDir = UPLOAD_PATH;
    
    // 拆分文件名和扩展名
    $filename = pathinfo($clientFilename, PATHINFO_FILENAME);
    $extension = pathinfo($clientFilename, PATHINFO_EXTENSION);
    
    // 生成初始唯一文件名
    $uniqueFilename = $filename . '_' . uniqid() . '.' . $extension;
    $destination = $uploadDir . $uniqueFilename;

    // 循环检查确保文件名绝对唯一（防止极端情况下的重复）
    while (file_exists($destination)) {
        $uniqueFilename = $filename . '_' . uniqid() . '.' . $extension;
        $destination = $uploadDir . $uniqueFilename;
    }

    $fileobject->moveTo($destination);
    $this->Flash->success('文件上传成功');
    return $this->redirect($this->referer());
}

两种方案都能有效避免文件被覆盖，你可以根据业务需求选择：方案1适合需要用户明确知晓文件冲突的场景，方案2适合后台自动处理、无需用户干预的场景。

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