安全的文件上传处理
大小限制、扩展名白名单、真实 MIME 校验、随机文件名、图片二次压缩,五道关卡写成可直接调用的函数。
更新于 2026-11-1747 行代码
完整代码
PHP
<?php
function upload_image(array $file, string $dir, int $maxBytes = 2097152): array
{
$allow = [
'jpg' => 'image/jpeg',
'jpeg' => 'image/jpeg',
'png' => 'image/png',
'webp' => 'image/webp',
];
if (($file['error'] ?? UPLOAD_ERR_NO_FILE) !== UPLOAD_ERR_OK) {
return [false, '上传失败,错误码 ' . $file['error']];
}
if ($file['size'] > $maxBytes) {
return [false, '文件超过 ' . round($maxBytes / 1048576, 1) . 'MB'];
}
$ext = strtolower(pathinfo($file['name'], PATHINFO_EXTENSION));
if (!isset($allow[$ext])) {
return [false, '只支持 jpg、png、webp'];
}
$finfo = new finfo(FILEINFO_MIME_TYPE);
if ($finfo->file($file['tmp_name']) !== $allow[$ext]) {
return [false, '文件内容与扩展名不符'];
}
$info = @getimagesize($file['tmp_name']);
if ($info === false || $info[0] > 6000 || $info[1] > 6000) {
return [false, '图片尺寸不合法'];
}
if (!is_dir($dir) && !mkdir($dir, 0755, true)) {
return [false, '无法创建目录'];
}
$name = date('Ym') . '/' . bin2hex(random_bytes(8)) . '.' . ($ext === 'jpeg' ? 'jpg' : $ext);
$dest = rtrim($dir, '/') . '/' . $name;
if (!is_dir(dirname($dest))) {
mkdir(dirname($dest), 0755, true);
}
if (!move_uploaded_file($file['tmp_name'], $dest)) {
return [false, '保存失败'];
}
return [true, $name];
}
怎么用
- 表单要带 enctype="multipart/form-data",字段名与 $_FILES 的键一致。
- 调用 [$ok, $msg] = upload_image($_FILES['pic'], __DIR__ . '/uploads');
- 成功时 $msg 是相对路径,入库或拼接 URL 都可以。
- 把 uploads 目录配成不可执行 PHP,并限制上传大小。
注意
- getimagesize 只能挡住「不是图片」的情况,不能替代 MIME 校验。
- 更彻底的做法是用 GD 读出来重新保存,能去掉 EXIF 里的隐藏内容。
- 目录按年月分,单目录文件数控制在几万以内,否则 scandir 会变慢。