HTML多文件上传表单仅向PHP传输单个文件的问题排查

你的多文件上传功能仅能接收第一个文件，且触发foreach() argument must be of type array|object, string given警告，核心原因是文件输入框的name属性未添加[]，PHP默认只会解析第一个文件的信息，导致$_FILES['file']['tmp_name']是字符串而非数组，无法遍历。

第一步：修正表单代码 #

将文件输入框的name属性改为file[]，让PHP识别这是多文件上传字段：

<form method="post" enctype="multipart/form-data">
  <input type="file" name="file[]" multiple>
  <input type="hidden" value="GALLUPLOAD" name="DO">
  <input type="submit" value="Upload Gallery Photos">
</form>

修改后，$_FILES会生成多维数组结构，示例如下：

Array
(
    [file] => Array
        (
            [name] => Array
                (
                    [0] => 9.jpg
                    [1] => 0.jpg
                    [2] => 1.JPG
                    ...
                )
            [type] => Array(...),
            [tmp_name] => Array(...),
            [error] => Array(...),
            [size] => Array(...)
        )
)

第二步：调整后端处理逻辑 #

核心修改点： #

1. 遍历多维数组时正确获取每个文件的属性
2. 修复文件名重复覆盖问题（原代码用固定time().jpg会导致所有文件被覆盖）

修改后的完整处理代码：

switch ($_POST['DO'])
{
    case "MAINUPLOAD":
        $relp="";
        $maxsize=800;
        $fn='/0.jpg';
        break;
    case "GALLUPLOAD":
        $relp='/gallery';
        $maxsize=1600;
        // 这里不再固定文件名，改为在循环内生成
        break;
}

if(isset($_FILES['file'])) {
    $DirDestination = getcwd() . substr($user['PHOTODIR'], 2);
    echo "<BR> DirDestination ".$DirDestination;

    if (!file_exists($DirDestination))
        mkdir($DirDestination, 0777, true);
    if (!file_exists($DirDestination . '/gallery'))
        mkdir($DirDestination . '/gallery', 0777, true);

    $DirDestination = $DirDestination . $relp;
    echo "<BR> DirDestination ".$DirDestination;

    foreach ($_FILES['file']['tmp_name'] as $key => $tmpName )
    {
        echo "<BR> XXX";
        // 获取当前文件的错误码
        $fileError = $_FILES['file']['error'][$key];
        if( $fileError !== UPLOAD_ERR_OK )
        {
            echo "<BR> err 错误码：".$fileError;
            continue; // 跳过上传失败的文件
        }
        $check=can_upload($tmpName);
        echo "<BR> check ".$check;

        if ($check === true) {
            echo "<BR> check ".$check;

            // 生成唯一文件名，避免覆盖
            // 方案1：使用原文件名（过滤特殊字符保证安全）
            $originalName = $_FILES['file']['name'][$key];
            $safeFileName = preg_replace('/[^a-zA-Z0-9_\-\.]/', '', $originalName);
            $fn = '/' . $safeFileName;

            // 方案2：时间戳+索引，确保绝对唯一
            // $fn = '/' . time() . '_' . $key . '.jpg';

            try {
                $img = new Imagick($tmpName);
                $img->stripImage(); // 移除EXIF数据
                if ($img->getImageWidth() > $img->getImageHeight()) {
                    $newWidth = $maxsize;
                    $newHeight = $maxsize * $img->getImageHeight() / $img->getImageWidth();
                } else {
                    $newHeight = $maxsize;
                    $newWidth = $maxsize * $img->getImageWidth() / $img->getImageHeight();
                }
                $img->resizeImage($newWidth, $newHeight, imagick::FILTER_CATROM, 1);

                $tile = new \Imagick();
                $tile->newImage($img->getImageWidth(), $img->getImageHeight(), 'transparent', 'png');
                $watermarkx = new \Imagick(getcwd() . '/cats/fflogo.png');
                $watermarkx->resizeImage($newWidth / 2, $newWidth * $watermarkx->getImageHeight() / $watermarkx->getImageWidth() / 2, imagick::FILTER_CATROM, 1);
                $img->compositeImage($watermarkx, imagick::COMPOSITE_ATOP, $newWidth - $watermarkx->getImageWidth(), $newHeight - $watermarkx->getImageHeight());
                $img->writeImage($DirDestination . $fn);
                $img->clear();
                $img->destroy();
            } catch (Exception $e) {
                echo 'Exception caught: ', $e->getMessage(), "\n";
            }

        }
        else
        {
            echo "<strong>$check</strong>";
        }

    }
}

额外注意事项 #

• 检查PHP配置：确保upload_max_filesize和post_max_size的值足够容纳多个文件的总大小
• 增强安全验证：可添加文件类型、大小的额外校验，防止恶意文件上传
• 权限检查：确保目标目录有可写权限，避免文件写入失败

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