Skip to content

v1.4.0

Choose a tag to compare

View all tags
@Tinywan Tinywan released this 23 Aug 14:22
· 2 commits to main since this release
v1.4.0
dbfd88a

云端适配器支持大文件分片上传（新功能）。

✨ 新特性

  • 阿里云 OSS / 腾讯云 COS / AWS S3：厂商原生 Multipart Upload
    • 首片自动 initiate，逐片 uploadPart；uploadId 与各分片 ETag 持久化于 {chunk_path}/{file_id}/session.json，跨请求断点续传
    • 合并时 complete 后 copy 改名为最终对象并删除临时键
  • 七牛云：分片本地暂存，合并后经 putFile 上传（SDK 内部自动断点续传）
  • mergeChunk 新增选项：file_hash（整文件散列作为最终对象名，未传时用 file_id）、mime_type（云端无法探测 MIME，默认 application/octet-stream）
  • 调用方式与本地一致：Storage::disk('oss', false)->uploadChunk(...) / chunkProgress(...) / mergeChunk(...)
  • 公共分片能力（校验、暂存、锁、会话读写）下沉至 AdapterAbstract，能力矩阵云端分片全部置 ✅

📚 文档与示例

  • README 新增「大文件分片上传（云端）」章节：会话状态、命名策略、厂商分片下限、abort/清理说明
  • example/ 示例支持 disk 参数切换本地与云端（v1.4.1）

⚠️ 注意

  • 厂商非末尾分片下限：S3 ≥ 5MB、COS ≥ 1MB、OSS ≥ 100KB；默认 chunk_size 5MB 满足全部厂商
  • 未完成的云端 Multipart 会话会长期占用存储桶，需业务侧 abort 或配置生命周期清理规则

Full Changelog: v1.3.2...v1.4.0

Assets 2
Loading