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

$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 相比是不是清晰明了的很多？这回我们如果需要 myfile[a][b][] 里面全部的内容时，就可以使用下面的方式方便的获取了：

$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