Laravel Blade 中 create 和 edit 视图有什么区别?
create 视图用于填写新记录,edit 视图用于修改已有记录。两者通常共用布局和表单字段,但初始数据、提交地址、HTTP 方法、页面标题和按钮文字有所不同。
Blade 对这两类视图使用相同的模板语法。create.blade.php 和 edit.blade.php 是常见的文件命名约定,保存行为由路由和 controller 中的处理代码决定。
哪些地方不同?
以使用 Route::resource 的 posts 资源为例:
| 项目 | create 视图 | edit 视图 |
|---|---|---|
| 用途 | 新增记录 | 修改已有记录 |
| 打开页面 | GET /posts/create | GET /posts/{post}/edit |
| 显示页面的 controller 方法 | create() | edit() |
| 初始字段值 | 空值或业务默认值 | 已有记录的数据 |
| 表单提交地址 | route('posts.store') | route('posts.update', $post) |
| 提交后匹配的 HTTP 方法 | POST | PUT 或 PATCH |
| 保存数据的 controller 方法 | store() | update() |
create() 和 edit() 负责展示表单,store() 和 update() 负责处理提交。这是 Laravel resource controller 的常规划分,自定义路由可以采用其他名称和地址。参见 Laravel resource controller 文档。
哪些地方可以共用?
两种页面通常可以共用字段标签、输入控件、样式、错误提示和布局,也都需要在校验失败后恢复用户输入。使用常规 web 路由提交表单时,两个表单都应包含 @csrf。
字段和校验规则是否完全相同,要根据业务决定。例如,某个字段可以在新增时填写、编辑时禁止修改。相同的字段可以提取到一个 Blade partial 中,通过 @include 复用。
如何组织代码?
以下示例使用带有 title 字段的 Post 模型、普通 HTML 表单和 Laravel resource 路由。假设模型、数据库表和 controller 已存在,store() 和 update() 已负责校验和保存。
1. 注册路由并准备视图数据
在 routes/web.php 中注册相关路由:
use App\Http\Controllers\PostController;
use Illuminate\Support\Facades\Route;
Route::resource('posts', PostController::class)
->only(['create', 'store', 'edit', 'update']);
在 PostController 中,负责展示表单的两个方法可以这样写。以下仅展示相关方法:
use App\Models\Post;
public function create()
{
return view('posts.create', ['post' => new Post()]);
}
public function edit(Post $post)
{
return view('posts.edit', ['post' => $post]);
}
两个视图都接收 $post,方便公共字段模板读取数据。new Post() 创建的是尚未保存的模型实例,不会插入数据库;edit() 中的 $post 是通过隐式路由模型绑定取得的已有记录。
2. 提取公共字段
创建 resources/views/posts/_fields.blade.php:
<label for="title">标题</label>
<input
id="title"
name="title"
type="text"
value="{{ old('title', $post->title ?? '') }}"
>
@error('title')
<p>{{ $message }}</p>
@enderror
有上一次提交的 title 输入时,字段优先显示该值;否则使用模型中的 title,模型中没有值时显示空字符串。校验失败后重定向回表单时,old() 从 session 读取先前暂存的输入,编辑表单就能保留用户刚修改的内容。参见 Laravel old input 文档。
3. 在两个页面中设置不同的提交方式
resources/views/posts/create.blade.php:
<h1>新增文章</h1>
<form action="{{ route('posts.store') }}" method="POST">
@csrf
@include('posts._fields', ['post' => $post])
<button type="submit">创建</button>
</form>
resources/views/posts/edit.blade.php:
<h1>编辑文章</h1>
<form action="{{ route('posts.update', $post) }}" method="POST">
@csrf
@method('PUT')
@include('posts._fields', ['post' => $post])
<button type="submit">保存修改</button>
</form>
编辑表单的 HTML method 仍然写 POST。@method('PUT') 会生成隐藏的 _method 字段,让 Laravel 按 PUT 请求匹配路由;需要时也可以使用 @method('PATCH')。原生 HTML 表单不能直接通过 method="PUT" 提交。参见 Laravel Blade 表单文档。
容易混淆的细节
- 表单的
action应指向store或update路由,create和edit路由用于打开页面。 - 只把文件重命名为
edit.blade.php,不会自动加载记录、回填字段或切换保存逻辑;这些都需要在代码中明确配置。 - 编辑表单应优先使用
old(),否则校验失败后直接显示数据库值,会覆盖用户刚才输入的内容。 - 新增和编辑都需要服务端校验及相应的权限检查。隐藏字段、禁用按钮或省略输入框不能代替这些检查。
- 保留两个页面、共用字段模板,方便维护。也可以使用一个表单视图处理两种场景;字段差异较大时,分别维护更容易看清业务规则。
备注:内容仅供参考。
