PHP 8.2环境下CKFinder快速上传功能失效问题求助

问题 #

在PHP 7环境下使用CKFinder完全正常，但升级到PHP 8.2后，通过quick upload上传图片时触发以下错误：

CKSource\CKFinder\Filesystem\File\UploadedFile::__construct(): Argument #1 ($uploadedFile) must be of type Symfony\Component\HttpFoundation\File\UploadedFile, array given

手动修改FileUpload.php添加以下代码后，错误信息变化但问题仍未解决：

use Symfony\Component\HttpFoundation\File\UploadedFile as UploadedFileBase;

$path = $upload['tmp_name'];
//$pathinfo = pathinfo($path);
$pathinfo = pathinfo($upload['full_path']);
$basename = $pathinfo['basename'];

$upload_File = new UploadedFileBase(
            $path,
            $basename,
            $upload['type'],
            $upload['error']
        );

$uploadedFile = new UploadedFile($upload_File, $this->app);

解决方案 #

1. 优先升级CKFinder到兼容PHP 8.2的版本 #

这类版本兼容问题大多源于CKFinder版本过旧，未适配PHP 8.x的类型声明和超全局变量处理逻辑。替换为官方最新稳定版并重新配置，可直接解决问题。

2. 手动修复上传处理逻辑（临时方案） #

若暂时无法升级，可修改FileUpload.php中上传文件的处理逻辑，确保传入CKSource\CKFinder\Filesystem\File\UploadedFile的是合法的Symfony\Component\HttpFoundation\File\UploadedFile实例：

// 在处理上传文件的方法中添加以下判断逻辑
if (is_array($upload)) {
    // 校验上传文件的必要字段
    if (!isset($upload['tmp_name'], $upload['name']) || !is_uploaded_file($upload['tmp_name'])) {
        throw new \CKSource\CKFinder\Exception\InvalidUploadException('无效的上传文件');
    }
    
    $uploadedFileBase = new \Symfony\Component\HttpFoundation\File\UploadedFile(
        $upload['tmp_name'],
        $upload['name'],
        $upload['type'] ?? null,
        $upload['error'] ?? UPLOAD_ERR_OK,
        true // PHP 8.0+需显式设置该参数，确保文件为HTTP上传来源
    );
    
    $uploadedFile = new \CKSource\CKFinder\Filesystem\File\UploadedFile($uploadedFileBase, $this->app);
} else {
    // 保留原有逻辑处理已为UploadedFile实例的情况
    $uploadedFile = new \CKSource\CKFinder\Filesystem\File\UploadedFile($upload, $this->app);
}

注意事项：

• 确保已正确引入Symfony\Component\HttpFoundation\File\UploadedFile类，可通过use语句或完整命名空间调用
• 处理前必须校验$upload数组的核心字段，避免数组索引错误
• PHP 8.0+中UploadedFile构造函数的$test参数默认值变更，显式设置为true可避免文件验证失败

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