WPillar.FileManager 1.0.0

Pillar.FileManager

Pillar.FileManager 是一个功能强大的 .NET 文件管理库，提供了文件上传、下载、分片上传、断点续传等功能，适用于需要处理大文件和提供可靠文件存储的应用程序。

特性

• 基本文件操作：上传、下载、删除文件
• 大文件处理：支持分片上传和断点续传
• 安全性：支持文件加密和解密
• 性能优化：支持文件压缩和解压缩
• 文件验证：支持文件类型验证和大小限制
• 灵活存储：支持自定义存储目录和日期格式化路径
• 元数据管理：提供完整的文件元数据

安装

通过 NuGet 包管理器安装：

dotnet add package Pillar.FileManager

快速开始

配置服务

在 Startup.cs 或 Program.cs 中配置服务：

services.AddFileManager(options =>
{
    options.StorageRoot = "uploads";                // 存储根目录
    options.MaxFileSize = 1024 * 1024 * 100;        // 最大文件大小 (100MB)
    options.AllowedExtensions = new[] { ".jpg", ".png", ".pdf" }; // 允许的文件类型
    options.ComputeHash = true;                     // 计算文件哈希值
    options.EnableCompression = false;              // 是否启用压缩
    options.EnableEncryption = false;               // 是否启用加密
    options.EncryptionPassword = "your-secret-key"; // 加密密钥
});

使用本地存储

简化的本地存储配置：

services.AddFileManagerWithLocalStorage(
    storageRoot: "uploads",
    maxFileSize: 100 * 1024 * 1024,  // 100MB
    allowedExtensions: new[] { ".jpg", ".png", ".pdf" }
);

自定义上传进度缓存

您可以通过实现 IUploadProgressCache 接口来自定义上传进度缓存：

一：创建自定义缓存并使用专用扩展方法

// 自定义 Redis 缓存实现
public class RedisUploadProgressCache : IUploadProgressCache
{
    
}

二：替换默认缓存实现

// 首先添加基本的文件管理服务
services.AddFileManager(options => 
{
    options.StorageRoot = "uploads";
});

// 然后注册自定义缓存实现，替换默认实现
services.AddSingleton<IUploadProgressCache, RedisUploadProgressCache>();

自定义存储路径

// 上传到按日期组织的目录
var result = await _fileStorage.SaveAsync(stream, "uploads/{yyyy}/{MM}/{dd}", file.FileName);

静态文件服务配置

基本配置

// 方式1：默认使用 wwwroot
app.UseStaticFiles();

// 方式2：添加额外的静态文件目录
app.UseStaticFiles(new StaticFileOptions
{
    FileProvider = new PhysicalFileProvider(
        Path.Combine(builder.Environment.ContentRootPath, "MyFiles")),
    RequestPath = "/files"
});

// 方式3：指定多个目录
app.UseStaticFiles(new StaticFileOptions
{
    FileProvider = new CompositeFileProvider(
        new PhysicalFileProvider(Path.Combine(builder.Environment.WebRootPath, "uploads")),
        new PhysicalFileProvider(Path.Combine(builder.Environment.ContentRootPath, "MyFiles"))
    )
});

防盗链配置

app.UseStaticFiles(new StaticFileOptions
{
    OnPrepareResponse = ctx =>
    {
        // 检查 Referer
        var referer = ctx.Context.Request.Headers.Referer.ToString();
        if (string.IsNullOrEmpty(referer) || !referer.StartsWith("http://localhost:5006"))
        {
            ctx.Context.Response.StatusCode = 403;
            ctx.Context.Response.Body = Stream.Null;
        }
    }
});

身份认证配置

app.UseStaticFiles(new StaticFileOptions
{
    OnPrepareResponse = ctx =>
    {
        // 检查认证状态
        if (!ctx.Context.User.Identity?.IsAuthenticated ?? true)
        {
            ctx.Context.Response.StatusCode = 401;
            ctx.Context.Response.Body = Stream.Null;
        }
    }
});

高级用法

分片上传

分片上传支持大文件上传和断点续传：

// 获取分片上传信息
var chunkInfo = new ChunkFileInfo
{
    FileName = "大文件.zip",
    ChunkSize = 1024 * 1024, // 1MB 分片大小
    TotalSize = fileStream.Length,
    FileMd5 = "文件MD5值"
};

// 上传分片
await _fileProcessor.UploadChunkAsync(chunkIndex, chunkStream, chunkInfo);

// 合并分片
var result = await _fileProcessor.MergeChunksAsync(chunkInfo);

许可证

MIT