如何通过ThinkPHP结合分布式存储和分片上传优化文件上传效率？

本文共计1185个文字，预计阅读时间需要5分钟。

由于默认使用的PHP配置中，全局变量+$FILES+读取完整文件到内存或临时目录，大文件（>50MB）或多用户同时上传时，可能会触发PHP的+upload_max_filesize+、+post_max_size+限制，还可能耗尽+memory_limit+。ThinkPHP的+File::moveTo()+是同步阻塞操作，没有分片、没有走流式处理，一次请求就是一个完整的生命周期。

常见错误现象：413 Request Entity Too Large、502 Bad Gateway（Nginx 超时）、PHP Warning: POST Content-Length exceeds...。

• 别直接改 php.ini 把 upload_max_filesize 拉到 2G——治标不治本，反而放大单点压力
• 不要在控制器里写 $file->validate(['size'=>20971520])->move(...) 处理 1GB 视频——PHP 进程会挂住十几秒
• 注意 ThinkPHP 版本：v6.0+ 支持 think\File 的 getStream()，v5.1 需手动封装流读取

怎么用 WebUploader 或 Uppy 做前端分片上传

核心是把一个大文件切成固定大小的块（如 5MB/片），每片独立发请求，后端只收片、存片、校验 MD5，最后合并。ThinkPHP 不内置分片逻辑，得自己接。

使用场景：用户上传 >100MB 视频、CAD 文件、数据库备份包；需要断点续传或进度反馈。