12 Laravel资源控制器的使用

在上一篇中，我们讨论了Laravel中的控制器方法，了解了如何创建控制器及其基本用法。今天，我们将重点介绍资源控制器，这是Laravel提供的一种便捷方式，可以快速创建处理常见 CRUD（创建、读取、更新和删除）操作的控制器。

什么是资源控制器？

在Laravel中，资源控制器是通过一组约定的路由和控制器方法来处理资源。每个资源（如 User, Post, Product 等）都可以通过资源控制器来管理，遵循RESTful风格。

资源控制器自动为每个标准的CRUD操作定义路由，并将请求映射到相应的控制器方法，这大大减少了手动定义路由的工作。

创建资源控制器

首先，我们使用 Artisan 命令生成一个资源控制器。假设我们想要管理 Post 资源，我们可以运行以下命令：

php artisan make:controller PostController --resource

执行该命令后，Laravel将在 app/Http/Controllers 目录下创建一个 PostController 类。该控制器默认包含了以下方法：

<?php

namespace App\Http\Controllers;

use App\Models\Post;
use Illuminate\Http\Request;

class PostController extends Controller
{
    public function index()
    {
        // 显示所有的文章
    }

    public function create()
    {
        // 显示创建文章的表单
    }

    public function store(Request $request)
    {
        // 保存新的文章
    }

    public function show(Post $post)
    {
        // 显示单篇文章
    }

    public function edit(Post $post)
    {
        // 显示编辑文章的表单
    }

    public function update(Request $request, Post $post)
    {
        // 更新文章
    }

    public function destroy(Post $post)
    {
        // 删除文章
    }
}

定义路由

接下来，我们需要在 routes/web.php 文件中定义资源路由。我们可以通过如下代码实现：

Route::resource('posts', PostController::class);

这会自动为 PostController 中的每个方法生成相应的路由。例如：

• GET /posts -> index 方法
• GET /posts/create -> create 方法
• POST /posts -> store 方法
• GET /posts/{post} -> show 方法
• GET /posts/{post}/edit -> edit 方法
• PUT/PATCH /posts/{post} -> update 方法
• DELETE /posts/{post} -> destroy 方法

控制器方法实现示例

现在，让我们实现 PostController 中的一些方法以便于理解。在这个示例中，我们将使用 Eloquent ORM 来与数据库交互。

显示所有文章

在 index 方法中，我们可以获取数据库中所有的 Post 记录并返回视图：

public function index()
{
    $posts = Post::all();
    return view('posts.index', compact('posts'));
}

创建文章的表单

在 create 方法中，我们将返回一个创建文章的视图：

public function create()
{
    return view('posts.create');
}

存储新文章

在 store 方法中，我们将处理表单提交的数据，并将其保存到数据库中：

public function store(Request $request)
{
    $request->validate([
        'title' => 'required|max:255',
        'content' => 'required',
    ]);

    Post::create($request->all());
    return redirect()->route('posts.index')->with('success', '文章创建成功！');
}

显示单篇文章

在 show 方法中，我们可以展示单篇文章的详细信息：

public function show(Post $post)
{
    return view('posts.show', compact('post'));
}

删除文章

在 destroy 方法中，我们将删除指定的文章：

public function destroy(Post $post)
{
    $post->delete();
    return redirect()->route('posts.index')->with('success', '文章删除成功！');
}

总结

通过资源控制器，Laravel提供了一个非常方便的方式来处理常见的CRUD操作。我们创建了一个 PostController，并实现了管理 Post 模型所需的所有基础功能。在下一篇中，我们将探讨中间件，了解如何在Laravel中实现请求过滤和处理。

资源控制器让我们能够快速构建应用程序的基本骨架，是Laravel框架中一个非常有用的特性。在实际项目中，您可以根据需要扩展和修改这些功能，以适应不同的需求。

希望你能通过这个教程更深入的理解Laravel中的资源控制器！如果你对此有任何疑问或想进一步探讨的地方，可以随时提问。