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 进程生命周期。
立即学习“PHP免费学习笔记（深入）”；
- 上传前调用
set_time_limit(0)避免超时中断 - 避免一次性读取整个文件到内存 ——
CURLFile是流式读取，只要不手动file_get_contents就没问题 - 生产环境建议限制并发数（比如最多 5 个 handle 同时跑），用
curl_multi_select控制轮询节奏，防 CPU 占满
CURLFile 实例的生命周期 —— 它不能复用，也不能在 curl_multi_exec 循环外提前销毁。一不留神就会上传空文件或 segfault。 
