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。本例将规则保留在控制器中,方便查看完整流程。
备注:内容仅供参考。
