bigupload

大文件分片上传输入框插件。

适合视频文件、大体积压缩包、附件等场景，支持：

• 分片上传
• 上传进度显示
• 单文件 / 多文件
• 外部链接录入
• 断点续传（同一文件再次选择后继续未完成分片）

1. 安装与启用

1. 在后台应用管理中安装并启用 bigupload。
2. 如果当前应用已经提前安装过一次，建议在后台刷新一次应用缓存，确保输入框注册生效。
3. 在字段配置中把输入框类型切换为“大文件上传”。

2. 字段里怎么用

切换为“大文件上传”后，表单中会出现两个入口：

• 选择文件：本地大文件分片上传
• 添加外链：直接保存外部文件 URL，不会离线下载到本站

保存格式与原文件上传输入框一致：

• 单文件：保存 1 个 URL
• 多文件：使用分号 ; 连接多个 URL

3. 配置项说明

多文件

开启后允许连续上传多个文件。

目录

文件保存目录，默认：

/upload/(Y)(m)(d)/

常见变量：

• (Y)(m)(d) 按年月日分目录
• (userid) 按用户 ID 分目录

文件名

默认：

(rand).(ext)

常见写法：

• (rand).(ext) 随机文件名
• (filename).(ext) 原文件名
• (userid).(ext) 用户 ID 文件名

允许后缀

用分号或逗号分隔，例如：

mp4;mov;mkv;zip

留空时，沿用系统默认允许后缀。

单片大小(MB)

默认 2MB。

建议：

• 普通站点：2 到 5
• 网络较稳、文件很大：5 到 10

文件上限(MB)

默认 100MB。

• 设置为 100：插件层限制单文件最大 100MB
• 设置为 0：插件层不限制总文件大小

注意：设置为 0 不代表 PHP 自动无限制。 PHP 和 Web 服务器仍然必须允许“单个分片请求”通过。

4. PHP 推荐配置

如果使用默认 2MB 分片，建议至少这样配：

upload_max_filesize = 8M
post_max_size = 8M
max_execution_time = 300
max_input_time = 300
memory_limit = 128M

说明：

• upload_max_filesize 和 post_max_size 只需要大于单片大小，不需要按总文件大小设置
• memory_limit 不需要等于整个文件大小，因为这里是分片上传再落盘
• upload_tmp_dir 需要可写

5. Nginx 建议

如果前面还有 Nginx，建议同步确认：

client_max_body_size 8m;
fastcgi_read_timeout 300;

其中 client_max_body_size 也只需要大于单片大小。

6. 分片缓存在哪里

上传中的分片缓存保存在：

cache/bigupload/

每个上传会话一个目录，里面通常包括：

• meta.json 上传会话信息
• chunks/ 分片文件
• merged.tmp 合并中的临时文件

上传成功后，文件会移动到最终目录；未完成会话会自动清理过期缓存。

7. 使用建议

视频上传

推荐后缀示例：

mp4;mov;m4v;webm;mkv;avi

大附件上传

推荐后缀示例：

zip;rar;7z;pdf;doc;docx;xls;xlsx

想上传更大的文件

优先按下面顺序检查：

1. 字段里的“文件上限(MB)”
2. “单片大小(MB)”是否过大
3. PHP 的 upload_max_filesize、post_max_size
4. Nginx 的 client_max_body_size
5. 磁盘空间和上传临时目录权限 大文件上传 [bigupload]