PHP大文件分片上传与断点续传核心是前端切片+唯一标识，后端校验存在性、流式合并、完整性验证及超时清理；关键在边收边验、合并可控、失败可溯。
<p>PHP实现大文件分片上传与断点续传，核心在于：前端按固定大小切片、携带唯一标识（如文件hash + 分片序号），后端校验分片是否存在、合并前验证所有分片完整性，最后拼接并清理临时碎片。关键不是“存完再合并”，而是“边收边验、合并可控、失败可溯”。</p>
<H3>分片接收与临时存储</H3>
<p>每个分片以<font color="red">唯一文件标识（如file_id）+ 分片序号（chunk_index）</font>命名，存入独立临时目录（如<code>/uploads/chunks/{file_id}/</code>）。接收时需校验：</p>
<ul>
<li>必传参数：<code>file_id</code>（前端生成的全局唯一ID，建议用md5(文件名+时间戳+随机数)）、<code>chunk_index</code>、<code>total_chunks</code>、<code>chunk_hash</code>（可选，用于分片内容校验）</li>
<li>检查该分片是否已存在（避免重复写入或网络重发导致覆盖）</li>
<li>限制单个分片大小（如5MB），超出直接返回400；用<code>move_uploaded_file()</code>保存，禁用<code>$_FILES['file']['tmp_name']</code>直读（大文件可能被清空）</li>
<li>记录分片元信息到缓存（Redis）或数据库：<code>{file_id: {total: 10, uploaded: [0,2,3], status: 'uploading'}}</code></li>
</ul>
<H3>断点续传状态查询接口</H3>
<p>前端在上传前或中断后调用此接口，获取已上传的分片列表，决定从哪一片继续：</p>
<ul>
<li>接收<code>file_id</code>，扫描<code>/uploads/chunks/{file_id}/</code>目录下所有<code>*.part</code>文件</li>
<li>提取文件名中的序号，返回已存在的<code>uploaded_chunks</code>数组（如<code>[0,1,3,4]</code>）</li>
<li>同时返回<code>total_chunks</code>和<code>status</code>（uploading / merged / error），便于前端控制UI状态</li>
<li>加简单签名或token校验（防止恶意探测他人file_id）</li>
</ul>
<H3>分片合并与完整性校验</H3>
<p>所有分片接收完毕后，触发合并逻辑——但必须先校验，再合并：</p>
<ul>
<li>比对<code>uploaded_chunks</code>长度是否等于<code>total_chunks</code>；不等则返回<code>409 Conflict</code>，提示缺失分片</li>
<li>按序号升序读取每个<code>.part</code>文件，用<code>fopen(..., 'rb')</code> + <code>fread()</code>流式写入目标文件（避免内存溢出）</li>
<li>合并完成后，计算最终文件的<code>md5</code>或<code>sha256</code>，与前端传来的<code>file_hash</code>比对（该hash应在第一片上传时就提交）</li>
<li>校验通过则重命名为正式文件名（如<code>xxx.pdf</code>），并删除<code>/chunks/{file_id}/</code>整个目录；失败则标记<code>status=error</code>并保留日志</li>
</ul>
<H3>超时清理与并发安全</H3>
<p>分片上传可能长时间挂起，需主动清理无效碎片：</p>
<ul>
<li>为每个<code>file_id</code>设置Redis过期时间（如24小时），每次上传分片时<code>EXPIRE</code>刷新</li>
<li>后台定时任务（如每小时）扫描Redis中过期<code>file_id</code>，删除对应临时目录</li>
<li>合并操作加文件锁（<code>flock()</code>）或Redis分布式锁，防止多请求同时触发合并导致文件损坏</li>
<li>分片目录权限设为<code>0750</code>，Web用户可读写，但禁止Web直接访问（Nginx/Apache配置<code>location ^~ /uploads/chunks/ { return 403; }</code>）</li>
</ul>
