在 Laravel 中上传文件

如果你想了解怎么在 Laravel 中处理文件上传，那么请往下读。本文涵盖了在 Laravel 中处理文件上传所需的最低要求，并涉及了一些更高级的东西如添加验证和表单请求等。

请注意本教程是基于 Laravel 9，以我目前的了解，也适用于后续的版本。

准备文件上传控制器

创建新控制器，用来添加文件处理逻辑。

$ php artisan make:controller FileUploadController

在 FileUploadController 中，添加以下代码：

use Illuminate\Http\Request;

...

public function upload(Request $request)
{
    // Create a variable referencing the uploaded file from the request
    $file = $request->file('upload');

    // Store the file in storage/app/uploads
    $file->store('uploads');

    // Redirect to the success page
    return redirect()->route('fileUpload.success');
}

然后，添加为 success 路由添加另一个方法。可根据自己需要自定义内容： 

public function success()
{
    return 'Success!';
}

然后再在 routes/web.php 中添加下面的路由，关联文件上传控制器：

Route::get('/', fn () => view('upload'));
Route::get('/success', [FileUploadController::class, 'success'])->name('fileUpload.success');
Route::post('/', [FileUploadController::class, 'upload'])->name('fileUpload.upload');

在浏览器中打开上传表单对应的页面，点击浏览，选中文件然后点击上传！

然后我们就能看见文件存储在 storage/uploads 文件夹下了。

你能看到文件被重命名为一个随机名。如果要保留原文件名，你可以将 $file->store('uploads') 替换成 $file->storeAs('uploads', $file->getClientOriginalName())。

文件上传验证

接下来，让我们看看如何在文件上传处理中添加一些验证。将我们想接受的文件类型放到 rules 中是一种很好的实际 。如果我们只对图片感兴趣，或者更具体地说对 .jpg 感兴趣，那么我们可以通过设置一些验证规则来做到这一点。

重新访问 FileUploadController.php，在上传逻辑的最顶端，在从请求访问文件之前。我们可以通过请求变量定义一些验证规则，如下所示：

// Specify the validation rules that we want to apply
$request->validate([
    'upload' => 'required|image|max:1000',
]);

// Create a variable referencing the uploaded file from the request
$file = $request->file('upload');

...

添加完后，可尝试上传一个非图片文件看看会发生什么。

你会注意到不再调整到 success 消息页面，并且表单被重置。我们继续完善。

在 upload.blade.php 文件(即表单文件所在)中，我在 input 字段下面添加了一个新的代码段。具体位置可根据需要自行决定。

@if ($errors->get('upload'))
    <p>
        {{ $errors->get('upload')[0] }}
    </p>
@endif

再次尝试上传非图片文件，你就能看到提示信息，说明没有返回成功信息的原因。

回到此前的验证规则代码，让我们稍微分析一下。

$request->validate([
    'upload' => 'required|image|max:1000',
]);

我在 upload 参数中添加了三个规则，使用管道符 | 分开。

• required: 字段为必需
• image: 接收图片，比如 .jpg, .png, .svg.
• max:1000:  拒绝大小超过 1000kbs (1 MB) 的文件

可以查看 Laravel 文档了解更多验证规则信息

将这些验证规则提取到各自的 Form Request 

为了让控制器更加整洁，我们添加的验证逻辑可以提取到它们自己的 Form Request 类中

用下面命令创建：

php artisan make:request FileUploadRequest

删除 authorize 方法，因为我们步使用它。我们只关注 rules 方法，复制控制器中的验证规则。

class FileUploadRequest extends FormRequest
{
    public function rules()
    {
        return [
            'upload' => 'required|image|max:1000',
        ];
    }
}

最好，回到 FileUploadController 并修改 upload() 方法中 $request 的参数类型:

public function upload(FileUploadRequest $request)

如果 IDE 没有自动帮你引入，别忘了引入命名空间。

use App\Http\Requests\FileUploadRequest;

请尝试再次上传图像，一切都应该像以前一样正常。让我们把这个分解一下。
我们添加的验证规则已提取到表单请求中。然后，通过添加 $request 的类名（作为类型），Laravel 将通过依赖注入注入必要的类，并在我们开始处理文件之前执行验证检查。