PHP实现POST断点续传技巧解析

本文深入解析了PHP实现大文件POST断点续传的核心机制与完整实践方案，强调这并非简单的“模拟POST”，而是一套需客户端分块控制、状态持久化与服务端深度协同的双向协议：客户端通过cURL手动切片、定位读取、发送Content-Range头并智能恢复；服务端则必须支持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 头都无效：

• 接收时检查 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。

好了，本文到此结束，带大家了解了《PHP实现POST断点续传技巧解析》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！