Laravel 文件操作全指南：上传与下载实践

Laravel 提供了一系列强大的工具来简化文件上传和下载的过程，使得在 Web 应用程序中处理文件变得更加容易和安全。本文将详细介绍如何在 Laravel 中实现文件的上传和下载，包括表单创建、路由设置、控制器逻辑以及安全性考虑。

文件上传基础

文件上传是 Web 应用程序中的常见需求，Laravel 通过其请求类和验证系统，使得处理文件上传变得简单。

创建表单：首先，你需要创建一个包含文件输入的 HTML 表单。

<form action="{{ route('files.upload') }}" method="post" enctype="multipart/form-data">
    @csrf
    <input type="file" name="file">
    <button type="submit">Upload</button>
</form>

配置路由：在 routes/web.php 中定义路由以处理文件上传。

Route::post('/files/upload', 'FileController@upload');

编写控制器逻辑：在 FileController 中编写上传逻辑。

public function upload(Request $request)
{
    $request->validate([
        'file' => 'required|file|max:1024',
    ]);

    $file = $request->file('file');
    $path = $file->store('uploads');

    return back()->with('success', 'File uploaded successfully')->with('file', $path);
}

存储文件：使用 store 方法将文件存储到指定的磁盘和目录。

文件下载基础

文件下载是另一个常见的需求，Laravel 允许你以多种方式提供文件下载。

创建下载路由：定义一个路由来处理文件下载请求。

Route::get('/files/download/{filename}', 'FileController@download');

编写控制器逻辑：在 FileController 中编写下载逻辑。

public function download($filename)
{
    $file_path = storage_path('app/uploads/' . $filename);

    if (file_exists($file_path)) {
        return response()->download($file_path, $filename);
    }

    return response()->json(['error' => 'File not found'], 404);
}

发送下载响应：使用 response()->download 方法来发送文件下载。

使用 Laravel 的文件存储系统

Laravel 的文件存储系统提供了一个简单的 API 来与文件系统交互，支持本地磁盘、Amazon S3 等。

配置文件存储：在 config/filesystems.php 中配置磁盘。

'disks' => [
    'uploads' => [
        'driver' => 'local',
        'root' => storage_path('app/uploads'),
    ],
    // 其他磁盘配置...
],

使用文件存储门面：通过 Storage 门面与文件系统交互。

use Illuminate\Support\Facades\Storage;

// 上传文件
$path = Storage::disk('uploads')->putFile('images', $request->file('file'));

// 下载文件
return Storage::disk('uploads')->download($path);