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

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

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

1. 配置文件系统

Laravel 的文件配置位于 config/filesystems.php。默认支持多种驱动：local（本地）、public、s3 等。常用的是 public 和 storage 目录。

确保 public 磁盘已正确配置：

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

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

php artisan storage:link

2. 实现文件上传

假设前端表单包含一个名为 file 的上传字段：

    @csrf
    
    上传

在控制器中处理上传：

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);
}

基本上就这些。Laravel 的文件系统设计清晰，配合验证和路由设置，能快速构建稳定可靠的文件管理功能。注意权限、路径安全和用户体验即可。