如何用jQuery实现多PDF上传并配合PHP存储至SQL数据库
多PDF上传适配实现方案(对齐原图片上传交互体验)
常见失效根因
出现“新增PDF支持后仅能单文件上传”的问题,基本都是三类配置遗漏导致的:
- 前端文件选择控件的类型过滤规则未适配PDF,部分浏览器在
accept仍保留纯图片类型时,会对PDF文件启用单选逻辑,无法跨目录批量多选 - 原有JS的文件池逻辑写死了图片类型分支,遇到PDF文件时直接中断累加流程,没有把选中的PDF纳入已选文件列表
- 文件上传表单的配置项被误改,导致批量文件传递的通道失效
前端层适配步骤(完全对齐原图片交互)
调整文件选择input配置:
保留原生的multiple多选属性,把accept参数从仅图片类型扩展为accept="image/jpeg,image/png,image/gif,application/pdf,.pdf",同时补充后缀规则兼容不同浏览器的类型识别逻辑重构JS文件处理逻辑:
- 维护全局持久的已选文件数组,不再每次选文件就清空替换原有列表,实现逐次选择、跨文件夹累加的效果
- 把
application/pdf加入类型白名单,完全复用原图片的校验规则:单文件体积不超过300KB、累计文件总数不超过10个 - 每次选择文件完成后,清空input的value值,避免选择同目录同类型文件时无法触发回调
- 对PDF文件单独做预览渲染,用通用PDF图标代替图片缩略图,不影响原有的列表交互
核心逻辑参考代码:
// 全局已选文件池 let selectedFileList = []; const ALLOWED_TYPES = ['image/jpeg', 'image/png', 'image/gif', 'application/pdf']; const MAX_SINGLE_SIZE = 300 * 1024; // 300KB const MAX_TOTAL_COUNT = 10; function onFileSelect(e) { // 合并本次选择的文件到全局列表 const currentFiles = Array.from(e.target.files); selectedFileList = [...selectedFileList, ...currentFiles]; // 过滤不合法文件 selectedFileList = selectedFileList.filter(file => { const isTypeValid = ALLOWED_TYPES.includes(file.type); const isSizeValid = file.size <= MAX_SINGLE_SIZE; return isTypeValid && isSizeValid; }); // 超出数量上限截断 if (selectedFileList.length > MAX_TOTAL_COUNT) { selectedFileList = selectedFileList.slice(0, MAX_TOTAL_COUNT); alert(`最多可上传${MAX_TOTAL_COUNT}个文件`); } // 清空input值,解决重复选文件不触发的问题 e.target.value = ''; // 调用原有列表渲染方法刷新展示 renderFileList(selectedFileList); }
后端PHP接收与SQL存储实现
首先确保表单配置正确:给上传表单加
enctype="multipart/form-data"属性,文件上传字段的name设置为数组格式(如name="upload_files[]"),保证PHP能一次性接收所有选中的文件后端做二次校验(避免前端校验被绕过):
- 遍历上传的临时文件列表,用
finfo扩展读取每个文件的真实MIME值,不要仅依赖前端传递的类型参数判断,防止恶意改后缀的文件绕过校验 - 重复校验单文件大小不超过300KB,不符合规则的文件直接拦截
- 遍历上传的临时文件列表,用
数据库存储可根据业务场景选择两种方案:
- 通用方案(推荐):文件本身存储在服务器的独立可访问目录,数据库仅存储文件的元信息(原始文件名、存储路径、文件类型、大小、上传时间),避免大体积文件拉低数据库查询效率
- 轻量方案:在单文件最大300KB的限制下,可将PDF文件的二进制内容转base64后,存为数据库的
longtext/blob字段,适合访问频率低、不想额外管理服务器文件目录的场景
核心接收逻辑参考代码:
$allowedExtMap = [ 'image/jpeg' => 'jpg', 'image/png' => 'png', 'image/gif' => 'gif', 'application/pdf' => 'pdf' ]; $maxSize = 300 * 1024; $uploadRoot = './public/uploads/'; foreach ($_FILES['upload_files']['tmp_name'] as $index => $tmpPath) { if (!is_uploaded_file($tmpPath)) continue; // 读取真实MIME类型 $finfo = new Finfo(FILEINFO_MIME_TYPE); $realMime = $finfo->file($tmpPath); if (!isset($allowedExtMap[$realMime])) continue; // 校验文件大小 if ($_FILES['upload_files']['size'][$index] > $maxSize) continue; // 生成唯一文件名避免重名覆盖 $ext = $allowedExtMap[$realMime]; $saveName = uniqid('file_', true) . '.' . $ext; // 移动文件到存储目录 move_uploaded_file($tmpPath, $uploadRoot . $saveName); // 对接SQL连接,将文件元信息写入数据库表即可 }
注意:如果上传文件时被PHP默认配置拦截,需要同步调整
upload_max_filesize、post_max_size两个php.ini配置项,匹配300KB单文件、10个文件的总容量限制。
内容的提问来源于stack exchange,提问作者Jack
相关产品推荐
相关产品推荐

