PHP cURL断点续传需客户端分块上传+服务端配合：切片文件、记录偏移、HEAD查已传长度、fseek定位读取、持久化状态；服务端须支持Content-Range、追加写入、返回206/200及正确响应头，并调大PHP和Nginx上传限制。
PHP cURL POST 大文件时如何支持断点续传
PHP 原生不支持 HTTP 断点续传（Range 协议）的自动恢复，必须手动控制分块上传 + 服务端配合。关键不是“模拟 POST”，而是把大文件切片、记录已传偏移、失败后从 Content-Range 指定位置继续发。
cURL 设置分块上传和 Range 头的必要参数
服务端必须支持 Content-Range 和返回 206 Partial Content 或自定义成功标识；PHP 端需禁用自动重定向、关闭 body 自动编码，并显式设置头：
-
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST')—— 避免 GET 覆盖 -
curl_setopt($ch, CURLOPT_POSTFIELDS, $chunk_data)—— 只传当前块，非整个文件 curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Range: bytes '.$start.'-'.$end.'/'.$total_size'])-
curl_setopt($ch, CURLOPT_HEADER, true)—— 方便读取响应头判断是否接受该块 -
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true)—— 必须开启，否则无法解析响应
如何检测上传中断并恢复（客户端逻辑）
不能依赖 cURL 的 CURLOPT_CONNECTTIMEOUT 或 CURLOPT_TIMEOUT 直接重试整文件——那样等于重头来。要靠状态持久化 + 块级校验：
- 每次上传前先发 HEAD 请求，查服务端已存长度（如接口返回
X-Uploaded-Bytes: 10485760） - 用
fopen($file, 'rb')+fseek($fp, $offset)定位读取，避免内存爆掉 - 上传失败后，把当前
$start写入临时文件（如/tmp/upload_state_abc123.json），含filename、offset、total_size - 恢复时读该文件，跳过已传部分，从
$offset开始下一块
服务端必须做的三件事（否则 PHP 客户端再努力也白搭）
断点续传是双向协议，服务端没配合，客户端所有 Range 头都无效：
立即学习“PHP免费学习笔记（深入）”；
- 接收时检查
HTTP_CONTENT_RANGE，提取bytes 1000-1999/10000000中的起止位置 - 以
FILE_APPEND | LOCK_EX方式写入目标文件，且写之前fseek($fp, $start) - 返回明确状态：上传完成时返回
200 OK+{"status":"success"}；中间块返回206或200+{"received":2000}
最容易被忽略的是：PHP 默认 post_max_size 和 upload_max_filesize 会拦截大 POST 体，即使你只传 1MB 块，也要确保这些值 ≥ 单块大小；Nginx 还要调 client_max_body_size。
