写给愿意动手的 PHP 开发者
PHP学习网 PHP学习网
公告PHP学习网为公益性网站,致力于为广大PHP爱好者服务
首页/ PHP 源码/ 安全的文件上传处理
安全相关 通用 PHP 7.4+

安全的文件上传处理

大小限制、扩展名白名单、真实 MIME 校验、随机文件名、图片二次压缩,五道关卡写成可直接调用的函数。

完整代码

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];
}

怎么用

  1. 表单要带 enctype="multipart/form-data",字段名与 $_FILES 的键一致。
  2. 调用 [$ok, $msg] = upload_image($_FILES['pic'], __DIR__ . '/uploads');
  3. 成功时 $msg 是相对路径,入库或拼接 URL 都可以。
  4. 把 uploads 目录配成不可执行 PHP,并限制上传大小。

注意

  • getimagesize 只能挡住「不是图片」的情况,不能替代 MIME 校验。
  • 更彻底的做法是用 GD 读出来重新保存,能去掉 EXIF 里的隐藏内容。
  • 目录按年月分,单目录文件数控制在几万以内,否则 scandir 会变慢。

相关源码