简体中文

Laravel 教程

Laravel - 文件上传：初学者的全面指南

你好，有抱负的开发者们！今天，我们将踏上一段激动人心的旅程，探索Laravel中的文件上传世界。作为你友好的邻里电脑老师，我将一步步引导你完成这个过程。如果你是编程新手，不用担心——我们将从基础知识开始，逐步深入。那么，来一杯咖啡（或者如果你喜欢，来一杯茶），让我们一起开始吧！

Laravel - File Uploading

什么是文件上传？

在我们跳进代码之前，先来理解一下文件上传究竟是什么。想象一下，你试图在线上与朋友分享你最喜欢的假期照片。将图片从你的电脑传送到网站的过程，就是我们所说的“文件上传”。在网页开发中，我们经常需要允许用户上传各种类型的文件——图片、文档、视频，等等！

为什么选择Laravel进行文件上传？

Laravel，我们选择的PHP框架，使得文件上传变得轻而易举。它提供了简单而优雅的方法来处理文件上传，确保你的应用程序可以安全且高效地管理用户提交的文件。相信我，尝试过其他框架的文件上传后，你会更加欣赏Laravel的直接方法！

设置我们的项目

首先，让我们创建一个新的Laravel项目。如果你还没有这么做，打开你的终端并运行以下命令：

composer create-project --prefer-dist laravel/laravel file-upload-demo

这个命令会创建一个名为“file-upload-demo”的新Laravel项目。完成后，导航到你的项目目录：

cd file-upload-demo

创建我们的文件上传表单

现在，让我们创建一个允许用户上传文件的简单表单。我们将从创建一个新的Blade模板开始。在resources/views目录下创建一个名为upload.blade.php的新文件，并添加以下代码：

<!DOCTYPE html>
<html>
<head>
<title>文件上传演示</title>
</head>
<body>
<h2>上传文件</h2>
<form action="{{ route('upload') }}" method="POST" enctype="multipart/form-data">
@csrf
<input type="file" name="file">
<button type="submit">上传</button>
</form>
</body>
</html>

让我们分解一下：

  1. 我们创建了一个简单的HTML表单。
  2. action属性指向一个名为'upload'的路由（我们稍后会创建）。
  3. method设置为POST，因为我们正在向服务器发送数据。
  4. enctype="multipart/form-data"对于文件上传至关重要——它告诉浏览器以可以包含文件的格式发送表单数据。
  5. @csrf是一个Laravel指令，用于添加CSRF令牌以防止跨站请求伪造攻击。
  6. 我们有一个类型为"file"的输入，允许用户从他们的设备中选择文件。

设置路由

现在我们有了表单，我们需要设置一个路由来处理显示表单和处理上传。打开routes/web.php并添加以下代码：

use App\Http\Controllers\FileController;

Route::get('/', [FileController::class, 'showForm']);
Route::post('/upload', [FileController::class, 'upload'])->name('upload');

在这里，我们定义了两个路由：

  1. 一个GET路由，用于根URL ('/')，它将显示我们的上传表单。
  2. 一个POST路由，用于'/upload'，它将处理文件上传过程。

创建控制器

接下来，我们需要创建一个控制器来处理这些路由。在终端运行以下命令：

php artisan make:controller FileController

这将创建一个新的控制器文件。打开app/Http/Controllers/FileController.php并替换其内容为：

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class FileController extends Controller
{
public function showForm()
{
return view('upload');
}

public function upload(Request $request)
{
if ($request->hasFile('file')) {
$file = $request->file('file');
$path = $file->store('uploads');
return "文件上传成功！路径：" . $path;
}
return "没有上传文件。";
}
}

让我们分解一下upload方法中发生的事情：

  1. 我们检查是否实际上传了文件，使用$request->hasFile('file')。
  2. 如果有文件，我们使用$request->file('file')获取它。
  3. 我们使用Laravel的store方法将文件保存在'uploads'目录中。
  4. 最后，我们返回一个带有文件路径的成功消息。

测试我们的文件上传

现在，让我们测试一下文件上传功能：

  1. 通过在终端运行php artisan serve来启动Laravel开发服务器。
  2. 在浏览器中访问http://localhost:8000。
  3. 你应该能看到我们创建的上传表单。
  4. 选择一个文件并点击"上传"。
  5. 如果一切正常，你应该会看到带有文件路径的成功消息。

处理不同的文件类型

在实际应用中，我们经常需要处理不同类型的文件。让我们修改我们的控制器来处理这个问题：

public function upload(Request $request)
{
if ($request->hasFile('file')) {
$file = $request->file('file');
$extension = $file->getClientOriginalExtension();

$allowedExtensions = ['jpg', 'png', 'pdf', 'doc', 'docx'];

if (in_array($extension, $allowedExtensions)) {
$path = $file->store('uploads/' . $extension);
return "文件上传成功！路径：" . $path;
} else {
return "不允许的文件类型。";
}
}
return "没有上传文件。";
}

在这个更新版本中：

  1. 我们使用getClientOriginalExtension()获取文件扩展名。
  2. 我们定义了一个允许的文件类型数组。
  3. 我们检查上传的文件扩展名是否在我们允许的列表中。
  4. 如果是，我们在基于类型的子目录中存储它。
  5. 如果不是，我们返回一个错误消息。

显示上传的图片

如果你在处理图片上传，你可能想要在上传后显示它们。让我们修改我们的控制器来处理这个问题：

public function upload(Request $request)
{
if ($request->hasFile('file')) {
$file = $request->file('file');
$extension = $file->getClientOriginalExtension();

if ($extension === 'jpg' || $extension === 'png') {
$path = $file->store('public/uploads');
$url = asset(Storage::url($path));
return view('image', ['url' => $url]);
} else {
return "只允许显示JPG和PNG文件。";
}
}
return "没有上传文件。";
}

创建一个新的视图文件resources/views/image.blade.php：

<!DOCTYPE html>
<html>
<head>
<title>上传的图片</title>
</head>
<body>
<h2>你的上传图片：</h2>
<img src="{{ $url }}" alt="上传的图片" style="max-width: 500px;">
</body>
</html>

现在，当你上传一个图片时，你将在页面上看到它！

结论

恭喜你！你刚刚学习了Laravel中文件上传的基础知识。我们涵盖了创建表单、处理文件上传、存储文件，甚至显示上传的图片。记住，文件上传是一个强大的功能，但总是要验证和清理你的输入，以保持应用程序的安全。

在你继续Laravel之旅的过程中，你将发现更多高级的文件处理技术。但就目前而言，给自己一点鼓励——你在网页开发之旅中迈出了重要的一步！

以下是我们使用过的方法的快速参考表：

方法 描述
$request->hasFile('file') 检查是否上传了文件
$request->file('file') 获取上传的文件
$file->store('path') 在指定路径存储文件
$file->getClientOriginalExtension() 获取原始文件扩展名
Storage::url($path) 为存储的文件生成URL

快乐编码，愿你的上传总是成功！

Credits: Image by storyset

上一教程:
Laravel - 验证
下一教程:
Laravel - 发送电子邮件