PHP多文件上传格式化

Posted 2021-09-14 硬核项目经理

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了PHP多文件上传格式化相关的知识，希望对你有一定的参考价值。

文件上传是所有web应用中最常见的功能，而php实现这一功能也非常的简单，只需要前端设置表单的 enctype 值为 multipart/form-data 之后，我们就可以通过 $_FILES 获得表单中的 file 控件中的内容。

同时，我们还可以将 file 控件的名称写成带 [] 的数组形式，这样我们就可以接收到多个上传的文件。比如下面这个测试用的表单：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Document</title>
</head>
<body>
    <form action="" enctype="multipart/form-data" method="post">

    myfile1：<input type="file" name="myfile[]"/><br/>
    myfile2：<input type="file" name="myfile[a][]"/><br/>
    myfile3：<input type="file" name="myfile[a][b][]"/><br/>
    myfile4：<input type="file" name="myfile[c][]"/><br/>
    myfile5：<input type="file" name="myfile[]"/><br/>
    myfile6：<input type="file" name="myfile[][]"/><br/>
    <br/>
    newfile1：<input type="file" name="newfile[][]"/><br/>
    newfile2：<input type="file" name="newfile[s]"/><br/>

    singlefile: <input type="file" name="singlefile"/><br/>
        <input type="submit" value="submit"/>
    </form>
</body>
</html>

一共有9个 file 控件，其中 myfile 和 newfile 都是数组类型的表单名，而 singlefile 则是一个单独的。先简单的看一下 $_FILES 所获得的内容。

看出有什么问题了吗？

$_FILE[\'singlefile\'][\'name\'];
$_FILE[\'singlefile\'][\'type\'];
$_FILE[\'singlefile\'][\'tmp_name\'];
$_FILE[\'singlefile\'][\'error\'];
$_FILE[\'singlefile\'][\'error\'];

$_FILE[\'myfile\'][\'name\'][\'a\'][\'b\'][0];
$_FILE[\'myfile\'][\'type\'][\'a\'][\'b\'][0];
$_FILE[\'myfile\'][\'tmp_name\'][\'a\'][\'b\'][0];
$_FILE[\'myfile\'][\'error\'][\'a\'][\'b\'][0];
$_FILE[\'myfile\'][\'error\'][\'a\'][\'b\'][0];

单个表单是一个 singlefile 为键名的数组，里面是对应的 name 、 type 等属性。这个非常简单也清晰明了，但是数组形式上传的内容就比较坑了，每一个属性下面都有多个值，而且这些值还有可能是嵌套的数组。就比如说我们要获得 myfilea[] 的上传文件内容，我们就要通过 \\$_FILE\'myfile\'\'a\'[0] 、 $_FILE[\'myfile\'][\'type\'][\'a\'][\'b\'][0] 这样的形式获得相关的内容。这个可真的不是很友好，那么我们今天的主题就来了，我们把这种内容进行一下格式化，让他变成和 singlefile 类似的结构，也就是一个文件的相关内容都在一个键名结构下，比如 myfile[a][b][] 的内容就全部都在 $_FILE\'myfile\'b下面。

$files = [];
// 开始数据格式化
foreach ($_FILES as $uploadKey => $uploadFiles) {
    // 需要将 $_FILES 中的五个字段都拿出来
    $files[$uploadKey] = formatUploadFiles($uploadFiles[\'name\'], $uploadFiles[\'type\'], $uploadFiles[\'tmp_name\'], $uploadFiles[\'error\'], $uploadFiles[\'size\']);
}

// 格式化上传文件数组
function formatUploadFiles($fileNamesArray, $type, $tmp_name, $error, $size)
{
    $tmpFiles = [];
    // 文件名是否是数组，如果不是数组，就是单个文件上传
    if (is_array($fileNamesArray)) {
        // 数组形式上传
        foreach ($fileNamesArray as $idx => $fileName) {
            // 如果还是嵌套的数组，递归遍历接下来的内容
            if (is_array($fileName)) {
                $tmpFiles[$idx] = formatUploadFiles($fileName, $type[$idx] ?? [], $tmp_name[$idx] ?? [], $error[$idx] ?? [], $size[$idx] ?? []);
            } else {
                // 组合多维的格式化内容
                $tmpFiles[$idx] = [
                    \'name\' => $fileName,
                    \'type\' => $type[$idx] ?? \'\',
                    \'tmp_name\' => $tmp_name[$idx] ?? \'\',
                    \'error\' => $error[$idx] ?? \'\',
                    \'size\' => $size[$idx] ?? \'\',
                ];
            }
        }
    } else {
        // 组合单个的内容
        $tmpFiles = [
            \'name\' => $fileName,
            \'type\' => $type ?? \'\',
            \'tmp_name\' => $tmp_name ?? \'\',
            \'error\' => $error ?? \'\',
            \'size\' => $size ?? \'\',
        ];
    }

    return $tmpFiles;
}

print_r($files);

代码还是非常好理解的，就是通过一段递归来遍历整个 $_FILES 目录树，相当于一个深度遍历。当然，这样也会带来性能的下降，毕竟是需要进行循环+递归的遍历。不过好在大部分情况下我们上传的文件并不会那么的多。不过反过来说，如果不事先进行格式化，当你想获得所有的上传内容时，一样还是需要进行多层或者递归遍历的。

接下来我们看看格式化之后的输出：

和上面原始的 $_FILES 相比是不是清晰明了的很多？这回我们如果需要 myfilea[] 里面全部的内容时，就可以使用下面的方式方便的获取了：

$files[\'myfile\'][\'a\'][\'b\'][0][\'name\'];
$files[\'myfile\'][\'a\'][\'b\'][0][\'type\'];
$files[\'myfile\'][\'a\'][\'b\'][0][\'tmp_name\'];
$files[\'myfile\'][\'a\'][\'b\'][0][\'error\'];
$files[\'myfile\'][\'a\'][\'b\'][0][\'size\'];

当然，这种需求在我们的日常工作中并不多见，这里也只是提供一个思路，将数据提前转化成我们需要的格式是一种非常好的习惯，能够让我们的后续操作变得非常简单。

测试代码：

https://github.com/zhangyue0503/dev-blog/blob/master/php/202004/source/PHP%E5%A4%9A%E6%96%87%E4%BB%B6%E4%B8%8A%E4%BC%A0%E6%A0%BC%E5%BC%8F%E5%8C%96.php

参考文档：

https://www.php.net/manual/zh/features.file-upload.php

各自媒体平台均可搜索【硬核项目经理】

以上是关于PHP多文件上传格式化的主要内容，如果未能解决你的问题，请参考以下文章

php多文件上传实现代码

关于PHP上传文件时配置 php.ini 中的 upload_tmp_dir

使用AFnetworking以多部分格式上传图像在ios中不起作用

php上传文件错误怎么解决

如何实现用php上传视频文件?

php如何实现一次性上传多个文件