0

0

在jQuery File Upload中实现可靠的文件MIME类型检查

心靈之曲

心靈之曲

发布时间:2025-09-27 15:11:01

|

257人浏览过

|

来源于php中文网

原创

在jquery file upload中实现可靠的文件mime类型检查

本文探讨了在blueimp jQuery File Upload插件中,如何通过读取文件头部字节(magic number)实现比简单检查文件扩展名或file.type更可靠的MIME类型验证。文章详细介绍了将此验证逻辑集成到fileupload插件的add回调函数中,以确保在文件上传前进行有效检查,从而防止恶意用户通过修改文件扩展名绕过客户端验证。

1. 文件MIME类型验证的挑战与必要性

在Web应用中,文件上传功能通常需要对上传文件的类型进行限制,以确保安全性、数据完整性和用户体验。常见的客户端验证方法包括检查文件扩展名(如.jpg、.pdf)或利用浏览器提供的File对象中的type属性(如image/jpeg)。然而,这些方法都存在局限性:

  • 文件扩展名易于篡改: 用户可以轻易地将一个恶意脚本文件重命名为.jpg,从而绕过基于扩展名的检查。
  • file.type属性不可靠: 浏览器的file.type属性通常根据文件扩展名或操作系统注册的MIME类型来推断,同样容易受到欺骗。

为了实现更健壮的客户端MIME类型验证,我们需要深入到文件的实际内容,检查其“魔术数字”(Magic Number)或文件头签名。这些是文件开头的特定字节序列,不同类型的文件有其独特的签名,即使文件扩展名被修改,其内部的魔术数字通常保持不变。

2. 利用文件头签名进行MIME类型验证

文件头签名(Magic Number)是识别文件真实类型的一种可靠方法。例如:

  • PNG: 89504e47
  • GIF: 47494638
  • JPEG: ffd8ffe0, ffd8ffe1, ffd8ffe2 (通常后跟其他字节,但前四字节足以识别)
  • PDF: 25504446

通过FileReader API读取文件的开头几个字节,并将其转换为十六进制字符串,然后与已知的文件头签名进行比对,即可判断文件的真实MIME类型。

3. 在blueimp jQuery File Upload中集成MIME类型验证

blueimp jQuery File Upload是一个功能强大的文件上传插件,它提供了丰富的回调函数,允许开发者在上传过程的不同阶段插入自定义逻辑。add回调函数是进行客户端文件验证的理想位置,因为它在文件被添加到上传队列时触发,且在实际上传请求发送之前。

绘蛙
绘蛙

电商场景的AI创作平台,无需高薪聘请商拍和文案团队,使用绘蛙即可低成本、批量创作优质的商拍图、种草文案

下载

3.1 HTML结构

首先,确保你的HTML包含正确的文件输入元素和blueimp jQuery File Upload插件所需的结构:

浏览文件

这里,id="myfiles"是实际的文件输入框,而id="myfile_mydrive"是fileupload插件的容器。

3.2 JavaScript实现

以下代码演示了如何将文件头签名验证逻辑集成到blueimp jQuery File Upload的add回调函数中:

$(function () {
    'use strict';

    $('#myfile_mydrive').fileupload({
        // add回调函数在文件被添加到上传队列时触发
        add: function(e, data) {
            var file = data.files[0]; // 获取当前文件
            if (!file) { // 检查文件是否存在
                alert("请选择一个文件。");
                return;
            }

            var fileReader = new FileReader();

            fileReader.onload = function(e) {
                // 读取文件的前4个字节
                var arr = new Uint8Array(e.target.result).subarray(0, 4);
                var header = "";
                for (var i = 0; i < arr.length; i++) {
                    // 将字节转换为十六进制字符串,并确保两位表示
                    header += arr[i].toString(16).padStart(2, '0');
                }

                // 定义允许的文件类型及其对应的魔术数字
                const allowedHeaders = [
                    '89504e47', // PNG
                    '47494638', // GIF
                    'ffd8ffe0', // JPEG (常见的多种变体之一)
                    'ffd8ffe1', // JPEG
                    'ffd8ffe2', // JPEG
                    '25504446'  // PDF
                ];

                // 检查文件头是否匹配允许的类型
                if (allowedHeaders.includes(header)) {
                    // 如果文件类型匹配,则继续上传
                    data.submit();
                } else {
                    // 如果文件类型不匹配,则阻止上传并提示用户
                    alert("文件类型不匹配或不支持,请上传图片(PNG/GIF/JPEG)或PDF文件。");
                    // 可以选择清空文件输入,防止用户尝试再次上传
                    $(e.target).val(''); 
                    return;
                }
            };

            // 以ArrayBuffer形式读取文件内容,用于获取原始字节
            fileReader.readAsArrayBuffer(file);
        },
        // 下载模板ID
        downloadTemplateId: 'template-download-gallery',
        // 上传模板ID
        uploadTemplateId: 'template-upload-gallery',
        // 服务器端接收文件数组的参数名
        paramName: 'files[]',
        // 上传处理脚本的URL
        url: 'mydrive-upload.php',
        // 期望的响应数据类型
        dataType: 'json',
        // 禁用自动上传,以便在add回调中手动控制
        autoUpload: false, 
        // 最大允许上传文件数量
        maxNumberOfFiles: 10,
        // 客户端接受的文件类型正则,作为初步过滤(但不可靠)
        acceptFileTypes: /(\.|\/)(pdf|gif|jpe?g|png)$/i,
    });
});

