PAYATHON 2026

Laravel 基础 CRUD 如何组织 Resource Controller 和 Web 路由?

数据小陈

使用 Route::resource() 注册资源路由,让 ItemController 按约定处理各项操作。当前不需要单独的详情页,可以用 except(['show']) 排除该路由。保存、更新和删除成功后,统一重定向到 items.index。

示例假设 Item 对应的数据表已经存在,包含一个可编辑的 name 字段,且项目已配置登录认证。name 的验证规则仅作示例,需要根据实际字段和数据库约束调整。

在 auth middleware 路由组中注册资源路由

在 routes/web.php 中添加:

<?php

use App\Http\Controllers\ItemController;
use Illuminate\Support\Facades\Route;

Route::middleware('auth')->group(function () {
    Route::resource('items', ItemController::class)
        ->except(['show']);
});

该资源路由会生成以下映射:

HTTP 方法 路径 控制器方法 路由名称
GET /items index items.index
GET /items/create create items.create
POST /items store items.store
GET /items/{item}/edit edit items.edit
PUT/PATCH /items/{item} update items.update
DELETE /items/{item} destroy items.destroy

如果后续需要详情页,移除 except(['show']),并实现 show() 方法及对应视图。

编写 ItemController

可以先生成资源控制器骨架。如果控制器已存在,直接修改现有文件即可:

php artisan make:controller ItemController --resource --model=Item

app/Http/Controllers/ItemController.php 示例:

<?php

namespace App\Http\Controllers;

use App\Models\Item;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\View\View;

class ItemController extends Controller
{
    public function index(): View
    {
        $items = Item::query()->paginate(15);

        return view('items.index', compact('items'));
    }

    public function create(): View
    {
        return view('items.create');
    }

    public function store(Request $request): RedirectResponse
    {
        $validated = $request->validate([
            'name' => ['required', 'string', 'max:255'],
        ]);

        Item::create($validated);

        return redirect()
            ->route('items.index')
            ->with('status', '创建成功。');
    }

    public function edit(Item $item): View
    {
        return view('items.edit', compact('item'));
    }

    public function update(Request $request, Item $item): RedirectResponse
    {
        $validated = $request->validate([
            'name' => ['required', 'string', 'max:255'],
        ]);

        $item->update($validated);

        return redirect()
            ->route('items.index')
            ->with('status', '更新成功。');
    }

    public function destroy(Item $item): RedirectResponse
    {
        $item->delete();

        return redirect()
            ->route('items.index')
            ->with('status', '删除成功。');
    }
}

index() 查询列表,create() 和 edit() 返回表单页面,store() 和 update() 验证并保存数据,destroy() 删除记录。

Item $item 使用隐式 Route Model Binding。资源路由中的 {item} 与参数名 $item 对应,Laravel 会按模型的路由键查找记录,找不到时返回 404,因此不必在每个方法里重复编写查询。

配置 Item 的批量赋值字段

上面的 create() 和 update() 使用了批量赋值。需要在已有的 App\Models\Item 类中配置允许写入的字段;如果已有 $fillable,将字段合并进去:

protected $fillable = ['name'];

控制器只传入验证后的 $validated 数据。以后新增可编辑字段时,要同时检查验证规则、$fillable 和数据库字段定义。

准备 Blade 页面和表单

需要自行创建控制器引用的视图:

resources/views/items/index.blade.php
resources/views/items/create.blade.php
resources/views/items/edit.blade.php

创建页面中的表单可以写为:

<form action="{{ route('items.store') }}" method="POST">
    @csrf

    <label for="name">名称</label>
    <input
        id="name"
        name="name"
        type="text"
        value="{{ old('name') }}"
        required
    >

    @error('name')
        <p>{{ $message }}</p>
    @enderror

    <button type="submit">创建</button>
</form>

编辑页面使用控制器传入的 $item,并通过 @method('PUT') 指定更新请求:

<form action="{{ route('items.update', $item) }}" method="POST">
    @csrf
    @method('PUT')

    <label for="name">名称</label>
    <input
        id="name"
        name="name"
        type="text"
        value="{{ old('name', $item->name) }}"
        required
    >

    @error('name')
        <p>{{ $message }}</p>
    @enderror

    <button type="submit">保存</button>
</form>

列表页可以显示操作结果,并为每条记录提供编辑和删除入口:

@if (session('status'))
    <p>{{ session('status') }}</p>
@endif

<a href="{{ route('items.create') }}">创建条目</a>

@foreach ($items as $item)
    <div>
        <span>{{ $item->name }}</span>

        <a href="{{ route('items.edit', $item) }}">编辑</a>

        <form action="{{ route('items.destroy', $item) }}" method="POST">
            @csrf
            @method('DELETE')

            <button type="submit">删除</button>
        </form>
    </div>
@endforeach

{{ $items->links() }}

HTML 表单原生只支持 GET 和 POST,因此更新、删除表单通过 @method() 生成隐藏字段,由 Laravel 将请求按 PUT 或 DELETE 处理。写入操作的表单还需要 @csrf。

验证与权限需要注意什么

对于这里的普通 Web 表单,$request->validate() 验证失败后会重定向回上一页,并将验证错误和输入值暂存到 session,不会继续执行保存代码。Blade 中的 @error 用于显示错误,old() 用于恢复输入。对于期望 JSON 响应的请求,验证失败通常返回 HTTP 422 和错误数据。

auth middleware 要求用户登录。如果条目属于不同用户,还需要通过 Policy、授权检查或限定查询范围,控制用户能查看、编辑和删除哪些记录。Route Model Binding 本身不会检查记录归属。

创建和更新的验证规则变得复杂时,可以将其提取到 Form Request。本例将规则保留在控制器中,方便查看完整流程。

备注:内容仅供参考。