PHP批量上传文件模拟POST方法教程

一分耕耘，一分收获！既然都打开这篇《PHP模拟POST批量上传文件方法详解》，就坚持看下去，学下去吧！本文主要会给大家讲到等等知识点，如果大家对本文有好的建议或者看到有不足之处，非常欢迎大家积极提出！在后续文章我会继续更新文章相关的内容，希望对大家都有所帮助！

PHP 5.5+ 用 curl_multi_exec 批量上传文件必须为每个文件创建独立 CURLFile 实例，不可用 @ 路径；需手动管理 multi 句柄、设 CURLOPT_RETURNTRANSFER 获取响应；Content-Type 必须由 cURL 自动设置，禁止手动指定 boundary。

curl_multi_exec 上传多个文件时必须用 CURLFile

PHP 5.5+ 之后 curl_setopt 不再接受 @/path/to/file 这种写法，直接拼字符串会上传空内容或报错 failed to open stream: No such file or directory。必须显式构造 CURLFile 对象，否则文件内容根本不会进请求体。

• 错误写法：curl_setopt($ch, CURLOPT_POSTFIELDS, ['file' => '@/tmp/a.jpg'])
• 正确写法：curl_setopt($ch, CURLOPT_POSTFIELDS, ['file' => new CURLFile('/tmp/a.jpg', 'image/jpeg', 'a.jpg')])
• 批量上传多个文件：每个 file 字段名可相同（如 files[]），但每个值都得是独立的 CURLFile 实例

用 curl_multi_init 同时发多个 POST 文件请求要手动管理句柄

curl_multi_exec 本身不自动处理并发连接数限制、失败重试或响应解析，只是把多个 curl_init() 句柄塞进一个批处理池。你得自己循环调用 curl_multi_exec 直到返回 CURLM_OK，再用 curl_multi_info_read 拿结果。

• 别漏掉 curl_multi_add_handle —— 每个请求都要加进去，否则不会执行
• 别跳过 curl_multi_remove_handle —— 完成后必须移除并 curl_close，否则内存泄漏
• 响应体默认不返回，要设 curl_setopt($ch, CURLOPT_RETURNTRANSFER, true) 才能拿到 curl_multi_getcontent

POST 多文件时 Content-Type 必须由 cURL 自动设置 boundary

手动生成 multipart/form-data 的 Content-Type 头几乎必然出错 —— boundary 字符串必须和请求体里的一致，而 cURL 内部生成的 boundary 是随机且不可预测的。一旦手动设了 Content-Type，cURL 就不再自动生成 boundary，导致服务端解析失败，常见错误是 400 Bad Request 或只收到部分字段。

• 安全做法：完全不设 Content-Type 头，让 cURL 自己加
• 如果用了 curl_setopt($ch, CURLOPT_HTTPHEADER, [...])，确保里面没有 Content-Type
• 调试时可用 curl_setopt($ch, CURLOPT_VERBOSE, true) 查看实际发出的 header 和 body

大文件上传要注意超时和内存限制

单个大文件（比如 >10MB）在批量场景下容易触发 max_execution_time 或 memory_limit，尤其是用 curl_multi_exec 时，所有请求共享同一个 PHP 进程生命周期。

• 上传前调用 set_time_limit(0) 避免超时中断
• 避免一次性读取整个文件到内存 —— CURLFile 是流式读取，只要不手动 file_get_contents 就没问题
• 生产环境建议限制并发数（比如最多 5 个 handle 同时跑），用 curl_multi_select 控制轮询节奏，防 CPU 占满

实际批量上传逻辑中，最常被忽略的是 CURLFile 实例的生命周期 —— 它不能复用，也不能在 curl_multi_exec 循环外提前销毁。一不留神就会上传空文件或 segfault。

今天关于《PHP批量上传文件模拟POST方法教程》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！