17370845950

PHP需用自定义函数展平$_FILES['photos']嵌套结构，再逐个检查error是否为UPLOAD_ERR_OK，匹配前端name="docs[]"并调高upload_max_filesize和max_file_uploads。

PHP如何正确接收 $_FILES 中的多文件数组

PHP 默认不会自动把多个同名文件输入框（）解析成扁平数组，而是生成嵌套结构。直接遍历 $_FILES['photos'] 会出错，因为它的键是 name、tmp_name 等，不是按文件索引组织的。

关键点：必须先用自定义函数“展平”$_FILES['photos']，否则 foreach 会遍历出字段名而非文件项。

推荐写法：

function flatten_files_array($files) {
    $flattened = [];
    foreach ($files['name'] as $index => $name) {
        if (!empty($name)) {
            $flattened[] = [
                'name'     => $name,
                'type'     => $files['type'][$index],
                'tmp_name' => $files['tmp_name'][$index],
                'error'    => $files['error'][$index],
                'size'     => $files['size'][$index],
            ];
        }
    }
    return $flattened;
}

$uploaded_files = flatten_files_array($_FILES['photos']);

move_uploaded_file() 批量处理前必须检查每个文件的 error

上传失败不等于 $_FILES 为空——比如用户点了“上传”但没选文件，或单个文件超限，error 字段会是 UPLOAD_ERR_NO_FILE（4）或 UPLOAD_ERR_INI_SIZE（1）。跳过检查直接移动会导致警告甚至覆盖风险。

立即学习“PHP免费学习笔记（深入）”；

• UPLOAD_ERR_OK（0）才表示上传成功
• UPLOAD_ERR_NO_FILE（4）常见于前端未选文件却提交了空数组
• UPLOAD_ERR_FORM_SIZE（2）说明表单中 MAX_FILE_SIZE 隐藏域限制被触发（仅客户端校验，不可靠）

实操建议：

foreach ($uploaded_files as $file) {
    if ($file['error'] !== UPLOAD_ERR_OK) {
        error_log("Upload failed for {$file['name']}: error {$file['error']}");
        continue;
    }
    $target = '/var/www/uploads/' . basename($file['name']);
    if (move_uploaded_file($file['tmp_name'], $target)) {
        echo "Saved: {$target}\n";
    }
}

前端 和后端命名必须严格匹配

浏览器发送多文件时，只有 name 带方括号（如 name="docs[]"），PHP 才会把同名字段聚合成数组结构。漏掉 [] 会导致只收到最后一个文件。

常见错误写法：

• → 后端只拿到一个文件（最后那个）
• （没加 multiple）→ 只能选一个，但后端仍需展平逻辑（兼容性考虑）

正确写法（支持多选 + 正确解析）：

  
  Upload

大文件或大量文件时，upload_max_filesize 和 max_file_uploads 必须同步调高

PHP 默认限制单文件 2MB（upload_max_filesize）、一次最多上传 20 个文件（max_file_uploads）。上传 50 个 1MB 文件会卡在第 21 个，且报错信息极不明确（$_FILES 里对应项为全空或 error=0 但 tmp_name 为空）。

检查方式：

var_dump(ini_get('upload_max_filesize'), ini_get('max_file_uploads'));
// 输出类似：string(3) "2M"  string(2) "20"

调整建议：

• 修改 php.ini：设 upload_max_filesize = 8M、max_file_uploads = 100
• 若无法改配置，可在脚本开头用 ini_set() 尝试（部分 SAPI 不生效）
• 注意 post_max_size 必须 ≥ 所有文件总大小 + 其他表单数据

真正容易被忽略的是：这些限制是 PHP 解析层硬限制，不抛异常，只静默截断或丢弃超出部分——必须主动校验 count($uploaded_files) 是否等于预期数量。