在php项目中,实现表单文件多选上传需要先正确配置前端表单,再通过php接收多文件数组并逐个处理保存,整个过程需要关注表单属性、后端数据结构和文件处理逻辑三个核心部分。

前端表单配置
要实现文件多选,需要在<input>标签中添加multiple属性,同时设置name属性为数组形式,方便后端接收多个文件数据。表单必须设置enctype属性为multipart/form-data,否则无法正确传输文件数据。
<form action="upload.php" method="post" enctype="multipart/form-data">
<!-- name设置为数组形式,multiple支持多选 -->
<input type="file" name="upload_files[]" multiple>
<input type="submit" value="上传文件">
</form>
php接收多文件数组结构
当用户选择多个文件提交表单后,php会在$_FILES超全局变量中接收到对应的数据,此时$_FILES['upload_files']是一个二维数组,包含name、type、tmp_name、error、size五个子数组,每个子数组的索引对应同一个文件的不同属性。
比如用户上传了2个文件,$_FILES['upload_files']['name'][0]是第一个文件的原始名称,$_FILES['upload_files']['tmp_name'][0]是第一个文件在服务器上的临时存储路径,$_FILES['upload_files']['error'][0]是第一个文件的上传错误码,0表示上传成功。
逐个保存上传文件
逐个保存文件需要先遍历多文件数组,再对每个文件做错误校验、类型校验、大小校验,最后通过move_uploaded_file函数将临时文件移动到指定的保存目录。
<?php
// 定义文件保存目录,需要确保目录有写入权限
$saveDir = './uploads/';
if (!is_dir($saveDir)) {
mkdir($saveDir, 0777, true);
}
// 检查是否有文件上传
if (isset($_FILES['upload_files'])) {
$files = $_FILES['upload_files'];
$fileCount = count($files['name']);
// 遍历所有上传的文件
for ($i = 0; $i < $fileCount; $i++) {
// 获取当前文件的上传错误码
$error = $files['error'][$i];
if ($error != 0) {
echo "第" . ($i + 1) . "个文件上传失败,错误码:" . $error . "<br>";
continue;
}
// 获取当前文件的原始名称
$originalName = $files['name'][$i];
// 获取临时文件路径
$tmpPath = $files['tmp_name'][$i];
// 获取文件大小,单位字节
$fileSize = $files['size'][$i];
// 获取文件类型
$fileType = $files['type'][$i];
// 校验文件大小,限制最大2MB
$maxSize = 2 * 1024 * 1024;
if ($fileSize > $maxSize) {
echo "第" . ($i + 1) . "个文件" . $originalName . "超过大小限制<br>";
continue;
}
// 校验文件类型,只允许上传jpg、png、pdf
$allowTypes = ['image/jpeg', 'image/png', 'application/pdf'];
if (!in_array($fileType, $allowTypes)) {
echo "第" . ($i + 1) . "个文件" . $originalName . "类型不允许<br>";
continue;
}
// 生成唯一的保存文件名,避免重名覆盖
$ext = pathinfo($originalName, PATHINFO_EXTENSION);
$saveName = uniqid() . '.' . $ext;
$savePath = $saveDir . $saveName;
// 移动临时文件到保存目录
if (move_uploaded_file($tmpPath, $savePath)) {
echo "第" . ($i + 1) . "个文件" . $originalName . "保存成功,路径:" . $savePath . "<br>";
} else {
echo "第" . ($i + 1) . "个文件" . $originalName . "保存失败<br>";
}
}
}
?>
注意事项
- php配置文件
php.ini中的file_uploads需要设置为On,开启文件上传功能 upload_max_filesize和post_max_size需要根据实际需求调整,避免大文件无法上传- 保存文件的目录需要设置正确的写入权限,否则
move_uploaded_file函数会执行失败 - 不要直接使用用户上传的原始文件名作为保存文件名,避免路径注入和重名覆盖问题
- 上传完成后及时清理临时文件,不过
move_uploaded_file函数执行成功后会自动清理对应临时文件