Laravel 8 中复用创建与编辑表单的完整实践指南-php教程-PHP中文网

Laravel 8 中复用创建与编辑表单的完整实践指南

本文详解如何在 Laravel 8 中安全、高效地复用同一 Blade 表单（如 fields.blade.php）于创建（create）和编辑（edit）场景，通过 old() 辅助函数与模型实例结合，确保表单默认值正确回填且支持验证错误恢复。

本文详解如何在 laravel 8 中安全、高效地复用同一 blade 表单（如 `fields.blade.php`）于创建（create）和编辑（edit）场景，通过 `old()` 辅助函数与模型实例结合，确保表单默认值正确回填且支持验证错误恢复。

在 Laravel 开发中，为避免重复代码，推荐将表单字段抽象为独立的 Blade 片段（如 fields.blade.php），并在 create 和 edit 视图中统一 @include。但要使该复用真正生效，关键在于让表单字段能智能识别当前是新建还是编辑状态，并正确显示初始值或用户输入值。

核心原理是：
✅ old('field', $default) 函数会优先返回上次表单提交失败时的 $_POST 值（即 old() 数据）；若不存在，则回退到 $default 值。
✅ 在 create 页面，$warehouse 是一个新实例（如 new Warehouse()），其属性为 null 或默认值，此时 $warehouse->wh_code 返回 null，old('wh_code', $warehouse->wh_code) 自然取 old() 值（如有）或空字符串。
✅ 在 edit 页面，$warehouse 是已查询的数据库模型，$warehouse->wh_code 为真实数据，old() 仅在验证失败时覆盖它，否则显示原始数据。

因此，需确保控制器正确传递模型实例：

// app/Http/Controllers/WarehouseController.php
public function create()
{
    $warehouse = new Warehouse(); // 空模型实例，用于 create 视图
    return view('admin.warehouses.create', compact('warehouse'));
}

public function edit($id)
{
    $warehouse = Warehouse::findOrFail($id); // 已存在模型，用于 edit 视图
    return view('admin.warehouses.edit', compact('warehouse'));
}

接着，在 fields.blade.php 中，所有的 value 属性必须统一使用 old('field_name', $warehouse->field_name)，而非硬编码空字符串或忽略模型值。以下是修正后的关键字段示例：

Laravel 13.2.0

PHP中文网提供Laravel 13.2.0版本下载，Laravel框架是基于 PHP 8.3+ 的高性能框架，官方推荐通过 Composer 安装。它内置 AI SDK、JSON:API Resources 及原生向量搜索，支持属性驱动开发与队列路由，大幅提升开发效率。相比旧版，13.2.0 优化了缓存 TTL 管理与实时通信，无需 Redis 即可横向扩展。作为现代 Web 开发首选，它兼顾安全与极速体验，助您快速构建企业级应用。

下载

<!-- admin/warehouses/fields.blade.php -->
<div class="form-group pad-top40">
    <div class="row">
        <label class="col-sm-4 control-label">Warehouse Number</label>
        <label class="col-sm-4 control-label">Number</label>
        <label class="col-sm-4 control-label">Warehouse Code</label>
    </div>

    <div class="row">
        <div class="col-sm-4">
            <div class="input-group">
                <span class="input-group-append">
                    <span class="input-group-text">
                        <i class="livicon" data-name="number" data-size="18" data-c="#000" data-hc="#000" data-loop="true"></i>
                    </span>
                </span>
                <input type="number" class="form-control" placeholder="No" id="no" name="no" value="{{ old('no', $warehouse->no ?? '') }}">
</div>
        </div>

        <div class="col-sm-4">
            <div class="input-group">
                <span class="input-group-append">
                    <span class="input-group-text">
                        <i class="livicon" data-name="number" data-size="18" data-c="#000" data-hc="#000" data-loop="true"></i>
                    </span>
                </span>
                <input type="text" class="form-control" placeholder="Warehouse Code" id="wh_code" name="wh_code" value="{{ old('wh_code', $warehouse->wh_code ?? '') }}">
</div>
        </div>
    </div>

    <br><br><div class="row">
        <label for="address1" class="col-sm-8 control-label">Address Line 1</label>
        <label for="reg_date" class="col-sm-4 control-label">Register Date</label>
    </div>

    <div class="row">
        <div class="col-sm-8">
            <div class="input-group">
                <span class="input-group-append">
                    <span class="input-group-text">
                        <i class="livicon" data-name="address" data-size="18" data-c="#000" data-hc="#000" data-loop="true"></i>
                    </span>
                </span>
                <input type="text" class="form-control" placeholder="Address" id="address1" name="address1" value="{{ old('address1', $warehouse->address1 ?? '') }}">
</div>
        </div>

        <div class="col-sm-4">
            <div class="input-group">
                <span class="input-group-append">
                    <span class="input-group-text">
                        <i class="livicon" data-name="calendar" data-size="18" data-c="#000" data-hc="#000" data-loop="true"></i>
                    </span>
                </span>
                <input type="date" class="form-control" id="reg_date" name="reg_date" value="{{ old('reg_date', $warehouse->reg_date ? $warehouse->reg_date->format('Y-m-d') : '') }}">
</div>
        </div>
    </div>
</div>

⚠️ 重要注意事项：

所有 value 属性必须使用 ?? '' 防止 Trying to get property 'xxx' of non-object 错误（尤其在 create 时 $warehouse 为空模型）；
日期字段（如 reg_date）需格式化为 Y-m-d，因 HTML 仅接受该格式；
若使用 Laravel Collective Form，应改用 Form::text('wh_code', old('wh_code', $warehouse->wh_code ?? ''))，而非 null —— null 会导致值无法回填；
Form::model() 在 edit.blade.php 中已自动绑定模型，但 fields.blade.php 仍需显式使用 $warehouse->xxx，因为 @include 不继承 Form::model 的上下文绑定逻辑；
建议在表单顶部添加 @error('field') is-invalid @enderror 类，配合 Bootstrap 实现验证错误高亮。

最终，你的 create.blade.php 和 edit.blade.php 可保持极简结构，仅负责包裹表单并传入路由：

{{-- create.blade.php --}}
<div class="card-body">
    {!! Form::open(['route' => 'admin.warehouses.store']) !!}
        {{ csrf_field() }}
        @include('admin.warehouses.fields')
        <button type="submit" class="btn btn-primary">Create Warehouse</button>
    {!! Form::close() !!}
</div>

{{-- edit.blade.php --}}
<div class="card-body">
    {!! Form::model($warehouse, ['route' => ['admin.warehouses.update', $warehouse->id], 'method' => 'patch']) !!}
        {{ csrf_field() }}
        @include('admin.warehouses.fields')
        <button type="submit" class="btn btn-primary">Update Warehouse</button>
    {!! Form::close() !!}
</div>

通过以上方式，你不仅实现了表单复用，更构建了健壮、可维护、符合 Laravel 最佳实践的 CRUD 表单体系。