PHP多文件上传时$_FILES结构是二维关联数组,需按索引重组为单文件列表,并逐个验证is_uploaded_file、扩展名白名单、图片真实性、大小及重命名安全性。

PHP 多文件上传的 $_FILES 结构必须先看懂
PHP 不会自动把多个同名 的文件合并成一个数组——它生成的是一个**二维关联数组**,结构固定。如果没意识到这点,foreach($_FILES['files'] as $file) 会直接遍历字段名(name、tmp_name 等),而不是单个文件,这是最常踩的坑。
正确结构示例(3 个文件):
$_FILES['files'] = [
'name' => ['a.jpg', 'b.pdf', 'c.txt'],
'tmp_name' => ['/tmp/phpabc123', '/tmp/phpdef456', '/tmp/phpghi789'],
'size' => [10240, 204800, 512],
'error' => [0, 0, 0],
'type' => ['image/jpeg', 'application/pdf', 'text/plain']
];
所以要按索引重组为文件列表:
$files = [];
for ($i = 0; $i < count($_FILES['files']['name']); $i++) {
if ($_FILES['files']['error'][$i] === UPLOAD_ERR_OK) {
$files[] = [
'name' => $_FILES['files']['name'][$i],
'tmp_name' => $_FILES['files']['tmp_name'][$i],
'size' => $_FILES['files']['size'][$i],
'type' => $_FILES['files']['type'][$i],
'error' => $_FILES['files']['error'][$i]
];
}
}
用 move_uploaded_file() 移动前必须逐个验证
不能只检查 error === 0 就直接移动——攻击者可伪造 $_FILES 或绕过前端限制。每个文件都需独立验证:
立即学习“PHP免费学习笔记(深入)”;
基于Intranet/Internet 的Web下的办公自动化系统,采用了当今最先进的PHP技术,是综合大量用户的需求,经过充分的用户论证的基础上开发出来的,独特的即时信息、短信、电子邮件系统、完善的工作流、数据库安全备份等功能使得信息在企业内部传递效率极大提高,信息传递过程中耗费降到最低。办公人员得以从繁杂的日常办公事务处理中解放出来,参与更多的富于思考性和创造性的工作。系统力求突出体系结构简明
-
is_uploaded_file($file['tmp_name'])必须为true(防止本地文件路径伪造) - 用
pathinfo($file['name'], PATHINFO_EXTENSION)提取扩展名,再比对白名单(不要信任$file['type'],它由浏览器发送,完全不可信) - 用
getimagesize($file['tmp_name'])验证图片真实性(仅对图片类型) - 检查
$file['size']是否超过业务允许上限(如 5MB),注意还要和upload_max_filesize、post_max_size配置对齐
前端 和 PHP 配置容易漏掉的关键项
多文件上传失败,80% 出在配置没调对,不是代码问题:
- HTML 表单必须带
enctype="multipart/form-data",缺了就根本不会传文件 - PHP 的
max_file_uploads默认是 20,如果一次传 30 个,后 10 个会被静默丢弃($_FILES里根本不会出现) -
post_max_size要 ≥ 所有文件总大小 + 其他表单字段开销,否则整个请求被截断,$_FILES为空 - Apache 的
LimitRequestBody或 Nginx 的client_max_body_size也得同步放开
建议在上传前加服务端兜底检测:
if (ini_get('max_file_uploads') < count($_FILES['files']['name'])) {
die('超出服务器允许的最大上传数');
}
重命名文件时别用原始 $_FILES['name'] 直接拼路径
原始文件名可能含 ../、空字节、控制字符或超长路径,直接拼接会导致目录穿越或写入失败。安全做法:
- 用
basename()去掉路径部分 - 用正则过滤掉非字母数字、下划线、短横线(
/[^a-zA-Z0-9_\-.]/) - 强制添加唯一前缀(如
uniqid() . '_' . $safe_name) - 目标目录必须是绝对路径,且 PHP 进程有写权限;不要用
./uploads/这类相对路径
错误示范:$dest = 'uploads/' . $_FILES['files']['name'][$i];
正确示范:
$ext = strtolower(pathinfo($file['name'], PATHINFO_EXTENSION));
$safe_name = preg_replace('/[^a-zA-Z0-9_\-.]/', '', basename($file['name']));
$new_name = uniqid('up_') . '.' . ($ext ?: 'bin');
$dest = '/var/www/uploads/' . $new_name;
上传完成后记得 chmod 644 $dest(如果需要 Web 可读但不可执行)。










