php上传超2mb文件失败的根源在于post_max_size和max_execution_time等配置未同步调整，且需前后端协同实现分片上传与断点续传。
PHP 上传超 2MB 文件直接失败，upload_max_filesize 不是唯一拦路虎
PHP 默认限制上传大小（upload_max_filesize）只是表象，真正卡住大文件的往往是 post_max_size 和 max_execution_time。比如设了 upload_max_filesize = 100M，但 post_max_size = 8M，照样 500 或静默截断——因为整个 POST 请求体（含文件+表单字段）不能超这个值。
常见错误现象：$_FILES 为空、error = 1（UPLOAD_ERR_INI_SIZE）、Nginx 报 413 Request Entity Too Large（别只改 PHP 配置）。
-
post_max_size必须 ≥upload_max_filesize，建议留 10% 余量（如文件上限 200M，设post_max_size = 220M） -
max_execution_time和max_input_time都得调高，上传 1GB 文件，30 秒根本不够；用set_time_limit(0)临时禁用超时（仅限 CLI 或可信环境） - Nginx 需同步配
client_max_body_size，且要 reload，不是 restart；Apache 则检查LimitRequestBody
前端传大文件前必须分片，File.slice() 是基础但不够
不分片就传，等于把服务器当网盘客户端用：浏览器卡死、PHP 超时、内存爆掉。分片不是“切几块”就行，关键在服务端能按序合并、跳过已传片段、校验完整性。
使用场景：用户拖拽上传 >100MB 视频、CAD 模型、数据库备份包；需支持暂停/续传/网络中断恢复。
立即学习“PHP免费学习笔记（深入）”；
- 前端用
File.slice()分片，推荐每片 5–10MB（太小 HTTP 开销大，太大容错差），用blob.size和start/end精确控制 - 每次请求带唯一
file_id（如文件名+大小+mtime 的 hash）、当前分片序号chunk_index、总片数total_chunks，服务端靠这三者定位和校验 - 不要依赖
Content-Range头做分片管理——PHP 的$_SERVER['HTTP_CONTENT_RANGE']解析不稳定，自己传更可控
PHP 合并分片时用 fopen(..., 'ab') 追加写，别用 file_put_contents
用 file_put_contents($path, $data, FILE_APPEND) 看似简单，但并发上传同一文件时极易写乱：两个进程同时追加，数据交叉覆盖。真实生产必须用文件锁 + 原子追加。
性能影响：单次 fopen+fwrite+fclose 比 file_put_contents 略慢，但安全；合并完成后再用 sha1_file() 校验整文件，比边传边算 MD5 快得多。
- 先
fopen($temp_path, 'ab')，再flock($fp, LOCK_EX)加独占锁，写完flock($fp, LOCK_UN)，最后fclose - 分片接收后立刻存为独立临时文件（如
upload_abc123_005.tmp），合并阶段才按序读取并追加到目标文件，避免单点故障导致全盘重传 - 合并完成后删所有
.tmp片，但保留主文件；断点续传时，服务端查upload_abc123_*.tmp数量就能知道已传多少片
断点续传依赖客户端记录状态，PHP 本身不“记住”上次传到哪
PHP 是无状态的，$_SESSION 或数据库存进度只是辅助手段，真正可靠的断点信息必须由前端维护：上次成功上传的 chunk_index、file_id、时间戳。否则换浏览器、清缓存就归零。
容易踩的坑：把 file_id 设成随机 UUID——用户刷新页面后 ID 变了，服务端找不到旧分片；或者用文件名作 ID，但同名不同内容的文件会冲突。
- 前端生成
file_id应基于文件元数据：用File.name + File.size + File.lastModified拼接后取sha256，保证同一文件始终同 ID - 上传前先发个
GET /api/chunk-status?file_id=xxx，服务端返回已传成功的chunk_index数组，前端跳过这些片 - 服务端不要长期保存分片状态，超过 24 小时未完成的
.tmp文件应被定时清理脚本回收，否则磁盘悄悄爆掉
分片路径命名、临时文件清理时机、前后端 file_id 生成规则不一致——这三个地方出错，断点续传就变成“假装能续”。
