Laravel如何实现文件的上传、存储和下载

答案：Laravel通过Flysystem实现文件上传、存储与下载。配置public磁盘并创建软链接后，使用store()处理上传，生成唯一文件名并按目录组织；通过Storage::url()获取访问路径；下载时用Storage::disk('public')->download()返回文件，私有文件需权限校验后再输出，确保安全性和用户体验。

Laravel 提供了强大且简洁的文件系统支持，借助其封装良好的 Filesystem 组件（基于 Flysystem），可以轻松实现文件的上传、存储和下载功能。下面以实际场景为例，说明如何在 Laravel 中完成这些操作。

1. 配置文件系统

确保 public 磁盘已正确配置：

'public' => [
    'driver' => 'local',
    'root' => storage_path('app/public'),
    'url' => env('APP_URL').'/storage',
    'visibility' => 'public',
],

然后运行命令创建软链接，使 storage 文件可被 Web 访问：

php artisan storage:link

2. 实现文件上传

    @csrf
    
    上传

在控制器中处理上传：

天意集团企业网站管理系统4.0

v4.0最新修正: 美化后台登陆页面，完善下载的管理和合理性； 增加资料下载，满足一般企业的资料下载要求，完善修正； 增加购买合同下载； 完善发布文章不分行； 完善前后台登陆系统安全性； 修正所有发现的小错误； 增加统计系统； 美化页面； 后台主要功能如下： 一、系统管理：管理员管理，可以新增管理员及修改管理员密码；数据库备份，为保证您的数据安全本系统采用了数据库备份功能；上传文件管理，管理你增加

下载

use Illuminate\Http\Request;
use Illuminate\Support\Facades\Storage;

public function upload(Request $request)
{
    $request->validate([
        'file' => 'required|file|max:2048', // 最大 2MB
    ]);

    if ($request->hasFile('file') && $request->file('file')->isValid()) {
        
        // 存储到 public 磁盘，并生成唯一文件名
        $path = $request->file('file')->store('uploads', 'public');

        // 获取可访问的 URL
        $url = Storage::url($path);

        return response()->json([
            'message' => '上传成功',
            'path' => $path,
            'url' => $url
        ]);
    }

    return response()->json(['error' => '上传失败'], 400);
}

3. 文件存储建议

• 使用 store() 方法自动生成唯一文件名，避免覆盖
• 按日期或用户 ID 分目录存储，如：uploads/2025/04/user1.jpg
• 对敏感文件使用 private 磁盘，禁止直接 URL 访问
• 验证文件类型，防止恶意上传（如使用 mimes:jpg,png,pdf）

4. 实现文件下载

示例：通过路径下载文件

public function download($filename)
{
    $path = 'uploads/' . $filename;

    if (Storage::disk('public')->exists($path)) {
        return Storage::disk('public')->download($path, '自定义名称.pdf');
    }

    return abort(404);
}

如果只是预览（浏览器打开），使用 response()：

return response()->file(Storage::disk('public')->path($path));

对于私有存储的文件，可在控制器中控制权限后再输出：

if ($user->canAccessFile($filename)) {
    return Storage::disk('private')->download($path);
}