PHP用cURL发分块传输POST请求需设CURLOPT_UPLOAD=true、禁用Expect头、配合CURLOPT_READFUNCTION回调返回数据块,cURL自动封装chunk格式;返回0表示结束,不可设Content-Length。

PHP用cURL发分块传输POST请求的关键配置
PHP默认的curl_setopt()不会启用HTTP分块传输编码(chunked transfer encoding),即使你没设Content-Length,只要没显式关闭Expect: 100-continue或没手动拼接chunk格式,服务端收到的仍是普通POST。真要模拟“边生成边发送”的流式分块,得靠CURLOPT_READFUNCTION配合手动控制数据流。
- 必须禁用
Expect头:curl_setopt($ch, CURLOPT_HTTPHEADER, ['Expect:']),否则cURL可能卡在100-continue等待 - 不能设
Content-Length,否则会覆盖分块机制 - 启用
CURLOPT_UPLOAD(设为true),告诉cURL你要上传数据,而非GET -
CURLOPT_READFUNCTION回调里每次返回一段数据(如4096字节),返回0表示结束;返回0以外的负数会中止请求
用CURLOPT_READFUNCTION实现动态分块发送
这个回调函数是核心。它在cURL需要数据时被反复调用,每次返回一块内容,cURL自动加上chunk-size\r\ndata\r\n封装。你不需要手写十六进制长度或0\r\n\r\n结尾——cURL底层全包了。
$ch = curl_init('https://httpbin.org/post');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_UPLOAD, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Expect:']);
curl_setopt($ch, CURLOPT_READFUNCTION, function($ch, $fd, $length) {
static $data = null;
if ($data === null) {
$data = str_repeat('x', 1024 * 1024); // 模拟1MB数据源
}
$chunk = substr($data, 0, $length);
$data = substr($data, $length);
return strlen($chunk) ? $chunk : 0; // 返回0表示EOF
});
curl_exec($ch);
注意:如果数据源是文件,直接用fread($fd, $length)更稳妥;回调里别做耗时操作,否则阻塞cURL传输节奏。
常见失败现象和排查点
看到Empty reply from server或连接被重置,大概率是分块逻辑没对上。服务端对不规范的chunk很敏感。
立即学习“PHP免费学习笔记(深入)”;
- 回调返回空字符串(
'')而不是0:cURL继续调用,可能无限循环或发空chunk - 忘了关
Expect头:cURL发完POST / HTTP/1.1就停住,等HTTP/1.1 100 Continue,但有些服务端不回这个 - 同时设了
Content-Length和CURLOPT_READFUNCTION:cURL会忽略读函数,退化成普通POST - 用
file_get_contents()一次性读大文件再传,根本不是分块——只是“大POST”,内存爆掉前就挂了
替代方案:不用cURL也能“伪分块”
如果你只是想避免内存占用,又不强求标准HTTP分块,可以用fsockopen()手写HTTP/1.1请求头+逐段fwrite()。但要注意:
- 必须自己算每段十六进制长度、加
\r\n、结尾写0\r\n\r\n - 要处理TCP连接、SSL握手、响应读取——复杂度陡增
- 多数现代API(如S3、Webhook)只认标准cURL分块行为,手写容易被拒
真正需要分块的场景其实不多:上传超大日志流、实时传感器数据推送、或对接强制要求Transfer-Encoding: chunked的老系统。其他情况,用multipart/form-data分片上传更稳。











