Fat-Free Framework多文件上传验证：需显示失败提示信息

我来帮你搞定Fat-Free Framework里多文件上传的验证提示问题！你的核心痛点是当前代码只跳过了错误文件的移动，但没把错误信息反馈给用户对吧？下面是完整的实现方案，包含错误收集、自定义验证和前端提示的全流程：

1. 路由处理逻辑（核心修改） #

我们需要在文件上传的回调里收集每个文件的错误信息，而不是仅仅返回false跳过移动。这里用一个引用传递的数组来存储每个文件的错误，之后把它传给视图展示：

$f3->route('GET|POST|PUT /uploadfile', function($f3) use($db){
    $f3->set('UPLOADS','uploads/');
    $overwrite = false;
    $slug = true;
    $web = \Web::instance();
    // 初始化错误数组，用来存储每个文件的验证失败信息
    $uploadErrors = [];

    // 处理文件上传，回调里收集错误
    $web->receive(function($file, $formFieldName) use (&$uploadErrors) {
        // 先处理系统级上传错误（比如文件过大、上传中断等）
        if ($file['error'] !== UPLOAD_ERR_OK) {
            $errorMsg = match($file['error']) {
                UPLOAD_ERR_INI_SIZE => '文件超过php.ini限制的最大大小',
                UPLOAD_ERR_FORM_SIZE => '文件超过表单设置的大小限制',
                UPLOAD_ERR_PARTIAL => '文件仅完成部分上传',
                UPLOAD_ERR_NO_FILE => '未选择任何文件',
                UPLOAD_ERR_NO_TMP_DIR => '服务器缺少临时文件目录',
                UPLOAD_ERR_CANT_WRITE => '无法将文件写入磁盘',
                UPLOAD_ERR_EXTENSION => 'PHP扩展阻止了本次文件上传',
                default => '未知上传错误'
            };
            $uploadErrors[$file['name']] = $errorMsg;
            return false; // 跳过当前文件的移动操作
        }

        // 自定义大小验证：限制2MB以内
        if($file['size'] > (2 * 1024 * 1024)){
            $uploadErrors[$file['name']] = '文件大小不能超过2MB';
            return false;
        }

        // 自定义文件类型验证：示例只允许图片和PDF
        $allowedMimeTypes = ['image/jpeg', 'image/png', 'application/pdf'];
        if(!in_array($file['type'], $allowedMimeTypes)){
            $uploadErrors[$file['name']] = '仅支持JPG、PNG和PDF类型的文件';
            return false;
        }

        // 所有验证通过，返回true让框架自动移动文件到UPLOADS目录
        return true;
    }, $overwrite, $slug);

    // 将错误信息传给视图
    $f3->set('uploadErrors', $uploadErrors);

    // 上传成功的提示（可选）
    if ($f3->VERB === 'POST' && empty($uploadErrors)) {
        $f3->set('successMsg', '所有文件上传成功！');
        // 这里可以添加上传成功后的逻辑，比如把文件信息存入数据库
    }

    // 渲染上传页面视图
    echo \Template::instance()->render('upload.html');
});

2. 前端视图（展示错误提示） #

在你的upload.html模板里，遍历错误数组，把每个失败文件的名称和对应错误清晰展示给用户：

<!DOCTYPE html>
<html>
<head>
    <title>多文件上传</title>
    <style>
        .error-box { color: #dc2626; background: #fee2e2; padding: 1rem; border-radius: 4px; margin: 1rem 0; }
        .success-box { color: #059669; background: #d1fae5; padding: 1rem; border-radius: 4px; margin: 1rem 0; }
        .error-list { margin: 0.5rem 0 0 1.5rem; }
    </style>
</head>
<body>
    <h2>批量文件上传</h2>

    <!-- 上传成功提示 -->
    <?php if (!empty(@$successMsg)): ?>
        <div class="success-box"><?= $successMsg ?></div>
    <?php endif; ?>

    <!-- 错误提示 -->
    <?php if (!empty(@$uploadErrors)): ?>
        <div class="error-box">
            <p>部分文件上传失败：</p>
            <ul class="error-list">
                <?php foreach ($uploadErrors as $fileName => $errorText): ?>
                    <li><strong><?= $fileName ?></strong>：<?= $errorText ?></li>
                <?php endforeach; ?>
            </ul>
        </div>
    <?php endif; ?>

    <!-- 上传表单 -->
    <form method="post" enctype="multipart/form-data">
        <input type="file" name="files[]" multiple accept=".jpg,.png,.pdf">
        <button type="submit" style="margin-left: 1rem;">开始上传</button>
    </form>
</body>
</html>

• 错误收集的核心：通过use (&$uploadErrors)把外部数组以引用方式传入闭包，这样回调里的错误信息才能被外部访问到
• 覆盖所有错误场景：不仅处理自定义的大小、类型验证，还处理PHP自带的上传系统错误，避免遗漏异常情况
• 视图友好展示：用样式区分成功和错误提示，让用户能清楚看到哪个文件出了问题

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