3.3 代码解析与关键点

  1. add回调函数:
    • 这是整个解决方案的核心。当用户选择文件时,fileupload插件会触发此回调。
    • data.files[0]获取到当前选中的文件对象。
  2. FileReader API:
    • new FileReader()创建一个文件读取器实例。
    • fileReader.onload事件在文件读取完成后触发,此时e.target.result包含了读取到的文件内容。
    • fileReader.readAsArrayBuffer(file)指示FileReader以ArrayBuffer的形式读取文件内容。ArrayBuffer是用于表示通用、固定长度的原始二进制数据缓冲区的对象。
  3. 提取文件头:
    • new Uint8Array(e.target.result)将ArrayBuffer转换为Uint8Array,这是一个8位无符号整数数组,方便逐字节访问。
    • .subarray(0, 4)提取数组的前4个字节,这些就是我们关注的魔术数字。
    • 循环将每个字节转换为两位十六进制字符串(toString(16).padStart(2, '0')),并拼接起来形成完整的头部签名字符串。
  4. MIME类型匹配:
    • allowedHeaders数组包含了所有允许的文件类型的魔术数字。
    • allowedHeaders.includes(header)检查当前文件的头部签名是否在允许列表中。
  5. 控制上传流程:
    • 如果匹配成功,调用data.submit()手动触发文件上传。
    • 如果匹配失败,弹出警告,并通过return阻止data.submit()的执行,从而取消本次上传。
    • $(e.target).val('') 可以用于清空文件输入框,防止用户在提示后再次尝试上传相同的文件。
  6. autoUpload: false:
    • 这是一个关键设置。将其设置为false可以禁用fileupload插件的自动上传功能。这样,我们就可以在add回调中手动控制何时调用data.submit(),从而在验证通过后才开始上传。
  7. acceptFileTypes:
    • 尽管我们进行了更严格的头部验证,但acceptFileTypes正则表达式仍然有用。它可以在浏览器层面提供初步的过滤,改善用户体验,但不能作为唯一的安全措施。

4. 注意事项与总结

  • 客户端验证并非万能: 尽管文件头签名验证比简单的扩展名或file.type检查更可靠,但它仍然是客户端验证。恶意用户总有可能绕过客户端脚本。因此,服务器端的文件MIME类型验证是必不可少的,且应作为最终的安全防线。
  • 扩展支持的MIME类型: 如果需要支持更多文件类型,只需查找相应文件类型的魔术数字,并将其添加到allowedHeaders数组中。
  • 错误处理: 在实际应用中,FileReader的onerror事件也应该被考虑,以处理文件读取过程中可能出现的错误。
  • 用户体验: 除了alert提示,可以考虑使用更友好的UI提示方式,例如在页面上显示错误消息。

通过将文件头签名验证逻辑集成到blueimp jQuery File Upload的add回调函数中,我们能够实现一个更健壮、更难以被绕过的客户端文件类型验证机制,显著提升了文件上传功能的安全性和可靠性。

相关专题

更多
js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

558

2023.06.20

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

416

2023.07.04

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

756

2023.07.04

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

479

2023.09.01

JavaScript转义字符
JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

514

2023.09.04

js生成随机数的方法
js生成随机数的方法

js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

1091

2023.09.04

如何启用JavaScript
如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

659

2023.09.12

Js中Symbol类详解
Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

554

2023.09.20

c++ 根号
c++ 根号

本专题整合了c++根号相关教程,阅读专题下面的文章了解更多详细内容。

25

2026.01.23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 9.3万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 10.5万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号