如何向FormData追加Blob时避免隐式生成文件名以适配PHP后端
FormData追加Blob时规避隐式文件名的实现方案
底层逻辑说明
浏览器执行formData.append()追加Blob类型值时的序列化规则,是完全按照W3C标准写死的:
- 省略第三个参数时,浏览器会自动为Blob生成默认的
filename="blob",写入请求段的Content-Disposition头 - 传入任意非空值作为第三个参数时,浏览器会把这个值转成字符串,作为自定义文件名写入
Content-Disposition - 传入
null/undefined等空值时,浏览器会强制将这些值转成字符串,最终生成filename="null"这类无效文件名
只要multipart请求段中带了filename属性(无论属性值是什么),PHP的multipart解析器就会判定这是文件上传字段,自动将二进制内容保存为临时文件,映射到$_FILES数组;只有完全不携带filename属性的multipart段,才会被识别为普通表单字段,将内容映射到$_POST数组。
注意:不要尝试传入空字符串作为第三个参数,这种方式生成的
filename=""字段依然会被PHP识别为文件上传,完全达不到预期效果。FormData对象的内置实现没有提供任何配置项,可以让追加Blob时完全省略filename字段。
可行实现方案
完全跳过FormData的自动序列化逻辑,手动按照multipart规范拼装请求体,全程控制请求段的头信息:
- 自定义生成multipart分隔符,避免和内容本身的字符冲突
- 拼装每个表单字段的请求段,对于Blob对应的字段,在
Content-Disposition头中只写name属性,完全不添加filename字段 - 将所有段和Blob内容合并为完整的请求体,发送时设置匹配的
Content-Type头
示例代码:
// 生成分隔符 const boundary = `----formDataBoundary${Date.now()}`; // 按顺序拼装所有请求段 const requestParts = [ // 普通文本字段,写法和标准FormData一致 `--${boundary}\r\nContent-Disposition: form-data; name="field_name"\r\n\r\nfield_value\r\n`, // Blob对应的字段,完全不写filename属性 `--${boundary}\r\nContent-Disposition: form-data; name="binary_data"\r\nContent-Type: application/octet-stream\r\n\r\n`, blobObj, `\r\n--${boundary}--\r\n` ]; // 生成最终请求体 const requestBody = new Blob(requestParts, { type: `multipart/form-data; boundary=${boundary}` }); // 发送请求 fetch('/api/endpoint', { method: 'POST', headers: { 'Content-Type': requestBody.type }, body: requestBody });
这种方式发送的请求,对应的Blob段完全不带filename属性,PHP后端会自动将这部分的二进制内容解析到$_POST['binary_data']中,不会触发临时文件保存逻辑,也不会生成对应的$_FILES条目。
内容的提问来源于stack exchange,提问作者張俊芝
相关产品推荐
相关产品推荐

