如何在 Laravel 控制器中处理文件上传，并且对上传的文件进行验证和存储到指定的目录中？

本文链接：https://blog.csdn.net/qq_36777143/article/details/146108016

在 Laravel 中处理文件上传是一个常见的需求，例如用户上传头像、文档或其他文件。Laravel 提供了强大的工具来简化文件上传、验证和存储的过程。

一、实现步骤

1. 创建表单以支持文件上传

HTML 表单需要设置 enctype="multipart/form-data" 属性，以便支持文件上传。

示例代码（`resources/views/upload.blade.php`）

<form action="{{ route('upload.file') }}" method="POST" enctype="multipart/form-data">
    @csrf
    <label for="file">选择文件：</label>
    <input type="file" name="file" id="file" required>
    <button type="submit">上传</button>
</form>

为什么这样写？
- enctype="multipart/form-data" 是文件上传的必要属性。
- 使用 @csrf 添加 CSRF 保护，防止跨站请求伪造攻击。

2. 定义路由

在 routes/web.php 文件中定义处理文件上传的路由。

示例代码

<?php

use Illuminate\Support\Facades\Route;

Route::get('/upload', function () {
    return view('upload');
})->name('show.upload');

Route::post('/upload', [App\Http\Controllers\FileController::class, 'upload'])
    ->name('upload.file');

为什么这样写？
- GET 路由用于显示上传表单。
- POST 路由用于处理文件上传逻辑。

3. 在控制器中处理文件上传

创建一个控制器方法来接收文件、验证文件并存储到指定目录。

示例代码

<?php

namespace App\Http\Controllers;

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

class FileController extends Controller
{
    /**
     * 处理文件上传。
     *
     * @param \Illuminate\Http\Request $request 请求对象
     * @return \Illuminate\Http\RedirectResponse 重定向响应
     */
    public function upload(Request $request)
    {
        // 验证文件
        $request->validate([
            'file' => 'required|file|mimes:jpeg,png,pdf|max:2048',
        ]);
        // 为什么这样写？
        // 使用 validate() 方法确保文件符合要求（如类型和大小限制）。

        // 获取上传的文件
        $file = $request->file('file');

        // 存储文件到指定目录
        $path = $file->store('uploads', 'public');
        // 为什么这样写？
        // 使用 store() 方法将文件存储到 storage/app/public/uploads 目录中。

        // 返回成功消息
        return redirect()->back()->with('success', "File uploaded successfully! Path: {$path}");
    }
}

为什么这样写？
- validate() 方法确保文件符合规则（如类型为 jpeg、png 或 pdf，大小不超过 2MB）。
- store() 方法将文件存储到指定目录，并返回存储路径。

4. 配置文件存储

Laravel 支持多种文件存储驱动（如本地存储、S3 等）。默认情况下，文件会存储到 storage/app 目录下。

示例配置（`config/filesystems.php`）

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